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.

Tipe: string

Diperlukan: Ya

imageId

ID gambar yang akan dibangun.

Tipe: string

Diperlukan: Ya

dryrun

Jika disetel ketrue, hanya lakukan 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 Itu yang Anda jalankan perintah untuk membangun gambar di.

Jenis: string

Wajib: Tidak

rollbackOnFailure

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

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 AMI Amazon EC2.

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 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 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'
  }
}