Comment restaurer un objet Amazon S3 à partir de la classe de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive à l'aide de l'AWS CLI ?

Lecture de 6 minute(s)
0

J'ai archivé un objet Amazon Simple Storage Service (Amazon S3) dans la classe de stockage Amazon S3 Glacier Flexible Retrieval ou Amazon S3 Glacier Deep Archive. Je souhaite restaurer l'objet à l'aide de l'interface de la ligne de commande AWS (AWS CLI).

Résolution

Remarque : Si des erreurs surviennent lors de l'exécution des commandes AWS CLI, vérifiez que vous utilisez la version la plus récente d'AWS CLI.

Lancer une demande de restauration

Exécutez la commande suivante pour lancer une demande de restauration. Veillez à remplacer toutes les valeurs de l'exemple de commande par les valeurs de votre compartiment, de votre objet et de votre demande de restauration.

Remarque : Comme les frais de récupération de données sont basés sur le nombre de demandes, assurez-vous de vérifier que les paramètres de votre demande de restauration sont corrects.

$ aws s3api restore-object --bucket awsexamplebucket --key dir1/example.obj --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Standard"}}'

La demande de récupération crée une copie temporaire de vos données dans la classe de stockage S3 Standard et laisse les données archivées intactes. Dans cet exemple, il crée la copie pendant 25 jours. Dans les Régions AWS où le stockage à redondance réduite est moins cher que S3 Standard, les données temporairement disponibles sont facturées en tant que stockage à redondance réduite. Toutefois, la classe de stockage de facturation à redondance réduite ne reflète pas la façon dont les données sont stockées.

Notez les modifications suivantes que vous pouvez apporter à la commande :

  • Pour restaurer une version d'objet spécifique dans un compartiment versionné, incluez l'option**--version-id**, puis spécifiez l'identifiant de version correspondant.
  • Pour la classe de stockage S3 Glacier Flexible Retrieval, vous pouvez utiliser les options de récupération Rapide, Standard ou En bloc. Toutefois, vous ne pouvez utiliser que les options de récupération Standard ou En bloc pour la classe de stockage S3 Glacier Deep Archive.
  • Si la syntaxe JSON utilisée dans l'exemple entraîne une erreur sur un client Windows, remplacez la demande de restauration par la syntaxe suivante :
--restore-request Days=25,GlacierJobParameters={"Tier"="Standard"}

Remarque : Pour les objets stockés dans S3 Glacier Instant Retrieval, la récupération des données est instantanée et vous n'avez pas besoin d'utiliser l'opération de restauration. Pour plus d'informations, consultez la section Classes de stockage Amazon S3.

Surveiller l'état de votre demande de restauration

Exécutez la commande suivante pour contrôler l'état de votre demande de restauration :

aws s3api head-object --bucket awsexamplebucket --key dir1/example.obj

Si la restauration est toujours en cours après l'exécution de la commande, vous recevez une réponse similaire à la suivante :

{  
    "Restore": "ongoing-request=\"true\"",  
    ...  
    "StorageClass": "GLACIER | DEEP_ARCHIVE",  
    "Metadata": {}  
}

Une fois la restauration terminée, vous recevez une réponse similaire à la suivante :

{  
    "Restore": "ongoing-request=\"false\", expiry-date=\"Sun, 13 Aug 2017 00:00:00 GMT\"",  
    ...  
    "StorageClass": "GLACIER | DEEP_ARCHIVE",  
    "Metadata": {}  
}

Notez la date d'expiration dans la réponse. Vous avez jusqu'à cette date pour accéder à l'objet de stockage temporaire stocké dans la classe de stockage S3 Standard. L'objet temporaire est disponible en même temps que l'objet archivé qui se trouve dans la classe de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Une fois la date d'expiration dépassée, Amazon S3 supprime l'objet temporaire. Vous devez modifier la classe de stockage de l'objet avant que l'objet temporaire n'expire. Pour modifier la classe de stockage de l'objet après la date d'expiration, vous devez lancer une nouvelle demande de restauration.

Remplacer la classe de stockage de l'objet par Amazon S3 Standard

Pour remplacer la classe de stockage de l'objet par Amazon S3 Standard, utilisez copier. Vous pouvez remplacer l'objet existant ou le copier dans un autre emplacement.

Avertissement : Si vous utilisez la version 1.x de l'interface de ligne de commande AWS, vérifiez que le seuil partitionné est défini sur 5 Go avant de copier un objet. Sinon, les métadonnées utilisateur de l'objet sont perdues lorsque la taille de l'objet est supérieure aux seuils partitionnés de l'AWS CLI. Pour les objets de plus de 5 Go, utilisez la version 2.x de l'AWS CLI pour préserver les métadonnées utilisateur.

(Facultatif) Pour augmenter le seuil partitionné de l'AWS CLI, exécutez la commande suivante :

aws configure set default.s3.multipart_threshold 5GB

Pour remplacer l'objet existant par la classe de stockage Amazon S3 Standard, exécutez la commande suivante :

aws s3 cp s3://awsexamplebucket/dir1/example.obj s3://awsexamplebucket/dir1/example.obj --storage-class STANDARD

Pour effectuer une copie récursive de l'intégralité d'un préfixe et remplacer les objets existants par la classe de stockage Amazon S3 Standard, exécutez la commande suivante :

aws s3 cp s3://awsexamplebucket/dir1/ s3://awsexamplebucket/dir1/ --storage-class STANDARD --recursive --force-glacier-transfer

Remarque : Les objets archivés dans S3 Glacier Flexible Retrieval ont une durée de stockage minimale de 90 jours. Les objets archivés dans S3 Glacier Deep Archive ont une durée de stockage minimale de 180 jours. Si vous remplacez un objet dans S3 Glacier Flexible Retrieval avant l'expiration du délai minimum de 90 jours, vous êtes facturé pendant 90 jours. De même, pour les objets que vous remplacez dans S3 Glacier Deep Archive avant l'expiration du délai minimum de 180 jours, vous êtes facturé pendant 180 jours.

Pour copier l'objet dans un autre emplacement, exécutez la commande suivante :

aws s3 cp s3://awsexamplebucket/dir1/example.obj s3://awsexamplebucket/dir2/example2.obj

Remarque : Pour les compartiments suspendus ou pour lesquels le contrôle de version est activé, cette étape crée des copies supplémentaires des objets. Ces objets supplémentaires entraînent également des frais de stockage. Pour éviter les coûts de stockage, supprimez les versions non actuelles qui font toujours partie de la classe de stockage Amazon S3 Glacier. Vous pouvez également créer une règle d'expiration du cycle de vie S3.

Informations connexes

Comment lancer des restaurations pour un volume important d'objets Amazon S3 qui se trouvent actuellement dans la classe de stockage S3 Glacier ou S3 Glacier Deep Archive ?

Comment utiliser les niveaux de restauration de la console Amazon S3 pour restaurer des objets archivés à partir de la classe de stockage Amazon S3 Glacier ?

Restauration d'un objet archivé

AWS OFFICIEL
AWS OFFICIELA mis à jour il y a 10 mois