View a markdown version of this page

Construire une image - AWS ParallelCluster

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Construire une image

Créez une AWS ParallelCluster image personnalisée dans un Région AWS.

Syntaxe de demande

POST /v3/images/custom { "imageConfiguration": "string", "imageId": "string", "dryrun": boolean, "region": "string", "rollbackOnFailure": boolean, "suppressValidators": [ "string" ], "validationFailureLevel": "string" }

Corps de la demande

Configuration de l'image

La configuration de l'image sous forme de document YAML.

Type : chaîne

Obligatoire : oui

imageId

L'ID de l'image à créer.

Type : chaîne

Obligatoire : oui

run à sec

Si ce paramètre est défini surtrue, effectuez uniquement la validation des demandes sans créer de ressource. Utilisez ce paramètre pour valider la configuration de l'image. La valeur par défaut est false.

Type : valeur booléenne

Obligatoire : non

region

Le Région AWS dans lequel vous exécutez la commande pour créer l'image.

Type : chaîne

Obligatoire : non

rollback OnFailure

Si cette valeur est définie surtrue, la restauration de la pile d'images se produit si l'image ne parvient pas à être créée. La valeur par défaut est false.

Type : valeur booléenne

Obligatoire : non

Supprimer les validateurs

Identifiez un ou plusieurs validateurs de configuration à supprimer.

Type : liste de chaînes

Format : (ALL|type:[A-Za-z0-9]+)

Obligatoire : non

validation FailureLevel

Niveau de validation minimal à l'origine de l'échec de la création de l'image. La valeur par défaut est ERROR.

Type : chaîne

Valeurs valides : INFO | WARNING | ERROR

Obligatoire : non

Syntaxe de réponse

{ "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" } ] }

Corps de la réponse

image
imageId

L'ID de l'image.

Type : chaîne

formation de nuages StackArn

Le nom de ressource Amazon (ARN) de la CloudFormation pile principale.

Type : chaîne

formation de nuages StackStatus

L'état de la CloudFormation pile.

Type : chaîne

Valeurs valides : 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

L'ID de l'AMI Amazon EC2.

Type : chaîne

image BuildStatus

État de création de l'image.

Type : chaîne

Valeurs valides : BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE

region

Le Région AWS dans lequel l'image est construite.

Type : chaîne

version

AWS ParallelCluster Version utilisée pour créer l'image.

Type : chaîne

Messages de validation

Liste des messages dont le niveau de validation est inférieur àvalidationFailureLevel. La liste des messages est collectée lors de la validation de la configuration.

id

L'ID du validateur.

Type : chaîne

level

Le niveau de validation.

Type : chaîne

Valeurs valides : INFO | WARNING | ERROR

message

Un message de validation.

Type : chaîne

type

Type de validateur.

Type : chaîne

Exemple

Python

Demande

$ build_image(custom-image-id, custom-image-config.yaml)

Réponse 200

{ "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" } }