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.
# Restauration d’un objet archivé
Les objets Amazon S3 figurant dans les classes ou niveaux de stockage suivants sont archivés et ne sont pas accessibles en temps réel :
+ Classe de stockage S3 Glacier Flexible Retrieval
+ Classe de stockage S3 Glacier Deep Archive
+ Le niveau Intelligent-Tiering d'accès aux archives S3
+ Le niveau S3 Intelligent-Tiering Deep Archive Access
Les objets Amazon S3 stockés dans les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive ne sont pas immédiatement accessibles. Pour accéder à un objet dans ces classes de stockage, vous devez en restaurer une copie temporaire de l’objet dans son compartiment S3 pendant une durée spécifiée (nombre de jours). Si vous souhaitez une copie permanente de l’objet, restaurez l’objet, puis créez-en une copie dans votre compartiment Amazon S3. La copie des objets restaurés n’est pas prise en charge dans la console Amazon S3. Pour ce type d'opération de copie, utilisez le AWS Command Line Interface (AWS CLI), les AWS SDK ou l'API REST. Excepté dans le cas où vous effectuez une copie et modifiez sa classe de stockage, l’objet sera toujours stocké dans les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Pour obtenir des informations sur l’utilisation de ces classes de stockage, consultez [Classes de stockage pour les objets rarement consultés](storage-class-intro.md#sc-glacier).
Pour accéder aux objets des niveaux S3 Intelligent-Tiering Archive Access et Deep Archive Access, vous devez lancer une demande de restauration et attendre que l'objet soit déplacé vers le niveau Frequent Access. Lorsque vous restaurez un objet depuis les niveaux d’accès Archive et Deep Archive, l’objet retourne au niveau d’accès Fréquent. Pour obtenir des informations sur l'utilisation de ces classes de stockage, consultez [Classe de stockage pour l’optimisation automatique des données avec des modèles d’accès inconnus ou irréguliers](storage-class-intro.md#sc-dynamic-data-access).
Pour obtenir des informations générales sur les objets archivés, consultez [Utilisation des objets archivés](archived-objects.md).
**Note**
Lorsque vous restaurez un objet archivé à partir des classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, vous payez à la fois pour l’objet archivé et pour la copie que vous restaurez temporairement.
Lorsque vous restaurez un objet depuis S3 Intelligent-Tiering, aucuns frais de récupération ne sont facturés pour les extractions standard ou en masse.
Les demandes de restauration ultérieures appelées sur des objets archivés qui ont déjà été restaurés sont facturées en tant que demandes `GET`. Pour obtenir des informations sur la tarification, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/).
## Restauration d’un objet archivé
Vous pouvez restaurer un objet archivé à l'aide de la console Amazon S3, de l'API REST Amazon S3, AWS des SDK, du AWS Command Line Interface (AWS CLI) ou des opérations par lots S3.
### Utilisation de la console S3
**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 dans les niveaux de stockage S3 Intelligent-Tiering Archive Access ou Deep Archive Access.
**Pour restaurer un objet archivé**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez **Compartiments à usage général**.
1. Dans la liste de compartiments, choisissez le nom du compartiment qui contient les objets que vous souhaitez restaurer.
1. Dans la liste **Objets**, sélectionnez le ou les objets à restaurer, choisissez **Actions**, puis **Lancer la restauration**.
1. Si vous effectuez une restauration depuis S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, saisissez le nombre de jours pendant lesquels vous souhaitez que vos données archivées soient accessibles dans la zone **Nombre de jours pendant lesquels la copie restaurée est disponible**.
1. Dans **Niveau d’extraction**, effectuez l’une des opérations suivantes :
+ Choisissez **Récupération en bloc** ou **Récupération standard**, puis **Commencer la restauration**.
+ Choisissez **Expedited retrieval** (disponible uniquement pour S3 Glacier Flexible Retrieval ou S3 Intelligent-Tiering Archive Access). Si vous restaurez un objet dans S3 Glacier Flexible Retrieval, vous pouvez choisir d’acheter une capacité provisionnée pour votre récupération accélérée. Si vous souhaitez acheter une capacité provisionnée, passez à l’étape suivante. Si ce n’est pas le cas, choisissez **Commencer la restauration**.
**Note**
Les objets des niveaux S3 Intelligent-Tiering Archive Access et Deep Archive Access sont automatiquement restaurés dans le niveau Frequent Access.
1. (Facultatif) Si vous restaurez un objet dans S3 Glacier Flexible Retrieval et que vous avez choisi **Récupération accélérée**, vous pouvez choisir d’acheter une capacité provisionnée. La capacité provisionnée n’est disponible que pour les objets se trouvant dans S3 Glacier Flexible Retrieval. Si vous disposez d’une capacité provisionnée, choisissez **Commencer la restauration** pour démarrer une récupération provisionnée.
Si vous disposez d’une capacité provisionnée, toutes vos récupérations accélérées sont effectuées avec votre capacité provisionnée. Pour de plus amples informations, veuillez consulter [Capacité provisionnée](restoring-objects-retrieval-options.md#restoring-objects-expedited-capacity).
+ Si vous ne disposez pas d’une capacité provisionnée et que vous ne voulez pas en acheter, choisissez **Commencer la restauration**.
+ Si vous ne disposez pas d’une capacité provisionnée, mais que vous souhaitez acheter des unités de capacité provisionnée (PCU), choisissez **Acheter des PCU**. Dans la boîte de dialogue **Acheter des PCU**, choisissez le nombre de PCU que vous souhaitez acheter, confirmez votre achat, puis choisissez **Acheter des PCU**. Lorsque le message **Réussite de l’achat** s’affiche, choisissez **Commencer la restauration** pour démarrer la récupération provisionnée.
### Utilisation de AWS CLI
**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-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 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"}
```
**Restaurer des objets depuis S3 Intelligent-Tiering Archive Access et Deep Archive Access**
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 '{}'
```
**Note**
Contrairement aux classes de stockage S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive, les demandes de restauration d' Intelligent-Tiering objets S3 n'acceptent pas la `Days` valeur.
**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 [https://docs.aws.amazon.com//cli/latest/reference/s3api/restore-object.html](https://docs.aws.amazon.com//cli/latest/reference/s3api/restore-object.html) dans la *Référence des commandes de l’AWS CLI *.
### Utilisation de l'API REST
Amazon S3 fournit une opération d’API pour vous permettre de lancer la restauration d’un objet archivé. Pour plus d’informations, consultez [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html) dans la *Référence d’API Amazon Simple Storage Service*.
### Utilisation de AWS Kits SDK
Pour des exemples de restauration d'objets archivés dans S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive à l'aide AWS des SDK, consultez les [exemples de code](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_RestoreObject_section.html) dans le manuel *Amazon S3 API* Reference.
### Utilisation des opérations par lot S3
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 lots S3 une liste d’objets sur lesquels effectuer des opérations. La fonctionnalité des opérations par lot S3 appelle l’opération d’API respective pour effectuer l’opération spécifiée. Une seule 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 de plus amples informations, veuillez consulter [Spécification d’un manifeste](batch-ops-create-job.md#specify-batchjob-manifest).
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](batch-ops-iam-role-policies.md).
**Note**
Les tâches Batch Operations peuvent fonctionner soit sur des objets de classe de stockage S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive, *soit* sur des objets de niveau de stockage S3 Intelligent-Tiering Archive Access et Deep Archive Access. Les opérations par lot ne peuvent pas fonctionner sur les deux types d’objets archivés dans la même tâche. Pour restaurer des objets des deux types, vous *devez* créer des tâches Batch Operations.
Pour plus d’informations sur l’utilisation des opérations par lot pour restaurer des objets archivés, consultez [Restauration d’objets à l’aide d’opérations par lot](batch-ops-initiate-restore-object.md).
**Pour créer une tâche d’opérations par lot Lancer une restauration d’objet S3**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez **Opérations par lot**.
1. Choisissez **Créer une tâche**.
1. Pour **Région AWS**, choisissez la Région dans laquelle vous souhaitez créer votre tâche.
1. Sous **Format du manifeste**, choisissez le type de manifeste à utiliser.
+ Si vous choisissez le **rapport d'inventaire S3**, entrez le chemin d'accès à l'`manifest.json`objet généré par Amazon S3 dans le cadre du rapport d' CSV-formatted inventaire. Si vous souhaitez utiliser une version de manifeste autre que la plus récente, saisissez l’ID de version de l’objet `manifest.json`.
+ Si vous choisissez **CSV**, entrez le chemin d'accès à un objet CSV-formatted manifeste. L’objet manifeste doit respecter le format décrit dans la console. Si vous souhaitez utiliser une version autre que la plus récente, vous pouvez éventuellement inclure l’ID de version de l’objet manifeste.
1. Choisissez **Suivant**.
1. Dans la section **Opération**, choisissez **Restaurer**.
1. Dans la section **Restaurer**, pour **Restaurer la source**, choisissez soit le niveau **Glacier Flexible Retrieval, soit le niveau Glacier Deep Archive**, soit le **niveau Intelligent-Tiering Archive Access ou le niveau Deep Archive Access**.
Si vous avez choisi **Glacier Flexible Retrieval ou Glacier Deep Archive**, entrez un nombre pour **Nombre de jours pendant lesquels la copie restaurée est disponible**.
Pour **Niveau d’extraction**, choisissez le niveau que vous souhaitez utiliser.
1. Choisissez **Suivant**.
1.
Sur la page **Configurer des options supplémentaires**, remplissez les sections suivantes :
+ Dans la section **Options supplémentaires**, fournissez une description de la tâche et spécifiez un numéro de priorité pour la tâche. Un nombre plus élevé indique une priorité plus élevée. Pour de plus amples informations, veuillez consulter [Affectation d’une priorité de tâche](batch-ops-job-priority.md).
+ Dans la section **Rapport d’achèvement**, sélectionnez si les opérations par lot doivent créer un rapport d’achèvement. Pour plus d’informations sur les rapports d’achèvement, consultez [Rapports de fin de tâche](batch-ops-job-status.md#batch-ops-completion-report).
+ Dans la section **Autorisations**, vous devez accorder des autorisations à Amazon S3 pour effectuer des opérations par lot en votre nom. Pour les autorisations requises, consultez [Octroi d’autorisations pour Batch Operations](batch-ops-iam-role-policies.md).
+ (Facultatif) Dans la section **Balises de tâche**, ajoutez des balises dans les paires clé-valeur. Pour de plus amples informations, veuillez consulter [Contrôle de l’accès et étiquetage des tâches à l’aide d’étiquettes](batch-ops-job-tags.md).
Lorsque vous avez terminé, choisissez **Suivant**.
1. Sur la page **Vérification**, vérifiez les paramètres. Si vous devez apporter des modifications, choisissez **Précédent**. Sinon, choisissez **Créer une tâche**.
Pour plus d’informations sur les opérations par lot, consultez [Restauration d’objets à l’aide d’opérations par lot](batch-ops-initiate-restore-object.md) et [Création d’une tâche d’opérations par lot S3](batch-ops-create-job.md).
## Vérification du statut et de la date d’expiration de la restauration
Vous pouvez vérifier l'état d'une demande de restauration ou sa date d'expiration à l'aide de la console Amazon S3, des notifications d'événements Amazon S3, de l' AWS CLI API REST Amazon S3 ou de l'API REST Amazon S3.
**Note**
Les objets restaurés à partir des classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive sont stockés uniquement pendant le nombre de jours que vous spécifiez. Les procédures suivantes renvoient la date d’expiration de ces copies.
Les objets restaurés à partir des niveaux de stockage S3 Intelligent-Tiering Archive Access et Deep Archive Access n'ont pas de date d'expiration et sont replacés dans le niveau Frequent Access.
### Utilisation de la console S3
**Pour vérifier le statut de la restauration et la date d’expiration d’un objet dans la console Amazon S3**
1. Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez **Compartiments à usage général**.
1. Dans la liste de compartiments, choisissez le nom du compartiment qui contient l’objet que vous restaurez.
1. Dans la liste **Objets**, sélectionnez l’objet que vous êtes en train de restaurer. La page de détails de l’objet s’affiche.
+ Si la restauration n’est pas terminée, en haut de la page, vous voyez une section qui stipule **Restauration en cours**.
+ Si la restauration est terminée, en haut de la page, vous voyez une section qui stipule **Restauration terminée**. Si vous effectuez une restauration depuis S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, cette section affiche également la **Date d’expiration de la restauration**. Amazon S3 supprimera à cette date la copie restaurée de votre objet archivé.
### Utilisation des notifications d’événements Amazon S3
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, Amazon SNS](how-to-enable-disable-notification-intro.md) et. 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](notification-how-to-event-types-and-destinations.md#supported-notification-event-types).
### Utilisation de AWS CLI
**Vérifiez l'état de restauration et la date d'expiration d'un objet à l'aide du 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 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html) dans la *Référence des commandes de l’AWS CLI *.
### Utilisation de l'API REST
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 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html) dans la *Référence de l’API Amazon Simple Storage Service*.
## Mise à niveau de la vitesse d’une restauration en cours
Vous pouvez mettre à niveau la vitesse de la restauration pendant que cette dernière est en cours.
**Pour mettre à niveau une restauration en cours vers un niveau plus rapide**
1. Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le panneau de navigation de gauche, choisissez **Compartiments**.
1. Dans la liste **Compartiments**, choisissez le nom du compartiment qui contient les objets que vous souhaitez restaurer.
1. Dans la liste **Objets**, sélectionnez l'objet que vous êtes en train de restaurer. La page de détails de l’objet s’affiche. Sur la page de détails de l’objet, choisissez **Mettre à niveau le niveau d’extraction**. Pour de plus amples informations sur la vérification du statut de restauration d’un objet, consultez [Vérification du statut et de la date d’expiration de la restauration](#restore-archived-objects-status).
1. Choisissez le niveau auquel vous souhaitez passer, puis choisissez **Commencer la restauration**.