DescribeWorldGenerationJob - AWS RoboMaker
Request SyntaxURI 요청 파라미터요청 본문응답 구문Response ElementsErrors참고

지원 종료 알림: 는 2025 AWS 년 9월 10일에 에 대한 지원을 중단합니다 AWS RoboMaker. 2025년 9월 10일 이후에는 AWS RoboMaker 콘솔 또는 AWS RoboMaker 리소스에 더 이상 액세스할 수 없습니다. 컨테이너화된 시뮬레이션 실행을 돕기 AWS Batch 위해 로 전환하는 방법에 대한 자세한 내용은 이 블로그 게시물을 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

DescribeWorldGenerationJob

중요

지원 종료 알림: 는 2025 AWS 년 9월 10일에 에 대한 지원을 중단합니다 AWS RoboMaker. 2025년 9월 10일 이후에는 AWS RoboMaker 콘솔 또는 AWS RoboMaker 리소스에 더 이상 액세스할 수 없습니다. 컨테이너화된 시뮬레이션 실행을 돕기 AWS Batch 위해 로 전환하는 방법에 대한 자세한 내용은 이 블로그 게시물을 참조하세요.

월드 생성 작업 설명입니다.

Request Syntax

POST /describeWorldGenerationJob HTTP/1.1
Content-type: application/json

{
   "job": "string"
}

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

요청은 JSON 형식의 다음 데이터를 수락합니다.

job

설명할 월드 생성 작업의 Amazon 리소스 이름(arn)입니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 1224입니다.

Pattern: arn:.*

필수 여부: 예

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "clientRequestToken": "string",
   "createdAt": number,
   "failureCode": "string",
   "failureReason": "string",
   "finishedWorldsSummary": { 
      "failureSummary": { 
         "failures": [ 
            { 
               "failureCode": "string",
               "failureCount": number,
               "sampleFailureReason": "string"
            }
         ],
         "totalFailureCount": number
      },
      "finishedCount": number,
      "succeededWorlds": [ "string" ]
   },
   "status": "string",
   "tags": { 
      "string" : "string" 
   },
   "template": "string",
   "worldCount": { 
      "floorplanCount": number,
      "interiorCountPerFloorplan": number
   },
   "worldTags": { 
      "string" : "string" 
   }
}

Response Elements

작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.

다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.

arn

월드 생성 작업의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 1224입니다.

패턴: arn:.*

clientRequestToken

요청 멱등성을 보장하기 위해 제공하는 고유한 대소문자 구분 식별자입니다.

유형: 문자열

길이 제한: 최소 길이는 1. 최대 길이는 64.

패턴: [a-zA-Z0-9_\-=]*

createdAt

월드 생성 작업이 생성된 epoch 이후 경과 시간(밀리초)입니다.

유형: 타임스탬프

failureCode

월드 생성 작업이 실패한 경우의 실패 코드:

InternalServiceError

내부 서비스 오류.

LimitExceeded

요청된 리소스가 허용된 최대 수를 초과하거나 동시 스트림 요청 수가 허용된 최대 수를 초과합니다.

ResourceNotFound

특정 리소스를 찾을 수 없습니다.

RequestThrottled

요청에 병목 현상이 발생했습니다.

InvalidInput

요청의 입력 파라미터가 유효하지 않습니다.

타입: 문자열

유효 값: InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AllWorldGenerationFailed

failureReason

월드 생성 작업이 실패한 이유입니다.

유형: 문자열

길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다.

패턴: .*

finishedWorldsSummary

완성된 월드에 대한 요약 정보입니다.

유형: FinishedWorldsSummary 객체

status

월드 생성 작업 상태:

보류중

월드 생성 작업 요청이 보류 중입니다.

실행 중

월드 생성 작업이 실행 중입니다.

완료됨

월드 생성 작업이 완료되었습니다.

Failed

월드 생성 작업이 실패했습니다. 자세한 내용은 failureCode 섹션을 참조하세요.

PartialFailed

일부 월드가 생성되지 않았습니다.

취소됨

월드 생성 작업이 취소되었습니다.

취소 중

월드 생성 작업을 취소 중입니다.

타입: 문자열

유효 값: Pending | Running | Completed | Failed | PartialFailed | Canceling | Canceled

tags

월드 생성 작업에 연결된 태그 키 및 태그 값을 포함하는 맵입니다.

유형: 문자열 간 맵

맵 항목: 최소 항목 수는 0개입니다. 최대수 50개.

키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.

키 패턴: [a-zA-Z0-9 _.\-\/+=:]*

값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256.

가치 패턴: [a-zA-Z0-9 _.\-\/+=:]*

template

월드 템플릿의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 1224입니다.

패턴: arn:.*

worldCount

월드 수에 대한 정보입니다.

유형: WorldCount 객체

worldTags

생성된 월드 작업에 연결된 태그 키 및 태그 값을 포함하는 맵입니다.

유형: 문자열 간 맵

맵 항목: 최소 항목 수는 0개입니다. 최대수 50개.

키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.

키 패턴: [a-zA-Z0-9 _.\-\/+=:]*

값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256.

가치 패턴: [a-zA-Z0-9 _.\-\/+=:]*

Errors

모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.

InternalServerException

AWS RoboMaker 서비스 문제가 발생했습니다. 호출을 다시 시도하세요.

HTTP 상태 코드: 500

InvalidParameterException

요청에 지정된 파라미터는 유효하지 않거나, 지원되지 않거나, 사용할 수 없습니다. 반환된 메시지는 오류 값에 대한 설명을 제공합니다.

HTTP 상태 코드: 400

ResourceNotFoundException

지정한 리소스가 존재하지 않습니다.

HTTP 상태 코드: 400

ThrottlingException

AWS RoboMaker 가 일시적으로 요청을 처리할 수 없습니다. 호출을 다시 시도하세요.

HTTP 상태 코드: 400

참고

언어별 중 하나API에서 이를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.