지원 종료 알림: 는 2025 AWS 년 9월 10일에 에 대한 지원을 중단합니다 AWS RoboMaker. 2025년 9월 10일 이후에는 AWS RoboMaker 콘솔 또는 AWS RoboMaker 리소스에 더 이상 액세스할 수 없습니다. 컨테이너화된 시뮬레이션 실행을 돕기 AWS Batch 위해 로 전환하는 방법에 대한 자세한 내용은 이 블로그 게시물을
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateSimulationJob
중요
지원 종료 알림: 2025 AWS 년 9월 10일에 에 대한 지원이 중단됩니다 AWS RoboMaker. 2025년 9월 10일 이후에는 AWS RoboMaker 콘솔 또는 AWS RoboMaker 리소스에 더 이상 액세스할 수 없습니다. 컨테이너화된 시뮬레이션을 실행 AWS Batch 하기 위해 로 전환하는 방법에 대한 자세한 내용은 이 블로그 게시물을
시뮬레이션 작업을 생성합니다.
참고
시뮬레이션 작업은 90일 후에 만료되고 삭제됩니다. 더 이상 액세스할 수 없습니다.
Request Syntax
POST /createSimulationJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"compute": {
"computeType": "string",
"gpuUnitLimit": number,
"simulationUnitLimit": number
},
"dataSources": [
{
"destination": "string",
"name": "string",
"s3Bucket": "string",
"s3Keys": [ "string" ],
"type": "string"
}
],
"failureBehavior": "string",
"iamRole": "string",
"loggingConfig": {
"recordAllRosTopics": boolean
},
"maxJobDurationInSeconds": number,
"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"
}
]
}
],
"tags": {
"string" : "string"
},
"vpcConfig": {
"assignPublicIp": boolean,
"securityGroups": [ "string" ],
"subnets": [ "string" ]
}
}URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식의 다음 데이터를 수락합니다.
- clientRequestToken
-
요청 멱등성을 보장하기 위해 제공하는 고유한 대소문자 구분 식별자입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴:
[a-zA-Z0-9_\-=]*Required: No
- compute
-
시뮬레이션 작업에 대한 컴퓨팅 정보입니다.
유형: Compute 객체
필수 여부: 아니요
- dataSources
-
S3의 읽기 전용 파일을 시뮬레이션에 마운트할 데이터 소스를 지정합니다. 이러한 파일은
/opt/robomaker/datasources/data_source_name에서 사용할 수 있습니다.참고
파일 수는 100개로 제한되며 모든
DataSourceConfig객체의 총 크기는 25GB입니다.유형: DataSourceConfig객체 어레이
어레이 멤버: 최소 항목 수 1개. 최대 항목 수는 6개입니다.
필수 여부: 아니요
- failureBehavior
-
시뮬레이션 작업의 실패 동작입니다.
- 계속
-
4XX오류 코드가 발생한 후 최대 제한 시간 동안 인스턴스를 계속 실행합니다. - Fail
-
시뮬레이션 작업을 중지하고 인스턴스를 종료합니다.
타입: 문자열
유효 값:
Fail | Continue필수 여부: 아니요
- iamRole
-
시뮬레이션 인스턴스가 사용자를 대신하여 관련 정책에 지정된 를 호출할 수 AWS APIs 있도록 허용하는 IAM 역할 이름입니다. 이것이 시뮬레이션 작업에 보안 자격 증명이 전달되는 과정입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이는 255.
Pattern:
arn:aws:iam::\w+:role/.*필수 여부: 예
- loggingConfig
-
로깅 구성입니다.
유형: LoggingConfig 객체
필수 여부: 아니요
- maxJobDurationInSeconds
-
초 단위의 최대 시뮬레이션 작업 기간(최대 14일 또는 1,209,600초)
maxJobDurationInSeconds에 도달하면 시뮬레이션 작업 상태가Completed로 전환됩니다.타입: Long
필수 여부: 예
- outputLocation
-
시뮬레이션 작업에서 생성된 출력 파일의 위치입니다.
유형: OutputLocation 객체
필수 여부: 아니요
- robotApplications
-
시뮬레이션 작업에서 사용할 로봇 애플리케이션입니다.
유형: RobotApplicationConfig객체 어레이
배열 멤버: 고정된 항목 수는 1개입니다.
필수 여부: 아니요
- simulationApplications
-
시뮬레이션 작업에서 사용할 시뮬레이션 애플리케이션입니다.
유형: SimulationApplicationConfig객체 어레이
배열 멤버: 고정된 항목 수는 1개입니다.
필수 여부: 아니요
-
시뮬레이션 작업에 연결된 태그 키 및 태그 값을 포함하는 맵입니다.
유형: 문자열 간 맵
맵 항목: 최소 항목 수는 0개입니다. 최대수 50개.
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.
키 패턴:
[a-zA-Z0-9 _.\-\/+=:]*값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256.
값 패턴:
[a-zA-Z0-9 _.\-\/+=:]*필수 여부: 아니요
- vpcConfig
-
시뮬레이션 작업이 의 리소스에 액세스하는 경우 보안 그룹 IDs 및 서브넷 목록을 식별하는 이 파라미터를 VPC제공합니다IDs. 이들은 동일한 에 속해야 합니다VPC. 하나 이상의 보안 그룹과 하나의 서브넷 ID를 제공해야 합니다.
유형: VPCConfig 객체
필수 항목 여부: 아니요
응답 구문
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",
"iamRole": "string",
"lastStartedAt": number,
"lastUpdatedAt": number,
"loggingConfig": {
"recordAllRosTopics": boolean
},
"maxJobDurationInSeconds": number,
"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"
}
}Response Elements
작업이 성공하면 서비스가 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
-
시뮬레이션 애플리케이션 번들을 다운로드할 수 없습니다.
- BadPermissionsS3Output
-
출력을 고객이 제공한 S3 버킷에 게시할 수 없습니다.
- BadPermissionsCloudwatchLogs
-
고객이 제공한 Logs 리소스에 CloudWatch 로그를 게시할 수 없습니다.
- SubnetIpLimitExceeded
-
서브넷 IP 제한을 초과했습니다.
- ENILimitExceeded
-
ENI 한도를 초과했습니다.
- BadPermissionsUserCredentials
-
제공된 역할을 사용할 수 없습니다.
- InvalidBundleRobotApplication
-
로봇 번들을 추출할 수 없습니다(잘못된 형식, 번들링 오류 또는 기타 문제).
- InvalidBundleSimulationApplication
-
시뮬레이션 번들을 추출할 수 없습니다(잘못된 형식, 번들링 오류 또는 기타 문제).
- RobotApplicationVersionMismatchedEtag
-
버전 생성 중 의 Etag RobotApplication 이 값과 일치하지 않습니다.
- SimulationApplicationVersionMismatchedEtag
-
버전 생성 중 의 Etag 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 - iamRole
-
시뮬레이션 작업이 사용자를 대신하여 관련 정책에 지정된 를 호출하도록 허용하는 IAM 역할AWSAPIs입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이는 255.
패턴:
arn:aws:iam::\w+:role/.* - lastStartedAt
-
뮬레이션 작업이 마지막으로 시작된 epoch 이후 경과 시간(밀리초)
유형: 타임스탬프
- lastUpdatedAt
-
시뮬레이션 작업이 마지막으로 업데이트된 epoch 이후 경과 시간(밀리초)입니다.
유형: 타임스탬프
- loggingConfig
-
로깅 구성입니다.
유형: LoggingConfig 객체
- maxJobDurationInSeconds
-
초 단위 최대 시뮬레이션 작업 시간입니다.
타입: Long
- 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
모든 작업에서 일반적으로 발생하는 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- IdempotentParameterMismatchException
-
요청은 이전 요청과 동일한 클라이언트 토큰을 사용하지만, 동일하지는 않습니다. 요청이 동일하지 않는 한, 다른 요청에 클라이언트 토큰을 재사용하지 마세요.
HTTP 상태 코드: 400
- InternalServerException
-
AWS RoboMaker 서비스 문제가 발생했습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 500
- InvalidParameterException
-
요청에 지정된 파라미터는 유효하지 않거나, 지원되지 않거나, 사용할 수 없습니다. 반환된 메시지는 오류 값에 대한 설명을 제공합니다.
HTTP 상태 코드: 400
- LimitExceededException
-
요청된 리소스가 허용된 최대 수를 초과하거나 동시 스트림 요청 수가 허용된 최대 수를 초과합니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정한 리소스가 존재하지 않습니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
서버의 일시적 장애로 인해 요청이 실패했습니다.
HTTP 상태 코드: 503
- ThrottlingException
-
AWS RoboMaker 가 일시적으로 요청을 처리할 수 없습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 400
참고
언어별 중 하나API에서 이를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.
