本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
buildImage
在 中建立自訂 AWS ParallelCluster 映像 AWS 區域。
請求語法
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
-
識別要隱藏的一或多個組態驗證器。
類型:字串清單
格式:
(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" } ] }
回應內文
- image
-
- imageId
-
映像的 ID。
類型:字串
- cloudformationStackArn
-
mainARN 堆疊的 Amazon Resource Name ( CloudFormation )。
類型:字串
- cloudformationStackStatus
-
The 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
-
驗證器的類型。
類型:字串