本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
-
主 CloudFormation 堆栈的亚马逊资源名称 (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
- ec2 AmiInfo
-
- ami_id
-
亚马逊 EC2 AMI ID。
类型:字符串
- imageBuildStatus
-
映像构建状态。
类型:字符串
有效值:
BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE
- 区域
-
AWS 区域 那就是图像是内置的。
类型:字符串
- version
-
用于构建镜像的 AWS ParallelCluster 版本。
类型:字符串
- validationMessages
-
验证级别低于
validationFailureLevel
的消息的列表。消息列表是在配置验证期间收集的。- id
-
验证器 ID。
类型:字符串
- level
-
验证级别。
类型:字符串
有效值:
INFO | WARNING | ERROR
- message
-
验证消息。
类型:字符串
- type
-
验证器的类型。
类型:字符串