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.

Comment fonctionnent AMI le stockage et la restauration

Pour stocker et restaurer un fichier à AMI l'aide de S3, vous devez utiliser ce qui suit APIs :

CreateStoreImageTask

CreateStoreImageTaskAPIStocke un AMI en tant qu'objet unique dans un compartiment S3.

APIcrée une tâche qui lit toutes les données à partir de AMI ses instantanés, puis utilise un téléchargement partitionné S3 pour stocker les données dans un objet S3. APIIl prend tous les composants duAMI, y compris la plupart des AMI métadonnées non spécifiques à une région, et tous les EBS instantanés qu'il contientAMI, et les regroupe dans un seul objet dans S3. Les données sont compressées dans le cadre du processus de téléchargement afin de réduire l'espace utilisé dans S3. L'objet dans S3 peut donc être inférieur à la somme des tailles des instantanés duAMI.

Si des balises AMI de capture d'écran sont visibles par le compte qui l'appelleAPI, elles sont conservées.

L'objet dans S3 possède le même identifiant que leAMI, mais avec une .bin extension. Les données suivantes sont également stockées sous forme de balises de métadonnées S3 sur l'objet S3 : AMI nom, AMI description, date AMI d'enregistrement, compte AMI du propriétaire et horodatage du fonctionnement du magasin.

Le temps nécessaire pour terminer la tâche dépend de la taille duAMI. Il dépend également du nombre d’autres tâches en cours car les tâches sont mises en file d’attente. Vous pouvez suivre la progression de la tâche en appelant le DescribeStoreImageTasksAPI.

La somme des tailles de toutes les données AMIs en cours est limitée à 600 Go de données EBS instantanées par compte. La création d’autres tâches est rejetée jusqu’à ce que les tâches en cours soient inférieures à la limite. Par exemple, si une version AMI contenant 100 Go de données de capture instantanée et une autre AMI contenant 200 Go de données de capture sont actuellement stockées, une autre demande sera acceptée, car le total en cours est de 300 Go, ce qui est inférieur à la limite. Mais si un single AMI contenant 800 Go de données instantanées est actuellement stocké, les autres tâches sont rejetées jusqu'à ce qu'elles soient terminées.

DescribeStoreImageTasks

DescribeStoreImageTasksAPIDécrit la progression des tâches du AMI magasin. Vous pouvez décrire les tâches pour des tâches spécifiéesAMIs. Si vous ne le spécifiez pasAMIs, vous obtenez une liste paginée de toutes les tâches liées aux images du magasin qui ont été traitées au cours des 31 derniers jours.

Pour chaque AMI tâche, la réponse indique si la tâche est InProgressCompleted, ouFailed. Pour les tâches InProgress, la réponse affiche une progression estimée en pourcentage.

Les tâches sont répertoriées dans l’ordre chronologique inverse.

Actuellement, seules les tâches du mois précédent peuvent être affichées.

CreateRestoreImageTask

CreateRestoreImageTaskAPIDémarre une tâche qui restaure un AMI objet S3 créé précédemment à l'aide d'une CreateStoreImageTask requête.

La tâche de restauration peut être exécutée dans la même région ou dans une autre région dans laquelle la tâche de stockage a été réalisée.

Le compartiment S3 à partir duquel l'AMIobjet sera restauré doit se trouver dans la même région que celle dans laquelle la tâche de restauration est demandée. Ils AMI seront restaurés dans cette région.

Le AMI est restauré avec ses métadonnées, telles que le nom, la description et les mappages de périphériques de blocs correspondant aux valeurs du périphérique stockéAMI. Le nom de ce compte doit être unique AMIs dans la région. Si vous ne fournissez pas de nom, le nouveau AMI prend le même nom que l'originalAMI. AMIobtient un nouvel AMI identifiant généré au moment du processus de restauration.

Le temps nécessaire pour terminer la tâche de AMI restauration dépend de la taille duAMI. Il dépend également du nombre d’autres tâches en cours car les tâches sont mises en file d’attente. Vous pouvez visualiser la progression de la tâche en décrivant AMI (describe-images) ou ses EBS instantanés (describe-snapshots). Si la tâche échoue, les instantanés AMI et sont déplacés vers l'état d'échec.

La somme des tailles de tous les instantanés AMIs en cours est limitée à 300 Go (sur la base de la taille après restauration) de données EBS instantanées par compte. La création d’autres tâches est rejetée jusqu’à ce que les tâches en cours soient inférieures à la limite.

Chemins de fichier

Vous pouvez utiliser les chemins des fichiers lors du stockage et de la restaurationAMIs, de la manière suivante :

Exemple : utilisez un chemin de fichier lors du stockage et de la restauration d'un AMI (AWS CLI)

L'exemple suivant enregistre d'abord un AMI dans S3, avec le chemin du fichier ajouté au nom du compartiment. L'exemple restaure ensuite le fichier AMI à partir de S3, le chemin du fichier étant ajouté au paramètre clé de l'objet.

Lorsque vous stockez leAMI, spécifiez le chemin du fichier après le nom du bucket, comme suit :

aws ec2 create-store-image-task \
    --image-id ami-1234567890abcdef0 \
    --bucket amzn-s3-demo-bucket/path1/path2

Voici un exemple de sortie.

{
  "ObjectKey": "path1/path2/ami-1234567890abcdef0.bin"
}

Lorsque vous restaurez leAMI, spécifiez la valeur de la sortie de l'étape précédente, y compris le chemin du fichier.

aws ec2 create-restore-image-task \
    --object-key path1/path2/ami-1234567890abcdef0.bin \
    --bucket amzn-s3-demo-bucket \
    --name "New AMI Name"