buildImage
AWS リージョン でカスタム AWS ParallelCluster イメージを作成します。
リクエストの構文
POST /v3/images/custom { "imageConfiguration": "string", "imageId": "string", "dryrun": boolean, "region": "string", "rollbackOnFailure": boolean, "supressValidators": [ "string" ], "validationFailureLevel": "string" }
リクエスト本文
- imageConfiguration
-
YAML ドキュメントとしてのイメージ設定。
タイプ: 文字列
必須: はい
- imageId
-
ビルドするイメージの ID。
タイプ: 文字列
必須: はい
- dryrun
-
true
に設定すると、リソースを作成することなく、リクエストの検証のみを行います。このパラメータを使用して、イメージ設定を検証します。デフォルト:false
。型: ブール値
必須:いいえ
- region
-
コマンドを実行してイメージをビルドする AWS リージョン。
タイプ: 文字列
必須: いいえ
- rollbackOnFailure
-
true
に設定すると、イメージの作成に失敗した場合にイメージスタックのロールバックが行われます。デフォルト:false
。型: ブール値
必須:いいえ
- suppressValidators
-
抑制する 1 つまたは複数の設定バリデータを指定します。
タイプ: 文字列のリスト
形式:
(ALL|type:[A-Za-z0-9]+)
必須:いいえ
- validationFailureLevel
-
イメージビルドが失敗する最小の検証レベル。デフォルト:
ERROR
。タイプ: 文字列
有効な値:
INFO | WARNING | ERROR
必須:いいえ
レスポンスの構文
{ "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" } ] }
レスポンス本文
- 画像
-
- imageId
-
イメージの ID。
タイプ: 文字列
- cloudformationStackArn
-
メイン CloudFormation スタックの Amazon リソースネーム (ARN)。
タイプ: 文字列
- cloudformationStackStatus
-
CloudFormation スタックの状態。
タイプ: 文字列
有効な値:
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
- ec2AmiInfo
-
- ami_id
-
Amazon EC2 AMI ID。
タイプ: 文字列
- imageBuildStatus
-
イメージビルドのステータス。
タイプ: 文字列
有効な値:
BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE
- region
-
イメージがビルドされた AWS リージョン。
タイプ: 文字列
- version
-
イメージのビルドに使用された AWS ParallelCluster バージョン。
タイプ: 文字列
- validationMessages
-
検証レベルが
validationFailureLevel
以下のメッセージのリスト。メッセージのリストは設定の検証中に収集されます。- id
-
バリデータの ID。
タイプ: 文字列
- level
-
検証レベル。
タイプ: 文字列
有効な値:
INFO | WARNING | ERROR
- message
-
検証メッセージ。
タイプ: 文字列
- type
-
バリデータのタイプ。
タイプ: 文字列