지원 종료 알림: 는 2025 AWS 년 9월 10일에 에 대한 지원을 중단합니다 AWS RoboMaker. 2025년 9월 10일 이후에는 AWS RoboMaker 콘솔 또는 AWS RoboMaker 리소스에 더 이상 액세스할 수 없습니다. 컨테이너화된 시뮬레이션 실행을 돕기 AWS Batch 위해 로 전환하는 방법에 대한 자세한 내용은 이 블로그 게시물을
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateWorldTemplate
중요
지원 종료 알림: 2025 AWS 년 9월 10일에 에 대한 지원이 중단됩니다 AWS RoboMaker. 2025년 9월 10일 이후에는 AWS RoboMaker 콘솔 또는 AWS RoboMaker 리소스에 더 이상 액세스할 수 없습니다. 컨테이너화된 시뮬레이션 실행을 돕기 AWS Batch 위해 로 전환하는 방법에 대한 자세한 내용은 이 블로그 게시물을
월드 템플릿을 생성합니다.
Request Syntax
POST /createWorldTemplate HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string
",
"name": "string
",
"tags": {
"string
" : "string
"
},
"templateBody": "string
",
"templateLocation": {
"s3Bucket": "string
",
"s3Key": "string
"
}
}
URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식의 다음 데이터를 수락합니다.
- clientRequestToken
-
요청 멱등성을 보장하기 위해 제공하는 고유한 대소문자 구분 식별자입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴:
[a-zA-Z0-9_\-=]*
Required: No
- name
-
월드 템플릿의 이름입니다.
유형: 문자열
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 255.
패턴:
.*
Required: No
-
월드 템플릿에 연결된 태그 키 및 태그 값을 포함하는 맵입니다.
유형: 문자열 간 맵
맵 항목: 최소 항목 수는 0개입니다. 최대수 50개.
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.
키 패턴:
[a-zA-Z0-9 _.\-\/+=:]*
값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256.
값 패턴:
[a-zA-Z0-9 _.\-\/+=:]*
필수 여부: 아니요
- templateBody
-
월드 템플릿 본문입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 262144자입니다.
패턴:
[\S\s]+
Required: No
- templateLocation
-
월드 템플릿의 위치입니다.
유형: TemplateLocation 객체
필수 항목 여부: 아니요
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"arn": "string",
"clientRequestToken": "string",
"createdAt": number,
"name": "string",
"tags": {
"string" : "string"
}
}
Response Elements
작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.
다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.
- arn
-
월드 템플릿의 Amazon 리소스 이름(ARN)입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1224입니다.
패턴:
arn:.*
- clientRequestToken
-
요청 멱등성을 보장하기 위해 제공하는 고유한 대소문자 구분 식별자입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴:
[a-zA-Z0-9_\-=]*
- createdAt
-
월드 템플릿이 생성된 epoch 이후 경과 시간(밀리초)입니다.
유형: 타임스탬프
- name
-
월드 템플릿의 이름입니다.
유형: 문자열
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 255.
패턴:
.*
-
월드 템플릿에 연결된 태그 키 및 태그 값을 포함하는 맵입니다.
유형: 문자열 간 맵
맵 항목: 최소 항목 수는 0개입니다. 최대수 50개.
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.
키 패턴:
[a-zA-Z0-9 _.\-\/+=:]*
값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256.
가치 패턴:
[a-zA-Z0-9 _.\-\/+=:]*
Errors
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.
- InternalServerException
-
AWS RoboMaker 서비스 문제가 발생했습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 500
- InvalidParameterException
-
요청에 지정된 파라미터는 유효하지 않거나, 지원되지 않거나, 사용할 수 없습니다. 반환된 메시지는 오류 값에 대한 설명을 제공합니다.
HTTP 상태 코드: 400
- LimitExceededException
-
요청된 리소스가 허용된 최대 수를 초과하거나 동시 스트림 요청 수가 허용된 최대 수를 초과합니다.
HTTP 상태 코드: 400
- ResourceAlreadyExistsException
-
지정된 리소스가 이미 있습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정한 리소스가 존재하지 않습니다.
HTTP 상태 코드: 400
- ThrottlingException
-
AWS RoboMaker 가 일시적으로 요청을 처리할 수 없습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 400
참고
언어별 중 하나API에서 이를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.