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 kustom di file Wilayah AWS.
Sintaksis Permintaan
POST /v3/images/custom
{
"imageConfiguration": "string",
"imageId": "string",
"dryrun": boolean,
"region": "string",
"rollbackOnFailure": boolean,
"supressValidators": [ "string" ],
"validationFailureLevel": "string"
}
Isi permintaan
- ImageConfiguration
-
Konfigurasi gambar sebagai dokumen YAMAL.
Jenis: string
Diperlukan: Ya
- imageId
-
ID gambar yang akan dibangun.
Jenis: string
Diperlukan: Ya
- dryrun
-
Jika disetel ke
true
, hanya lakukan validasi permintaan tanpa membuat sumber daya apa pun. Gunakan parameter ini untuk memvalidasi konfigurasi gambar. Defaultnya adalahfalse
.Jenis: boolean
Wajib: Tidak
- region
-
Wilayah AWS Itu yang Anda jalankan perintah untuk membangun gambar di.
Jenis: string
Wajib: Tidak
- rollbackOnFailure
-
Jika disetel ke
true
, pengembalian tumpukan gambar terjadi jika gambar gagal dibuat. Defaultnya adalahfalse
.Jenis: boolean
Wajib: Tidak
- SuppressValidator
-
Identifikasi satu atau beberapa validator konfigurasi untuk ditekan.
Jenis: daftar string
Format:
(ALL|type:[A-Za-z0-9]+)
Wajib: Tidak
- validationFailureLevel
-
Level validasi minimum yang menyebabkan build image 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
- cloudformationStackArn
-
Nama Sumber Daya Amazon (ARN) dari tumpukan utama CloudFormation .
Jenis: string
- cloudformationStackStatus
-
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 EC2 AMI Amazon.
Jenis: string
- imageBuildStatus
-
Status pembuatan gambar.
Jenis: string
Nilai yang valid:
BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE
- region
-
Gambar Wilayah AWS itu dibangun.
Jenis: string
- versi
-
AWS ParallelCluster Versi yang digunakan untuk membangun gambar.
Jenis: string
- ValidationMessages
-
Daftar pesan dengan tingkat validasi lebih rendah dari
validationFailureLevel
. 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
Permintaan
$
build_image(
custom-image-id
,custom-image-config.yaml
)
200 Respon
{
"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"
}
}