Pemberitahuan akhir dukungan: Pada 10 September 2025, AWS
akan menghentikan dukungan untuk. AWS RoboMaker Setelah 10 September 2025, Anda tidak akan lagi dapat mengakses AWS RoboMaker konsol atau AWS RoboMaker sumber daya. Untuk informasi lebih lanjut tentang transisi ke AWS Batch untuk membantu menjalankan simulasi kontainer, kunjungi posting blog ini.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
StartSimulationJobBatch
penting
Pemberitahuan akhir dukungan: Pada 10 September 2025, AWS
akan menghentikan dukungan untuk. AWS RoboMaker Setelah 10 September 2025, Anda tidak akan lagi dapat mengakses AWS RoboMaker konsol atau AWS RoboMaker sumber daya. Untuk informasi lebih lanjut tentang transisi ke AWS Batch untuk membantu menjalankan simulasi kontainer, kunjungi posting blog ini.
Memulai batch pekerjaan simulasi baru. Batch didefinisikan menggunakan satu atau lebih SimulationJobRequest objek.
Sintaks Permintaan
POST /startSimulationJobBatch HTTP/1.1
Content-type: application/json
{
"batchPolicy": {
"maxConcurrency": number,
"timeoutInSeconds": number
},
"clientRequestToken": "string",
"createSimulationJobRequests": [
{
"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"
},
"useDefaultApplications": boolean,
"vpcConfig": {
"assignPublicIp": boolean,
"securityGroups": [ "string" ],
"subnets": [ "string" ]
}
}
],
"tags": {
"string" : "string"
}
}URIParameter Permintaan
Permintaan tidak menggunakan URI parameter apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam JSON format.
- batchPolicy
-
Kebijakan batch.
Tipe: Objek BatchPolicy
Wajib: Tidak
- clientRequestToken
-
Pengidentifikasi unik dan peka huruf besar/kecil yang Anda berikan untuk memastikan idempotensi permintaan.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola:
[a-zA-Z0-9_\-=]*Wajib: Tidak
- createSimulationJobRequests
-
Daftar permintaan pekerjaan simulasi untuk dibuat dalam batch.
Tipe: Array objek SimulationJobRequest
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 1000 item.
Wajib: Ya
-
Peta yang berisi kunci tag dan nilai tag yang dilampirkan ke batch pekerjaan penerapan.
Tipe: Peta string ke string
Entri Peta: Jumlah minimum 0 item. Jumlah maksimum 50 item.
Batasan Panjang Kunci: Panjang minimum 1. Panjang maksimum 128.
Pola Kunci:
[a-zA-Z0-9 _.\-\/+=:]*Batasan Panjang Nilai: Panjang minimum 0. Panjang maksimum 256.
Pola nilai:
[a-zA-Z0-9 _.\-\/+=:]*Wajib: Tidak
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"arn": "string",
"batchPolicy": {
"maxConcurrency": number,
"timeoutInSeconds": number
},
"clientRequestToken": "string",
"createdAt": number,
"createdRequests": [
{
"arn": "string",
"computeType": "string",
"dataSourceNames": [ "string" ],
"lastUpdatedAt": number,
"name": "string",
"robotApplicationNames": [ "string" ],
"simulationApplicationNames": [ "string" ],
"status": "string"
}
],
"failedRequests": [
{
"failedAt": number,
"failureCode": "string",
"failureReason": "string",
"request": {
"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"
},
"useDefaultApplications": boolean,
"vpcConfig": {
"assignPublicIp": boolean,
"securityGroups": [ "string" ],
"subnets": [ "string" ]
}
}
}
],
"failureCode": "string",
"failureReason": "string",
"pendingRequests": [
{
"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"
},
"useDefaultApplications": boolean,
"vpcConfig": {
"assignPublicIp": boolean,
"securityGroups": [ "string" ],
"subnets": [ "string" ]
}
}
],
"status": "string",
"tags": {
"string" : "string"
}
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Data berikut dikembalikan dalam JSON format oleh layanan.
- arn
-
Nama Sumber Daya Amazon (arn) dari batch.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1224.
Pola:
arn:.* - batchPolicy
-
Kebijakan batch.
Tipe: Objek BatchPolicy
- clientRequestToken
-
Pengidentifikasi unik dan peka huruf besar/kecil yang Anda berikan untuk memastikan idempotensi permintaan.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola:
[a-zA-Z0-9_\-=]* - createdAt
-
Waktu, dalam milidetik sejak zaman, ketika batch pekerjaan simulasi dibuat.
Tipe: Timestamp
- createdRequests
-
Daftar ringkasan permintaan pekerjaan simulasi yang dibuat.
Tipe: Array objek SimulationJobSummary
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 100 item.
- failedRequests
-
Daftar permintaan pekerjaan simulasi yang gagal. Permintaan gagal dibuat menjadi pekerjaan simulasi. Permintaan yang gagal tidak memiliki ID pekerjaan simulasi.
Tipe: Array objek FailedCreateSimulationJobRequest
- failureCode
-
Kode kegagalan jika batch pekerjaan simulasi gagal.
Tipe: String
Nilai yang Valid:
InternalServiceError - failureReason
-
Alasan batch pekerjaan simulasi gagal.
Tipe: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 1024.
Pola:
.* - pendingRequests
-
Daftar permintaan pekerjaan simulasi yang tertunda. Permintaan ini belum dibuat menjadi pekerjaan simulasi.
Tipe: Array objek SimulationJobRequest
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 1000 item.
- status
-
Status batch pekerjaan simulasi.
- Tertunda
-
Permintaan batch pekerjaan simulasi tertunda.
- InProgress
-
Batch pekerjaan simulasi sedang berlangsung.
- Failed
-
Batch pekerjaan simulasi gagal. Satu atau lebih permintaan pekerjaan simulasi tidak dapat diselesaikan karena kegagalan internal (seperti
InternalServiceError). LihatfailureCodedanfailureReasonuntuk informasi lebih lanjut. - Selesai
-
Pekerjaan batch simulasi selesai. Batch selesai ketika (1) tidak ada permintaan pekerjaan simulasi yang tertunda dalam batch dan tidak ada permintaan pekerjaan simulasi yang gagal karena
InternalServiceErrordan (2) ketika semua pekerjaan simulasi yang dibuat telah mencapai status terminal (misalnya,Completedatau).Failed - Dibatalkan
-
Pekerjaan batch simulasi dibatalkan.
- Membatalkan
-
Pekerjaan batch simulasi dibatalkan.
- Menyelesaikan
-
Pekerjaan batch simulasi selesai.
- TimingOut
-
Batch pekerjaan simulasi habis waktu.
Jika waktu batch habis, dan ada permintaan tertunda yang gagal karena kegagalan internal (seperti
InternalServiceError), status batch akan menjadiFailed. Jika tidak ada permintaan yang gagal seperti itu, status batch akan menjadiTimedOut. - TimedOut
-
Pekerjaan batch simulasi habis.
Tipe: String
Nilai yang Valid:
Pending | InProgress | Failed | Completed | Canceled | Canceling | Completing | TimingOut | TimedOut -
Peta yang berisi kunci tag dan nilai tag yang dilampirkan ke batch pekerjaan penerapan.
Tipe: Peta string ke string
Entri Peta: Jumlah minimum 0 item. Jumlah maksimum 50 item.
Batasan Panjang Kunci: Panjang minimum 1. Panjang maksimum 128.
Pola Kunci:
[a-zA-Z0-9 _.\-\/+=:]*Batasan Panjang Nilai: Panjang minimum 0. Panjang maksimum 256.
Pola nilai:
[a-zA-Z0-9 _.\-\/+=:]*
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- IdempotentParameterMismatchException
-
Permintaan menggunakan token klien yang sama dengan permintaan sebelumnya, tetapi tidak identik. Jangan menggunakan kembali token klien dengan permintaan yang berbeda, kecuali permintaannya identik.
HTTPKode Status: 400
- InternalServerException
-
AWS RoboMaker mengalami masalah layanan. Coba lagi panggilan Anda.
HTTPKode Status: 500
- InvalidParameterException
-
Parameter yang ditentukan dalam permintaan tidak valid, tidak didukung, atau tidak dapat digunakan. Pesan yang dikembalikan memberikan penjelasan tentang nilai kesalahan.
HTTPKode Status: 400
- LimitExceededException
-
Sumber daya yang diminta melebihi jumlah maksimum yang diizinkan, atau jumlah permintaan aliran bersamaan melebihi jumlah maksimum yang diizinkan.
HTTPKode Status: 400
- ThrottlingException
-
AWS RoboMaker sementara tidak dapat memproses permintaan. Coba lagi panggilan Anda.
HTTPKode Status: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
