기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeWorldGenerationJob
월드 생성 작업 설명입니다.
Request Syntax
POST /describeWorldGenerationJob HTTP/1.1
Content-type: application/json
{
"job": "string"
}URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- job
-
설명할 월드 생성 작업의 Amazon 리소스 이름(arn)입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1224입니다.
패턴:
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"
}
}응답 요소
작업이 성공하면 서비스가 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 -
월드 생성 작업에 연결된 태그 키 및 태그 값을 포함하는 맵입니다.
유형: 문자열-문자열 맵
맵 항목: 최소 항목 수는 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
-
RoboMaker AWS에서 서비스 문제가 발생했습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 500
- InvalidParameterException
-
요청에 지정된 파라미터는 유효하지 않거나, 지원되지 않거나, 사용할 수 없습니다. 반환된 메시지는 오류 값에 대한 설명을 제공합니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정한 리소스가 존재하지 않습니다.
HTTP 상태 코드: 400
- ThrottlingException
-
RoboMaker AWS는 일시적으로 요청을 처리할 수 없습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
