buildImage
Create a custom Amazon ParallelCluster image in an Amazon Web Services Region.
Request syntax
POST /v3/images/custom { "imageConfiguration": "string", "imageId": "string", "dryrun": boolean, "region": "string", "rollbackOnFailure": boolean, "supressValidators": [ "string" ], "validationFailureLevel": "string" }
Request body
- imageConfiguration
-
The image configuration as a YAML document.
Type: string
Required: Yes
- imageId
-
The ID of the image to build.
Type: string
Required: Yes
- dryrun
-
If set to
true, only perform request validation without creating any resource. Use this parameter to validate the image configuration. The default isfalse.Type: boolean
Required: No
- region
-
The Amazon Web Services Region that you run the command to build the image in.
Type: string
Required: No
- rollbackOnFailure
-
If set to
true, image stack rollback occurs if the image fails to create. The default isfalse.Type: boolean
Required: No
- suppressValidators
-
Identify one or more configuration validators to suppress.
Type: list of strings
Format:
(ALL|type:[A-Za-z0-9]+)Required: No
- validationFailureLevel
-
The minimum validation level that causes image build to fail. The default is
ERROR.Type: string
Valid values:
INFO | WARNING | ERRORRequired: No
Response syntax
{ "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" } ] }
Response body
- image
-
- imageId
-
The ID of the image.
Type: string
- cloudformationStackArn
-
The Amazon Resource Name (ARN) of the main CloudFormation stack.
Type: string
- cloudformationStackStatus
-
The CloudFormation stack status.
Type: string
Valid values:
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
-
The EC2 AMI ID.
Type: string
- imageBuildStatus
-
The image build status.
Type: string
Valid values:
BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE - region
-
The Amazon Web Services Region that the image is built in.
Type: string
- version
-
The Amazon ParallelCluster version that's used to build the image.
Type: string
- validationMessages
-
A list of messages with a validation level lower than
validationFailureLevel. The list of messages is collected during configuration validation.- id
-
The validator ID.
Type: string
- level
-
The validation level.
Type: string
Valid values:
INFO | WARNING | ERROR - message
-
A validation message.
Type: string
- type
-
The type of validator.
Type: string