CreateWorldTemplate - AWS RoboMaker

지원 종료 알림: 는 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

tags

월드 템플릿에 연결된 태그 키 및 태그 값을 포함하는 맵입니다.

유형: 문자열 간 맵

맵 항목: 최소 항목 수는 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.

패턴: .*

tags

월드 템플릿에 연결된 태그 키 및 태그 값을 포함하는 맵입니다.

유형: 문자열 간 맵

맵 항목: 최소 항목 수는 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참조하세요.