View a markdown version of this page

BuildImage - AWS ParallelCluster

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

BuildImage

Buat AWS ParallelCluster gambar khusus di sebuah Wilayah AWS.

Sintaksis Permintaan

POST /v3/images/custom { "imageConfiguration": "string", "imageId": "string", "dryrun": boolean, "region": "string", "rollbackOnFailure": boolean, "suppressValidators": [ "string" ], "validationFailureLevel": "string" }

Isi permintaan

Konfigurasi gambar

Konfigurasi gambar sebagai dokumen YAML.

Jenis: string

Diperlukan: Ya

imageId

ID gambar yang akan dibangun.

Jenis: string

Diperlukan: Ya

Dryrun

Jika disetel ketrue, hanya melakukan validasi permintaan tanpa membuat sumber daya apa pun. Gunakan parameter ini untuk memvalidasi konfigurasi gambar. Defaultnya adalah false.

Jenis: boolean

Wajib: Tidak

region

Wilayah AWS Di mana Anda menjalankan perintah untuk membangun gambar.

Jenis: string

Wajib: Tidak

kembalikan OnFailure

Jika disetel ketrue, rollback tumpukan gambar terjadi jika gambar gagal dibuat. Defaultnya adalah false.

Jenis: boolean

Wajib: Tidak

SuppressValidator

Identifikasi satu atau lebih validator konfigurasi untuk ditekan.

Jenis: daftar string

Format: (ALL|type:[A-Za-z0-9]+)

Wajib: Tidak

validasi FailureLevel

Tingkat validasi minimum yang menyebabkan pembuatan gambar gagal. Default-nya adalah ERROR.

Jenis: string

Nilai valid: INFO | WARNING | ERROR

Wajib: Tidak

Sintaksis Respons

{ "image": { "imageId": "string", "ec2AmiInfo": { "amiId": "string" }, "region": "string", "version": "string", "cloudformationStackArn": "string", "imageBuildStatus": "BUILD_IN_PROGRESS", "cloudformationStackStatus": "CREATE_IN_PROGRESS" }, "validationMessages": [ { "id": "string", "type": "string", "level": "INFO", "message": "string" } ] }

Isi respons

gambar
imageId

ID gambar.

Jenis: string

formasi awan StackArn

Nama Sumber Daya Amazon (ARN) dari CloudFormation tumpukan utama.

Jenis: string

formasi awan StackStatus

Status CloudFormation tumpukan.

Jenis: string

Nilai yang valid: CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE

ec2 AmiInfo
Ami_id

ID AMI Amazon EC2.

Jenis: string

gambar BuildStatus

Status pembuatan gambar.

Jenis: string

Nilai yang valid: BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE

region

Wilayah AWS Di mana gambar dibangun.

Jenis: string

versi

AWS ParallelCluster Versi yang digunakan untuk membangun gambar.

Jenis: string

Pesan Validasi

Daftar pesan dengan tingkat validasi lebih rendah darivalidationFailureLevel. Daftar pesan dikumpulkan selama validasi konfigurasi.

id

ID validator.

Jenis: string

level

Tingkat validasi.

Jenis: string

Nilai yang valid: INFO | WARNING | ERROR

pesan

Pesan validasi.

Jenis: string

jenis

Jenis validator.

Jenis: string

Contoh

Python

Permintaan

$ build_image(custom-image-id, custom-image-config.yaml)

200 Tanggapan

{ "image": { "cloudformation_stack_arn": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-image-id/711b76b0-af81-11ec-a29f-0ee549109f1f", "cloudformation_stack_status": "CREATE_IN_PROGRESS", "image_build_status": "BUILD_IN_PROGRESS", "image_id": "custom-image-id", "region": "us-east-1", "version": "3.2.1" } }