Restauration d’un objet archivé

Restauration d’objets à l’aide de la console Amazon S3

Utilisez la procédure suivante pour restaurer un objet qui a été archivé dans les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, ou aux niveaux de stockage Archive Access ou Deep Archive Access de S3 Intelligent-Tiering.

Restauration d’objets depuis S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive

L’exemple suivant utilise la commande restore-object pour restaurer l’objet dir1/example.obj dans le compartiment amzn-s3-demo-bucketpendant 25 jours.

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

Si la syntaxe JSON utilisée dans cet exemple génère une erreur sur un client Windows, remplacez la demande de restauration par la syntaxe suivante :

--restore-request Days=25,GlacierJobParameters={"Tier"="Standard"}

Restauration d’objets depuis le niveau Archive Access ou Deep Archive Access de S3 Intelligent-Tiering

L’exemple suivant utilise la commande restore-object pour restaurer l’objet dir1/example.obj dans le compartiment amzn-s3-demo-bucket au niveau d’accès fréquent.

aws s3api restore-object --bucket amzn-s3-demo-bucket --key dir1/example.obj --restore-request '{}'

Surveillance du statut de la restauration

Pour surveiller le statut de votre demande restore-object, utilisez la commande suivante head-object :

aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj

Pour plus d’informations, consultez restore-object dans la Référence des commandes de l’AWS CLI.

Amazon S3 fournit une opération d’API pour vous permettre de lancer la restauration d’un objet archivé. Pour plus d’informations, veuillez consulter RestoreObject dans la Référence des API Amazon Simple Storage Service.

Pour obtenir des exemples illustrant comment restaurer des objets archivés dans S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive à l’aide des kits AWS SDK, consultez Exemples de code dans la Référence d’API Amazon S3.

Pour restaurer plusieurs objets archivés avec une seule demande, vous pouvez utiliser les opérations par lot S3. Vous fournissez à S3 Batch Operations une liste d’objets sur lesquels effectuer des opérations. S3 Batch Operations appelle l’opération d’API respective pour effectuer l’opération spécifiée. Une tâche Batch Operations peut effectuer l’opération spécifiée sur des milliards d’objets contenant des exaoctets de données.

Pour créer une tâche d’opérations par lot, vous devez disposer d’un manifeste contenant uniquement les objets que vous souhaitez restaurer. Vous pouvez créer un manifeste à l’aide de S3 Inventory ou vous pouvez fournir un fichier CSV contenant les informations nécessaires. Pour plus d’informations, consultez Spécification d’un manifeste.

Avant de créer et d’exécuter des tâches d’opérations par lot S3, vous devez accorder des autorisations à Amazon S3 pour effectuer des opérations par lot S3 en votre nom. Pour les autorisations requises, consultez Octroi d’autorisations pour Batch Operations .

Pour plus d’informations sur les opérations par lot, consultez Restauration d’objets à l’aide de Batch Operations et Création d’une tâche S3 Batch Operations.

Vous pouvez être averti par notification de la fin de la restauration d’un objet en utilisant l’action s3:ObjectRestore:Completed avec la fonctionnalité Notifications d’événements Amazon S3. Pour plus d’informations sur l’activation des notifications d’événements, consultez Activation des notifications à l’aide d’Amazon SQS, d’Amazon SNS ou d’AWS Lambda. Pour plus d’informations sur les divers types d’événements ObjectRestore, consultez Types d’événements pris en charge pour SQS, SNS et Lambda.

Vérification du statut de restauration et de la date d’expiration d’un objet à l’aide de l’interface AWS CLI

L’exemple suivant utilise la commande head-object pour afficher les métadonnées de l’objet dir1/example.obj dans le compartiment amzn-s3-demo-bucket. Lorsque vous exécutez cette commande sur un objet en cours de restauration, Amazon S3 indique si la restauration est en cours et (le cas échéant) la date d’expiration.

aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj

Résultat attendu (restauration en cours) :

{
    "Restore": "ongoing-request=\"true\"",
    "LastModified": "2020-06-16T21:55:22+00:00",
    "ContentLength": 405,
    "ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
    "VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {},
    "StorageClass": "GLACIER"
}

Résultat attendu (restauration terminée) :

{
    "Restore": "ongoing-request=\"false\", expiry-date=\"Wed, 12 Aug 2020 00:00:00 GMT\"",
    "LastModified": "2020-06-16T21:55:22+00:00",
    "ContentLength": 405,
    "ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
    "VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {},
    "StorageClass": "GLACIER"
}

Pour plus d’informations sur head-object, consultez head-object dans la Référence des commandes de l’AWS CLI.

Amazon S3 fournit une opération d’API qui vous permet de récupérer les métadonnées des objets. Pour vérifier le statut de restauration et la date d’expiration d’un objet archivé à l’aide de l’API REST, consultez HeadObject dans la Référence de l’API Amazon Simple Storage Service.