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 restore-object commande pour restaurer l'objet dir1/exemple.obj dans le seau amzn-s3-demo-bucket pendant 25 jours.

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

Si la JSON syntaxe 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"}

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

L'exemple suivant utilise la restore-object commande pour restaurer l'objet dir1/exemple.obj dans le compartiment correspondant amzn-s3-demo-bucket au niveau Frequent Access.

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-objectdans la référence de AWS CLI commande.

Amazon S3 fournit une API opération vous permettant de lancer la restauration d'un objet archivé. Pour plus d’informations, consultez .RestoreObjectdans le Amazon Simple Storage Service API Reference.

Pour des exemples de restauration d'objets archivés dans S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive avec le AWS SDKs, consultez les exemples de code dans le manuel Amazon S3 API Reference.

Pour restaurer plusieurs objets archivés avec une seule demande, vous pouvez utiliser les opérations par lot S3. Vous fournissez à la fonctionnalité d'opérations par lot S3 une liste d'objets sur lesquels effectuer des opérations. S3 Batch Operations appelle l'APIopération correspondante pour effectuer l'opération spécifiée. Une tâche d'opérations par lot 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 CSV fichier contenant les informations nécessaires. Pour de plus amples informations, veuillez consulter 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 les opérations par lots.

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

Vous pouvez être informé de la fin de la restauration d'un objet en utilisant l's3:ObjectRestore:Completedaction associée à la fonctionnalité de notifications d'événements Amazon S3. Pour plus d'informations sur l'activation des notifications d'événements, consultez la section Activation des notifications à l'aide d'Amazon SQSSNS, Amazon et AWS Lambda. Pour plus d'informations sur les différents types d'ObjectRestoreévénements, consultezTypes d'événements pris en charge pourSQS,SNS, et Lambda.

Vérifiez l'état de restauration et la date d'expiration d'un objet à l'aide du AWS CLI

L'exemple suivant utilise la head-object commande pour afficher les métadonnées de l'objet dir1/exemple.obj dans le seauamzn-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-objectdans la référence de AWS CLI commande.

Amazon S3 fournit une API opération qui vous permet de récupérer les métadonnées des objets. Pour vérifier l'état de restauration et la date d'expiration d'un objet archivé à l'aide du RESTAPI, voir HeadObjectdans le Amazon Simple Storage Service API Reference.