AWS RoboMaker 신규 고객은 더 이상 사용할 수 없습니다. 의 기존 고객 AWS RoboMaker 정상적으로 서비스를 계속 사용할 수 있습니다. AWS Batch 이제 컨테이너식 시뮬레이션을 실행하는 데 선호되는 서비스입니다. 자세히 알아보기
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeSimulationJob
시뮬레이션 작업을 설명합니다.
Request Syntax
POST /describeSimulationJob 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",
"compute": {
"computeType": "string",
"gpuUnitLimit": number,
"simulationUnitLimit": number
},
"dataSources": [
{
"destination": "string",
"name": "string",
"s3Bucket": "string",
"s3Keys": [
{
"etag": "string",
"s3Key": "string"
}
],
"type": "string"
}
],
"failureBehavior": "string",
"failureCode": "string",
"failureReason": "string",
"iamRole": "string",
"lastStartedAt": number,
"lastUpdatedAt": number,
"loggingConfig": {
"recordAllRosTopics": boolean
},
"maxJobDurationInSeconds": number,
"name": "string",
"networkInterface": {
"networkInterfaceId": "string",
"privateIpAddress": "string",
"publicIpAddress": "string"
},
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "string"
},
"robotApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean
}
],
"simulationApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean,
"worldConfigs": [
{
"world": "string"
}
]
}
],
"simulationTimeMillis": number,
"status": "string",
"tags": {
"string" : "string"
},
"vpcConfig": {
"assignPublicIp": boolean,
"securityGroups": [ "string" ],
"subnets": [ "string" ],
"vpcId": "string"
}
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- arn
-
시뮬레이션 작업의 Amazon 리소스 이름(ARN)입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1224입니다.
패턴:
arn:.*
- clientRequestToken
-
요청 멱등성을 보장하기 위해 제공하는 고유한 대소문자 구분 식별자입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴:
[a-zA-Z0-9_\-=]*
- compute
-
시뮬레이션 작업에 대한 컴퓨팅 정보입니다.
유형: ComputeResponse객체
- dataSources
-
시뮬레이션 작업의 데이터 소스입니다.
유형: DataSource객체 어레이
- failureBehavior
-
시뮬레이션 작업의 실패 동작입니다.
타입: 문자열
유효 값:
Fail | Continue
- failureCode
-
시뮬레이션 작업 실패 시 발생하는 오류 코드:
- InternalServiceError
-
내부 서비스 오류.
- RobotApplicationCrash
-
로봇 애플리케이션이 비정상적으로 종료되었습니다.
- SimulationApplicationCrash
-
시뮬레이션 애플리케이션이 비정상적으로 종료되었습니다.
- BadPermissionsRobotApplication
-
로봇 애플리케이션 번들을 다운로드할 수 없습니다.
- BadPermissionsSimulationApplication
-
시뮬레이션 애플리케이션 번들을 다운로드할 수 없습니다.
- BadPermissionsS3 출력
-
출력을 고객이 제공한 S3 버킷에 게시할 수 없습니다.
- BadPermissionsCloudwatchLogs
-
고객이 CloudWatch 제공한 Logs 리소스에 로그를 게시할 수 없습니다.
- SubnetIpLimitExceeded
-
서브넷 IP 제한을 초과했습니다.
- ENI LimitExceeded
-
ENI 제한을 초과했습니다.
- BadPermissionsUserCredentials
-
제공된 역할을 사용할 수 없습니다.
- InvalidBundleRobotApplication
-
로봇 번들을 추출할 수 없습니다(잘못된 형식, 번들링 오류 또는 기타 문제).
- InvalidBundleSimulationApplication
-
시뮬레이션 번들을 추출할 수 없습니다(잘못된 형식, 번들링 오류 또는 기타 문제).
- RobotApplicationVersionMismatchedEtag
-
버전 생성 중 Etag for 값이 일치하지 RobotApplication 않습니다.
- SimulationApplicationVersionMismatchedEtag
-
버전 생성 시 Etag for 값이 일치하지 SimulationApplication 않습니다.
타입: 문자열
유효 값:
InternalServiceError | RobotApplicationCrash | SimulationApplicationCrash | RobotApplicationHealthCheckFailure | SimulationApplicationHealthCheckFailure | BadPermissionsRobotApplication | BadPermissionsSimulationApplication | BadPermissionsS3Object | BadPermissionsS3Output | BadPermissionsCloudwatchLogs | SubnetIpLimitExceeded | ENILimitExceeded | BadPermissionsUserCredentials | InvalidBundleRobotApplication | InvalidBundleSimulationApplication | InvalidS3Resource | ThrottlingError | LimitExceeded | MismatchedEtag | RobotApplicationVersionMismatchedEtag | SimulationApplicationVersionMismatchedEtag | ResourceNotFound | RequestThrottled | BatchTimedOut | BatchCanceled | InvalidInput | WrongRegionS3Bucket | WrongRegionS3Output | WrongRegionRobotApplication | WrongRegionSimulationApplication | UploadContentMismatchError
- failureReason
-
시뮬레이션 작업이 실패한 이유에 대한 세부 정보입니다. 흐름 문제 해결에 대한 자세한 내용은 문제 해결을 참조하세요.
타입: 문자열
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다.
패턴:
.*
- iamRole
-
시뮬레이션 인스턴스가 사용자 대신 연결된 정책에 지정된 AWS API를 호출하도록 허용하는 IAM 역할입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이는 255.
패턴:
arn:aws:iam::\w+:role/.*
- lastStartedAt
-
뮬레이션 작업이 마지막으로 시작된 epoch 이후 경과 시간(밀리초)
유형: 타임스탬프
- lastUpdatedAt
-
시뮬레이션 작업이 마지막으로 업데이트된 epoch 이후 경과 시간(밀리초)입니다.
유형: 타임스탬프
- loggingConfig
-
로깅 구성입니다.
유형: LoggingConfig객체
- maxJobDurationInSeconds
-
최대 작업 시간(초)입니다. 값은 8일(691,200초) 이하여야 합니다.
타입: Long
- name
-
시뮬레이션 작업의 이름입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이는 255.
패턴:
[a-zA-Z0-9_\-]*
- networkInterface
-
시뮬레이션 작업에 대한 네트워크 인터페이스 정보입니다.
유형: NetworkInterface객체
- outputLocation
-
시뮬레이션 작업에서 생성된 출력 파일의 위치입니다.
유형: OutputLocation객체
- robotApplications
-
로봇 애플리케이션 목록입니다.
유형: RobotApplicationConfig객체 어레이
배열 멤버: 고정된 항목 수는 1개입니다.
- simulationApplications
-
시뮬레이션 애플리케이션 목록입니다.
유형: SimulationApplicationConfig객체 어레이
배열 멤버: 고정된 항목 수는 1개입니다.
- simulationTimeMillis
-
시뮬레이션 작업 실행 기간(밀리초)
타입: Long
- status
-
시뮬레이션 작업의 상태입니다.
타입: 문자열
유효 값:
Pending | Preparing | Running | Restarting | Completed | Failed | RunningFailed | Terminating | Terminated | Canceled
-
지정된 시뮬레이션 작업에 추가된 모든 태그의 목록입니다.
유형: 문자열-문자열 맵
맵 항목: 최소 항목 수는 0개입니다. 최대 항목 수는 50개입니다.
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.
키 패턴:
[a-zA-Z0-9 _.\-\/+=:]*
값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256.
가치 패턴:
[a-zA-Z0-9 _.\-\/+=:]*
- vpcConfig
-
VPC 구성입니다.
유형: VPCConfigResponse객체
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- InternalServerException
-
RoboMaker AWS에서 서비스 문제가 발생했습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 500
- InvalidParameterException
-
요청에 지정된 파라미터는 유효하지 않거나, 지원되지 않거나, 사용할 수 없습니다. 반환된 메시지는 오류 값에 대한 설명을 제공합니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정한 리소스가 존재하지 않습니다.
HTTP 상태 코드: 400
- ThrottlingException
-
RoboMaker AWS는 일시적으로 요청을 처리할 수 없습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.