View a markdown version of this page

Image de construction - 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.

Image de construction

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 requête

Configuration de l'image

La configuration de l'image en tant que document YAML.

Type : chaîne

Obligatoire : oui

imageId

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

Type : chaîne

Obligatoire : oui

course à sec

Si ce paramètre est défini surtrue, n'effectuez que la validation de la demande 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

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

Type : chaîne

Obligatoire : non

revenir en arrière OnFailure

Si ce paramètre est défini surtrue, l'annulation 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

Le niveau de validation minimum qui entraîne 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 des nuages StackArn

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

Type : chaîne

formation des 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 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

L' Région AWS endroit 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" } }