CreateWorldExportJob - AWS RoboMaker
Minta SintaksParameter Permintaan URIIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CreateWorldExportJob

Menciptakan pekerjaan ekspor dunia.

Minta Sintaks

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

{
   "clientRequestToken": "string",
   "iamRole": "string",
   "outputLocation": { 
      "s3Bucket": "string",
      "s3Prefix": "string"
   },
   "tags": { 
      "string" : "string" 
   },
   "worlds": [ "string" ]
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

clientRequestToken

Pengidentifikasi unik dan peka huruf besar/kecil yang Anda berikan untuk memastikan idempotensi permintaan.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

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

Wajib: Tidak

iamRole

Peran IAM yang digunakan proses ekspor dunia untuk mengakses bucket Amazon S3 dan menempatkan ekspor.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.

Pola: arn:aws:iam::\w+:role/.*

Wajib: Ya

outputLocation

Lokasi output.

Tipe: Objek OutputLocation

Wajib: Ya

tags

Peta yang berisi kunci tag dan nilai tag yang dilampirkan ke pekerjaan ekspor dunia.

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

worlds

Daftar Nama Sumber Daya Amazon (arns) yang sesuai dengan dunia untuk diekspor.

Tipe: Array string

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 100 item.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 1224.

Pola: arn:.*

Diperlukan: Ya

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "clientRequestToken": "string",
   "createdAt": number,
   "failureCode": "string",
   "iamRole": "string",
   "outputLocation": { 
      "s3Bucket": "string",
      "s3Prefix": "string"
   },
   "status": "string",
   "tags": { 
      "string" : "string" 
   }
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

arn

Nama Sumber Daya Amazon (ARN) dari pekerjaan ekspor dunia.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 1224.

Pola: arn:.*

clientRequestToken

Pengidentifikasi unik dan peka huruf besar/kecil yang Anda berikan untuk memastikan idempotensi permintaan.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

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

createdAt

Waktu, dalam milidetik sejak zaman, ketika pekerjaan ekspor dunia diciptakan.

Tipe: Timestamp

failureCode

Kode kegagalan pekerjaan ekspor dunia jika gagal:

InternalServiceError

Kesalahan layanan internal.

LimitExceeded

Sumber daya yang diminta melebihi jumlah maksimum yang diizinkan, atau jumlah permintaan aliran bersamaan melebihi jumlah maksimum yang diizinkan.

ResourceNotFound

Sumber daya yang ditentukan tidak dapat ditemukan.

RequestThrottled

Permintaan itu dibatasi.

InvalidInput

Parameter input dalam permintaan tidak valid.

AllWorldGenerationFailed

Semua dunia dalam pekerjaan generasi dunia gagal. Ini bisa terjadi jika Anda worldCount lebih besar dari 50 atau kurang dari 1.

Untuk informasi selengkapnya tentang pemecahan masalah WorldForge, lihat Simulasi Pemecahan Masalah. WorldForge

Jenis: String

Nilai yang Valid: InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AccessDenied

iamRole

Peran IAM yang digunakan proses ekspor dunia untuk mengakses bucket Amazon S3 dan menempatkan ekspor.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.

Pola: arn:aws:iam::\w+:role/.*

outputLocation

Lokasi output.

Tipe: Objek OutputLocation

status

Status pekerjaan ekspor dunia.

Tertunda

Permintaan pekerjaan ekspor dunia tertunda.

Berjalan

Pekerjaan ekspor dunia sedang berjalan.

Selesai

Pekerjaan ekspor dunia selesai.

Failed

Pekerjaan ekspor dunia gagal. Untuk informasi selengkapnya, lihat failureCode.

Dibatalkan

Pekerjaan ekspor dunia dibatalkan.

Membatalkan

Pekerjaan ekspor dunia dibatalkan.

Jenis: String

Nilai yang Valid: Pending | Running | Completed | Failed | Canceling | Canceled

tags

Peta yang berisi kunci tag dan nilai tag yang dilampirkan ke pekerjaan ekspor dunia.

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.

Kode Status HTTP: 400

InternalServerException

AWS RoboMaker mengalami masalah layanan. Coba lagi panggilan Anda.

Kode Status HTTP: 500

InvalidParameterException

Parameter yang ditentukan dalam permintaan tidak valid, tidak didukung, atau tidak dapat digunakan. Pesan yang dikembalikan memberikan penjelasan tentang nilai kesalahan.

Kode Status HTTP: 400

ResourceNotFoundException

Sumber daya yang ditentukan tidak ada.

Kode Status HTTP: 400

ServiceUnavailableException

Permintaan telah gagal karena kegagalan sementara server.

Kode Status HTTP: 503

ThrottlingException

RoboMaker AWS untuk sementara tidak dapat memproses permintaan. Coba lagi panggilan Anda.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: