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. # Utilisation des objets archivés Pour réduire vos coûts de stockage pour les objets rarement consultés, vous pouvez *archiver* ces objets. Lorsque vous archivez un objet, il est placé dans un espace de stockage à faible coût, ce qui signifie que vous ne pouvez pas y accéder en temps réel. Bien que les objets archivés ne soient pas accessibles en temps réel, vous pouvez les restaurer en quelques minutes ou quelques heures, selon la classe de stockage. Vous pouvez restaurer un objet archivé à l'aide de la console Amazon S3, de S3 Batch Operations, de l'API REST AWS SDKs, du et du AWS Command Line Interface (AWS CLI). Pour obtenir des instructions, veuillez consulter [Restauration d’un objet archivé](restoring-objects.md). 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 + Niveau Accès aux archives S3 Intelligent-Tiering. + Niveau d’accès Deep Archive de S3 Intelligent-Tiering Pour restaurer les objets archivés, vous devez effectuer les opérations suivantes : + Pour les objets des classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, vous devez d’abord lancer une demande de restauration, puis attendre qu’une copie temporaire de l’objet soit disponible. Lorsqu’une copie temporaire de l’objet restauré est créée, la classe de stockage de l’objet reste la même. (Une demande d’opération d’API [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html) ou [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html) renvoie S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive en tant que classe de stockage.) + Pour les objets appartenant aux niveaux d’accès Archive S3 Intelligent-Tiering et Deep Archive S3 Intelligent-Tiering, vous devez lancer la demande de restauration et attendre que l’objet soit déplacé dans le niveau d’accès Frequent. Pour en savoir plus sur la comparaison de toutes les classes de stockage Amazon S3, consultez [Bien comprendre et gérer les classes de stockage Amazon S3](storage-class-intro.md). Pour plus d’informations sur S3 Intelligent-Tiering, consultez [Fonctionnement de S3 Intelligent-Tiering](intelligent-tiering-overview.md). Le temps nécessaire à l’exécution d’une tâche de restauration dépend de la classe de stockage d’archive ou du niveau de stockage que vous utilisez et de l’option de récupération que vous spécifiez : Expédié (uniquement disponible pour S3 Glacier Flexible Retrieval et le niveau Archive Access de S3 Intelligent-Tiering), Standard ou En bloc. Pour de plus amples informations, veuillez consulter [Présentation des options de récupération d’archives](restoring-objects-retrieval-options.md). Vous pouvez être averti à l’issue de la restauration grâce aux notifications d’événements Amazon S3. Pour de plus amples informations, veuillez consulter [Notifications d'événements Amazon S3](EventNotifications.md). ## Restauration d’objets depuis Amazon Glacier Lorsque vous utilisez S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, Amazon S3 restaure une copie temporaire de l’objet uniquement pour la durée spécifiée. Une fois ce temps écoulé, il supprime la copie de l’objet restaurée. Vous pouvez modifier la période d’expiration d’une copie restaurée en réémettant une demande de restauration. Dans ce cas, Amazon S3 met à jour la période d’expiration relative à l’heure actuelle. **Note** Lorsque vous restaurez un objet archivé depuis S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, vous payez à la fois pour l’objet archivé et pour la copie que vous avez restaurée temporairement. Pour obtenir des informations sur la tarification, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/). Amazon S3 calcule le délai d’expiration de la copie d’objet restaurée en ajoutant le nombre de jours spécifié dans la demande de restauration au moment où la restauration demandée est terminée. Amazon S3 arrondit ensuite la date et l’heure obtenues au jour suivant à minuit heure UTC (Universal Coordinated Time). Par exemple, supposons qu’une copie d’objet restaurée a été créée le 15 octobre 2012 à 10h30 UTC et que la période de restauration a été spécifiée comme étant de trois jours. Dans ce cas, la copie restaurée expire le 19 octobre 2012 à minuit heure UTC, moment auquel Amazon S3 supprime la copie de l’objet. ## Restauration des objets depuis S3 Intelligent-Tiering Lorsque vous restaurez un objet à partir du niveau Archive Access de S3 Intelligent-Tiering ou du niveau Deep Archive Access de S3 Intelligent-Tiering, l’objet revient au niveau d’accès fréquent de S3 Intelligent-Tiering. Si vous n’accédez pas à l’objet dans 30 jours consécutifs, il est automatiquement déplacé vers le niveau Accès peu fréquent. Après un minimum de 90 jours consécutifs sans accès, l’objet passe au niveau Accès aux archives S3 Intelligent-Tiering. Si vous n’accédez pas à l’objet pendant un minimum de 180 jours consécutifs, il passe au niveau Accès Deep Archive. **Note** Contrairement aux classes de stockage S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive, les demandes de restauration pour les objets S3 Intelligent-Tiering n’acceptent pas la valeur `Days`. ## Utilisation des opérations par lots S3 avec les demandes de restauration Pour restaurer plusieurs objets Amazon S3 avec une seule demande, vous pouvez utiliser la fonctionnalité d’opérations par lots 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. **Topics** + [Restauration d’objets depuis Amazon Glacier](#archived-objects-glacier) + [Restauration des objets depuis S3 Intelligent-Tiering](#archived-objects-int) + [Utilisation des opérations par lots S3 avec les demandes de restauration](#using-batch-ops-with-restore-requests) + [Présentation des options de récupération d’archives](restoring-objects-retrieval-options.md) + [Restauration d’un objet archivé](restoring-objects.md) # Présentation des options de récupération d’archives Amazon S3 propose trois classes de stockage d'archivage : S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Bien que les objets stockés dans la classe de stockage S3 Glacier Instant Retrieval soient immédiatement disponibles en utilisant`GET`, pour accéder aux données stockées dans les classes de stockage S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, vous devez d'abord récupérer les données à l'aide de l'API [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html)REST. La restauration d'ensembles de données composés de dizaines de millions d'objets ou de centaines de téraoctets de données peut prendre plus de temps que les temps de restauration habituels et nécessite des considérations particulières. Pour de plus amples informations, veuillez consulter [Restauration de grands ensembles de données](#restoring-objects-large-datasets). Vous pouvez choisir parmi trois options d'accès à la récupération pour restaurer vos objets archivés en fonction de la vitesse de récupération souhaitée : accélérée, standard et en bloc. + **Récupération accélérée** — Accédez rapidement à vos données stockées dans la classe de stockage S3 Glacier Flexible Retrieval ou dans le niveau S3 Intelligent-Tiering Archive Access. Vous pouvez utiliser cette option pour des demandes urgentes occasionnelles portant sur des centaines d'objets au maximum. Les objets de moins de 250 mégaoctets sont généralement mis à disposition en 1 à 5 minutes, et les objets de 250 mégaoctets ou plus sont généralement récupérés avec un débit de récupération allant jusqu'à 300 mégaoctets par seconde. En outre, vous avez la possibilité d'acheter de la capacité provisionnée pour des extractions accélérées. La capacité provisionnée permet de garantir que la capacité de récupération accélérée est disponible lorsque vous en avez besoin. Pour de plus amples informations, veuillez consulter [Capacité provisionnée](#restoring-objects-expedited-capacity). **Note** Les récupérations accélérées sont une fonctionnalité premium et sont facturées au tarif des demandes et des récupérations accélérées. Pour obtenir des informations sur la tarification Amazon S3, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/). + **Récupération standard** : accédez à vos données en quelques heures. L'option Standard est l'option par défaut pour les demandes qui ne spécifient pas l'option de récupération. Les extractions standard se terminent généralement dans les 3 à 5 heures pour la classe de stockage S3 Glacier Flexible Retrieval ou le niveau S3 Intelligent-Tiering Archive Access. Les extractions standard se terminent généralement dans les 12 heures pour la classe de stockage S3 Glacier Deep Archive ou le niveau S3 Intelligent-Tiering Deep Archive Access. Les extractions standard sont gratuites pour les objets stockés dans la classe de stockage S3 Intelligent-Tiering. **Note** Pour les objets stockés dans la classe de stockage S3 Glacier Flexible Retrieval ou dans le niveau S3 Intelligent-Tiering Archive Access, les extractions standard initiées à l'aide de l'opération de restauration S3 Batch Operations commencent généralement en quelques minutes et se terminent en 3 à 5 heures à un débit allant jusqu'à 1 à 2 pétaoctets par jour. Pour les objets appartenant à la classe de stockage S3 Glacier Deep Archive ou au niveau S3 Intelligent-Tiering Deep Archive Access, les extractions standard initiées à l'aide des opérations par lots commencent généralement à se terminer en 9 heures à un débit allant jusqu'à 1 à 2 pétaoctets par jour. + **Extraction en masse** : accédez à vos données en utilisant l'option de récupération la moins coûteuse des classes de stockage S3 Glacier. Avec les extractions groupées, vous pouvez récupérer de grandes quantités de données à peu de frais. Pour les objets stockés dans la classe de stockage S3 Glacier Flexible Retrieval ou dans le niveau S3 Intelligent-Tiering Archive Access, les extractions groupées se terminent généralement dans un délai de 5 à 12 heures. Pour les objets stockés dans la classe de stockage S3 Glacier Deep Archive ou au niveau Deep Archive Access de S3 Intelligent-Tiering, les récupérations se terminent généralement dans les 48 heures. Les récupérations en bloc sont gratuites pour les objets stockés dans les classes de stockage S3 Glacier Flexible Retrieval ou S3 Intelligent-Tiering. Le tableau suivant récapitule les options de récupération d’archive. Pour obtenir des informations sur la tarification, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/). | Classe ou niveau de stockage | Accéléré | Standard (avec opérations par lot) | Standard (sans opérations par lot) | En bloc | | --- | --- | --- | --- | --- | | S3 Glacier Flexible Retrieval ou accès Archive de S3 Intelligent-Tiering | 1 à 5 minutes | Quelques minutes jusqu’à 5 heures | 3 à 5 heures | 5 à 12 heures | | Accès aux archives S3 Glacier Deep Archive ou S3 Intelligent-Tiering Deep (hiérarchisation intelligente profonde) | Non disponible | 9-12 heures | Dans les 12 heures | Dans les 48 heures | Pour effectuer une ou une `Bulk` extraction `Expedited``Standard`, définissez l'élément de requête dans la `Tier` demande d'opération de l'[https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html)API REST sur l'option que vous souhaitez, ou sur l'équivalent dans le AWS Command Line Interface (AWS CLI) ou AWS SDKs. Si vous avez acheté une capacité provisionnée, toutes les récupérations rapides de type Expedited sont automatiquement transmises par le biais de votre capacité provisionnée. ## Restauration de grands ensembles de données La restauration d'ensembles de données composés de dizaines de millions d'objets ou de centaines de téraoctets de données peut prendre plus de temps que les délais de restauration habituels, quel que soit le niveau de récupération, en raison des limites de récupération. Lorsque vous lancez des demandes de restauration pour des objets stockés dans les classes de stockage S3 Glacier Flexible Retrieval, S3 Glacier Deep Archive ou S3 Intelligent-Tiering, un quota de demandes de récupération est appliqué à votre. Compte AWS S3 Glacier prend en charge les demandes de restauration à un débit allant jusqu’à 1 000 transactions par seconde. Si ce taux est dépassé, des demandes valides sont limitées ou rejetées et Amazon S3 renvoie une erreur `ThrottlingException`. Vous pouvez utiliser S3 Batch Operations pour récupérer de nombreux objets en une seule demande, ce qui utilise pleinement le taux de demandes de restauration disponible dans votre compte. Pour de plus amples informations, veuillez consulter [Exécution d’opérations groupées sur des objets avec Batch Operations](batch-ops.md). Une fois que vous avez lancé des demandes de restauration, S3 Glacier prend en charge la restauration de grands ensembles de données à un débit allant jusqu'à 1 à 2 pétaoctets par jour et par compte client. Quelle que soit l'option de récupération, les objets de plus de 5 téraoctets mettront plus de temps à être restaurés, avec un débit de récupération pouvant atteindre 300 mégaoctets par seconde. Par exemple, la réalisation d'un objet S3 Glacier Flexible Retrieval de 50 téraoctets peut prendre jusqu'à 48 heures. Si vous avez besoin de limites de restauration accrues, vous pouvez contacter le AWS Support. ## Capacité provisionnée La capacité provisionnée aide à garantir que votre capacité de récupération pour les récupérations accélérées depuis S3 Glacier Flexible Retrieval est disponible lorsque vous en avez besoin. Chaque unité de capacité permet d'effectuer au moins trois extractions accélérées toutes les 5 minutes, et fournit un débit de récupération allant jusqu'à 300 mégaoctets par seconde. Sans capacité provisionnée, les récupérations accélérées peuvent ne pas être acceptées lors de périodes de demandes élevées. Pour un accès rapide et prévisible à un plus grand nombre de vos données, pensez à utiliser la classe de stockage [S3 Glacier Instant Retrieval](https://aws.amazon.com/s3/storage-classes/glacier/instant-retrieval/). Les unités de capacité allouées sont allouées à un Compte AWS. Ainsi, le demandeur de la récupération accélérée des données doit acheter l’unité de capacité provisionnée, et non pas le propriétaire du compartiment. Vous pouvez acheter de la capacité provisionnée à l'aide de la console Amazon S3, de la console Amazon Glacier, de l'opération d'API REST [Purchase Provisioned Capacity](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-PurchaseProvisionedCapacity.html) AWS SDKs, du ou du. AWS CLI Pour de plus amples informations sur la tarification de la capacité provisionnée, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/). # 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 + Niveau Accès aux archives S3 Intelligent-Tiering. + Niveau d’accès Deep Archive de S3 Intelligent-Tiering 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 l'API AWS Command Line Interface (AWS CLI) AWS SDKs, l'API 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 dans les niveaux Archive Access et Deep Archive Access de S3 Intelligent-Tiering, vous devez lancer une demande de restauration, puis attendre que l’objet soit placé au niveau d’accès fréquent. 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 à partir de S3 Intelligent-Tiering, aucun frais de récupération n’est facturé pour les récupérations standard ou en bloc. 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 SDKs, des opérations par lots, the AWS Command Line Interface (AWS CLI) ou S3 Batch. ### 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 aux niveaux de stockage Archive Access ou Deep Archive Access de S3 Intelligent-Tiering. **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 **Récupération accélérée** (disponible uniquement pour S3 Glacier Flexible Retrieval ou l’accès Archive de S3 Intelligent-Tiering). 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 Archive Access et Deep Archive Access de S3 Intelligent-Tiering sont restaurés automatiquement au niveau d’accès fréquent. 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 de capacité provisionnée, mais que vous souhaitez acheter des unités de capacité provisionnées (PCUs), choisissez Acheter. PCUs** Dans la boîte PCUs de dialogue **d'achat**, choisissez le nombre que PCUs vous souhaitez acheter, confirmez votre achat, puis choisissez **Acheter PCUs**. Lorsque le message **Réussite de l’achat** s’affiche, choisissez **Commencer la restauration** pour démarrer la récupération provisionnée. ### À l'aide du 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"} ``` **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 '{}' ``` **Note** Contrairement aux classes de stockage S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive, les demandes de restauration pour les objets S3 Intelligent-Tiering n’acceptent pas la valeur `Days`. **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*. ### À l'aide du AWS SDKs 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](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 d’opérations par lot peuvent fonctionner sur les objets de classe de stockage S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive, *ou* sur les objets des niveaux de stockage Archive Access et Deep Archive Access de S3 Intelligent-Tiering. 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 **Rapport d’inventaire S3**, entrez le chemin d’accès de l’objet `manifest.json` généré par Amazon S3 dans le cadre du rapport d’inventaire au format CSV. 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 vers un objet manifeste au format CSV. 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 **Glacier Flexible Retrieval ou Glacier Deep Archive** ou **Niveau Archive Access ou Deep Archive Access d’Intelligent-Tiering**. 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 Archive Access ou Deep Archive Access de S3 Intelligent-Tiering n’ont pas de date d’expiration et sont renvoyés au niveau d’accès fréquent. ### 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). ### À l'aide du 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**.