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.

# POST Object restore
<a name="RESTObjectPOSTrestore"></a>

## Description
<a name="RESTObjectPOSTrestore-description"></a>

Cette opération exécute les types de requêtes suivants : 
+ `select`— Effectue une requête de sélection sur un objet archivé
+ `restore an archive`— Restaurer un objet archivé

Pour utiliser cette opération, vous devez disposer des autorisations nécessaires pour effectuer les `s3:GetObject` actions `s3:RestoreObject` et. Le propriétaire du bucket dispose de cette autorisation par défaut et peut accorder cette autorisation à d'autres personnes. Pour plus d'informations sur les autorisations, consultez [ les sections Autorisations liées aux opérations des sous-ressources du bucket ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources) et à [ la gestion des autorisations d'accès à vos ressources Amazon S3 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) dans le guide * de l'utilisateur d'*Amazon Simple Storage Service.

## Interroger les archives à l'aide de requêtes sélectionnées
<a name="RESTObjectPOSTrestore-select-request"></a>

Vous utilisez un type de requête sélectionné pour exécuter des requêtes SQL sur des objets archivés. Les objets archivés qui sont interrogés par la demande de sélection doivent être mis en forme sous forme de fichiers de valeurs séparées par des virgules (CSV) non compressés. Vous pouvez exécuter des requêtes et des analyses personnalisées sur vos données archivées sans avoir à restaurer vos données vers un niveau Amazon S3 plus avancé. Pour obtenir un aperçu de certaines demandes, consultez la section [ Interroger des objets archivés ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/querying-glacier-archives.html) dans le guide * de l'utilisateur d'*Amazon Simple Storage Service.

Lorsque vous faites une demande de sélection, procédez comme suit :
+ Définissez un emplacement de sortie pour la sortie de la requête sélectionnée. Il doit s'agir d'un compartiment Amazon S3 dans le même Région AWS compartiment que celui qui contient l'objet d'archive interrogé. La Compte AWS personne qui lance la tâche doit être autorisée à écrire dans le compartiment S3. Vous pouvez spécifier la classe de stockage et le chiffrement des objets de sortie stockés dans le bucket. Pour plus d'informations sur la sortie, consultez la section [ Interroger des objets archivés ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/querying-glacier-archives.html) dans le guide * de l'utilisateur d'*Amazon Simple Storage Service.

  Pour plus d'informations sur la `S3` structure du corps de la requête, consultez les rubriques suivantes :
  + [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
  + [Gestion de l'accès à l'aide de listes de contrôle d'accès ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3_ACLs_UsingACLs.html) dans le * guide de l'utilisateur d'Amazon Simple Storage Service *
  + [Protection des données à l'aide du Server-Side chiffrement ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service *
+ Définissez l'expression SQL pour le `SELECT` type de restauration de votre requête dans la `SelectParameters` structure du corps de la requête. Vous pouvez utiliser des expressions comme dans les exemples suivants.
  + L'expression suivante renvoie tous les enregistrements de l'objet spécifié.

    ```
    SELECT * FROM Object
    ```
  + En supposant que vous n'utilisez aucun en-tête pour les données stockées dans l'objet, vous pouvez spécifier des colonnes avec des en-têtes positionnels.

    ```
    SELECT s._1, s._2 FROM Object s WHERE s._3 > 100
    ```
  + Si vous avez des en-têtes et que vous les définissez `fileHeaderInfo` dans la `CSV` structure du corps de la demande sur`USE`, vous pouvez spécifier des en-têtes dans la requête. (Si vous définissez le champ `fileHeaderInfo` sur `IGNORE`, la première ligne est ignorée pour la requête.) Vous ne pouvez pas combiner les positions ordinales avec des noms de colonnes d'en-têtes. 

    ```
    SELECT s.Id, s.FirstName, s.SSN FROM S3Object s
    ```

Pour plus d'informations sur l'utilisation de SQL avec la restauration d'Amazon Glacier Select, consultez la référence [ SQL pour Amazon S3 Select et Amazon Glacier Select ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*. 

Lorsque vous faites une demande de sélection, vous pouvez également effectuer les opérations suivantes :
+ Pour accélérer vos requêtes, spécifiez le `Expedited` niveau. Pour plus d'informations sur les niveaux, consultez la section « Restauration des archives », plus loin dans cette rubrique.
+ Spécifiez des détails concernant le format de sérialisation des données de l'objet d'entrée interrogé et de la sérialisation des résultats de la requête. CSV-encoded 

Voici d'autres informations importantes concernant la fonction de sélection :
+ Les résultats en sortie sont de nouveaux objets Amazon S3. Contrairement aux extractions d'archives, elles sont stockées jusqu'à leur suppression explicite, manuellement ou dans le cadre d'une politique de cycle de vie.
+ Vous pouvez émettre plusieurs demandes de sélection pour le même objet Amazon S3. Amazon S3 ne dédupliquant pas les demandes, évitez donc d'émettre des demandes dupliquées.
+  Amazon S3 accepte une demande de sélection même si l'objet a déjà été restauré. Une demande de sélection ne renvoie pas de réponse d'erreur`409`.

## Restauration des archives
<a name="RESTObjectPOSTrestore-restore-request"></a>

Les objets des classes de stockage GLACIER et DEEP\_ARCHIVE sont archivés. Pour accéder à un objet archivé, vous devez d'abord lancer une demande de restauration. Cela permet de restaurer une copie temporaire de l'objet archivé. Dans une demande de restauration, vous spécifiez le nombre de jours pendant lesquels vous souhaitez que la copie restaurée existe. Après la période spécifiée, Amazon S3 supprime la copie temporaire mais l'objet reste archivé dans la classe de stockage GLACIER ou DEEP\_ARCHIVE à partir de laquelle l'objet a été restauré. 

Pour restaurer une version spécifique d'un objet, vous pouvez fournir un ID de version. Si vous ne fournissez pas d'ID de version, Amazon S3 restaure la version actuelle.

Le temps nécessaire pour terminer les tâches de restauration dépend de la classe de stockage à partir de laquelle l'objet est restauré et du niveau d'accès aux données que vous spécifiez. 

Lorsque vous restaurez un objet archivé (ou que vous utilisez une demande de sélection), vous pouvez spécifier l'une des options de niveau d'accès aux données suivantes dans l'`Tier`élément du corps de la demande : 
+ **`Expedited`**- Les extractions accélérées vous permettent d'accéder rapidement à vos données stockées dans la classe de stockage GLACIER lorsque des demandes urgentes occasionnelles concernant un sous-ensemble d'archives sont requises. Pour tous les objets archivés, à l'exception des objets les plus volumineux (250 Mo et plus), les données accessibles à l'aide des extractions accélérées sont généralement mises à disposition en 1 à 5 minutes. La capacité provisionnée garantit que la capacité des récupérations rapides est disponible lorsque vous en avez besoin. Les extractions accélérées et la capacité provisionnée ne sont pas disponibles pour la classe de stockage DEEP\_ARCHIVE.
+ **`Standard`**- Les récupérations Standard vous permettent d'accéder à vos objets archivés en quelques heures. Il s'agit de l'option par défaut pour les demandes de récupération GLACIER et DEEP\_ARCHIVE qui ne spécifient pas l'option de récupération. Les extractions standard sont généralement effectuées dans les 3 à 5 heures suivant la classe de stockage GLACIER et généralement dans les 12 heures suivant la classe de stockage DEEP\_ARCHIVE. 
+ **`Bulk`**- Les extractions en masse constituent l'option de récupération la moins coûteuse d'Amazon Glacier, vous permettant de récupérer de grandes quantités, voire des pétaoctets, de données à peu de frais en une journée. Les extractions en masse sont généralement effectuées dans les 5 à 12 heures suivant la classe de stockage GLACIER et généralement dans les 48 heures suivant la classe de stockage DEEP\_ARCHIVE.

Pour plus d'informations sur les options de récupération des archives et la capacité provisionnée pour l'accès aux `Expedited` données, consultez la section [ Restauration d'objets archivés ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service. * 

Vous pouvez utiliser la mise à niveau de la vitesse de restauration d'Amazon S3 pour accélérer la vitesse de restauration pendant qu'elle est en cours. Vous améliorez la vitesse d'une restauration en cours en émettant une autre demande de restauration pour le même objet, en définissant un nouvel élément de `Tier` demande. Au moment d'émettre une demande de mise à niveau du niveau de restauration, vous devez choisir un niveau plus rapide que celui utilisé par la restauration en cours. Vous ne devez modifier aucun autre paramètre comme l'élément de demande `Days`. Pour plus d'informations, consultez la section [ Améliorer la vitesse d'une In-Progress restauration ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html#restoring-objects-upgrade-tier.title.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*. 

Pour obtenir l'état de la restauration de l'objet, vous pouvez envoyer une `HEAD` demande. Les opérations renvoient l'`x-amz-restore`en-tête, qui fournit des informations sur l'état de restauration, dans la réponse. Vous pouvez utiliser les notifications d'événements Amazon S3 pour vous avertir lorsqu'une restauration est lancée ou terminée. Pour plus d'informations, consultez [ la section Configuration des notifications d'événements Amazon S3 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/NotificationHowTo.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*.

Après avoir restauré un objet archivé, vous pouvez mettre à jour la période de restauration en réémettant la demande avec une nouvelle période. Amazon S3 met à jour la période de restauration par rapport à l'heure actuelle et ne facture que pour la demande. Aucun frais de transfert de données n'est facturé. Vous ne pouvez pas mettre à jour la période de restauration lorsqu'Amazon S3 traite activement votre demande de restauration actuelle pour l'objet.

Si votre bucket possède une configuration de cycle de vie avec une règle qui inclut une action d'expiration, l'expiration de l'objet remplace la durée de vie que vous spécifiez dans une demande de restauration. Par exemple, si vous restaurez une copie d'objet pendant 10 jours, mais que l'objet doit expirer dans 3 jours, Amazon S3 supprime l'objet dans 3 jours. Pour plus d'informations sur la configuration du cycle de vie, consultez [ PutBucketLifecycleConfiguration ](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html) la section Gestion du cycle de vie des [ objets ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service*.

## Requêtes
<a name="RESTObjectPOSTrestore-requests"></a>

### Syntaxe
<a name="RESTObjectPOSTrestore-requests-syntax"></a>

```
1. POST /{{ObjectName}}?restore&versionId={{VersionID}} HTTP/1.1
2. Host: {{BucketName}}.s3.amazonaws.com
3. Date: {{date}}
4. Authorization: {{authorization string}} (see Demandes d'authentification (AWS Signature (version 4))
5. Content-MD5: {{MD5}}
6. 
7.  {{request body }}
```

**Note**  
La syntaxe affiche certains en-têtes de requête. Pour une liste complète, voir « En-têtes de demande », plus loin dans cette rubrique.

### Paramètres de demande
<a name="RESTObjectPOSTrestore-requests-request-parameters"></a>

Cette implémentation de l'opération n'utilise pas de paramètres de demande.

### En-têtes de demande
<a name="RESTObjectPOSTrestore-requests-request-headers"></a>


|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| Content-MD5 | Le condensé MD5 128 bits codé en base64 des données. Vous devez utiliser cet en-tête pour vérifier l'intégrité du message afin de vérifier que le corps de la demande n'a pas été endommagé pendant le transit. Pour plus d'informations, consultez la [ RFC 1864. ](http://www.ietf.org/rfc/rfc1864.txt)<br />Type : Chaîne <br />Par défaut : aucun | Oui  | 

### Elements de la demande
<a name="RESTObjectPOSTrestore-requests-request-elements"></a>

Voici un exemple XML de corps de requête pour la restauration d'une archive. 

```
<RestoreRequest>
   <Days>2</Days> 
   <GlacierJobParameters>
     <Tier>Bulk</Tier>
   </GlacierJobParameters> 
</RestoreRequest>
```

Le tableau suivant explique le code XML pour la restauration des archives dans le corps de la demande. 


|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| RestoreRequest | Conteneur pour les informations de restauration.<br />Type : Conteneur | Oui | 
| Days | Durée de vie de la copie restaurée (active). Le nombre minimum de jours pendant lesquels vous pouvez restaurer un objet depuis Amazon Glacier est de 1. Une fois que la copie de l'objet a atteint la durée de vie spécifiée, Amazon S3 la supprime du compartiment. Si vous restaurez une archive, cet élément est obligatoire. <br />N'utilisez pas cet élément avec un `SELECT` type de requête.<br />Type : entier positif<br />Ancêtres : `RestoreRequest` | Oui, si vous restaurez une archive | 
| GlacierJobParameters | Conteneur pour les paramètres de travail de la classe de stockage S3 Glacier.<br />N'utilisez pas cet élément avec un `SELECT` type de requête.<br />Type : Conteneur<br />Ancêtres : `RestoreRequest` | Non | 
| Tier | Le niveau d'accès aux données à utiliser lors de la restauration de l'archive. `Standard`est la valeur par défaut.<br />Type : énumération<br />Valeurs valides : `Expedited` \| `Standard` \| `Bulk`<br />Ancêtres : `GlacierJobParameters` | Non | 

Le code XML suivant constitue le corps de requête d'une requête de sélection sur un objet archivé : 

```
<RestoreRequest>
    <Type>SELECT</Type>
    <Tier>Expedited</Tier>
    <Description>Job description</Description>
    <SelectParameters>
          <Expression>Select * from Object</Expression>
          <ExpressionType>SQL</ExpressionType>
          <InputSerialization>
              <CSV>
                  <FileHeaderInfo>IGNORE</FileHeaderInfo>
                  <RecordDelimiter>\n</RecordDelimiter>
                  <FieldDelimiter>,</FieldDelimiter>
                  <QuoteCharacter>"</QuoteCharacter>
                  <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
                  <Comments>#</Comments>
              </CSV>
           </InputSerialization>
         <OutputSerialization>
             <CSV>
                 <QuoteFields>ASNEEDED</QuoteFields>
                 <RecordDelimiter>\n</RecordDelimiter>
                 <FieldDelimiter>,</FieldDelimiter>
                 <QuoteCharacter>"</QuoteCharacter>
                 <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
             </CSV>                                
         </OutputSerialization>
    </SelectParameters>
    <OutputLocation>
        <S3>
	     <BucketName>Name of bucket</BucketName>
            <Prefix>Key prefix</Prefix>
	      <CannedACL>Canned ACL string</CannedACL>
	      <AccessControlList>
		    <Grantee>
		        <Type>Grantee Type</Type>
			 <ID>Grantee identifier</ID>
			 <URI>Grantee URI</URI>
		       <Permission>Granted permission</Permission>
                    <DisplayNmae>Display Name</DisplayName>
                    <EmailAddress>email</EmailAddress>
		    </Grantee>
	      </AccessControlList>
	      <Encryption>
	            <EncryptionType>Encryption type</EncryptionType>
		     <KMSKeyId>KMS Key ID</KMSKeyId>
		     <KMSContext>Base64-encoded JSON<KMSContext>
            </Encryption>
	     <UserMetadata>
               <MetadataEntry>
                   <Name>Key</Name>
                   <Value>Value</Value>
               </MetadataEntry>
            </UserMetadata>
            <Tagging>
                <TagSet>
                    <Tag>
                        <Key>Tag name</Key>
                        <Value>Tag value</Value>
                    </Tag>
               </TagSet>
            </Tagging>
            <StorageClass>Storage class</StorageClass>
	 </S3>
    </OutputLocation>
</RestoreRequest>
```

Les tableaux suivants décrivent le code XML pour un `SELECT` type de restauration dans le corps de la demande. 


|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| RestoreRequest | Conteneur pour les informations de restauration.<br />Type : Conteneur | Oui | 
| Tier | Le niveau d'accès aux données à utiliser lors de la restauration de l'archive. `Standard`est la valeur par défaut.<br />Type : énumération<br />Valeurs valides : `Expedited` \| `Standard` \| `Bulk`<br />Ancêtres : `RestoreRequest` | Non | 
| Description | Description facultative de la demande.<br />Type : Chaîne<br />Ancêtres : `RestoreRequest` | Non | 
| SelectParameters | Décrit les paramètres de la demande de tâche sélectionnée.<br />Type : Conteneur<br />Ancêtres : `RestoreRequest` | Oui, si le type de demande est SELECT  | 
| OutputLocation | Décrit l'emplacement qui reçoit les résultats de la demande de restauration sélectionnée.<br />Type : Conteneur pour Amazon S3<br />Ancêtres : `RestoreRequest` | Oui, si le type de demande est SELECT  | 


**L'élément `SelectParameters` conteneur contient les éléments suivants.**  

|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| Expression | Expression SQL. Par exemple :+  L'expression SQL suivante extrait la première colonne des données de l'objet stocké au format CSV : <br />`SELECT s._1 FROM Object s` <br />+  L'expression SQL suivante renvoie tout ce qui provient de l'objet : <br />`SELECT * FROM Object` <br />Type : Chaîne<br />Ancêtres : `SelectParameters` | Oui | 
| ExpressionType | Identifie le type d'expression.<br />Type : Chaîne<br />Valeurs valides : `SQL`<br />Ancêtres : `SelectParameters` | Oui | 
| InputSerialization | Décrit le format de sérialisation de l'objet.<br />Type : Conteneur pour CSV<br />Ancêtres : `SelectParameters` | Oui | 
| OutputSerialization | Décrit la manière dont les résultats de la tâche de sélection sont sérialisés.<br />Type : Conteneur pour CSV<br />Ancêtres : `SelectParameters` | Oui | 


**L'élément conteneur CSV de l'`InputSerialization`élément contient les éléments suivants.**  

|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| RecordDelimiter | Caractère unique utilisé pour séparer les enregistrements individuels dans l'entrée. Au lieu de la valeur par défaut, vous pouvez spécifier un délimiteur arbitraire.<br />Type : Chaîne<br />Valeur par défaut : `\n`<br />Ancêtres : `CSV` | Non | 
| FieldDelimiter | Caractère unique utilisé pour séparer les différents champs d'un enregistrement. Vous pouvez spécifier un délimiteur arbitraire. <br />Type : Chaîne<br />Valeur par défaut : `,`<br />Ancêtres : `CSV` | Non | 
| QuoteCharacter | Caractère unique utilisé pour échapper lorsque le délimiteur de champ fait partie de la valeur.<br />Prenons cet exemple dans un fichier CSV : <br />`"a, b" `<br />Placer la valeur entre guillemets fait de cette valeur un champ unique. Si vous n'utilisez pas de guillemets, la virgule est un délimiteur de champ (ce qui en fait deux valeurs de champ distinctes, a et b).<br />Type : Chaîne<br />Valeur par défaut : `"`<br />Ancêtres : `CSV` | Non | 
| QuoteEscapeCharacter | Caractère unique utilisé pour échapper au guillemet à l'intérieur d'une valeur déjà échappée. Par exemple, la valeur `""" a , b """` est analysée comme`" a , b "`.<br />Type : Chaîne<br />Valeur par défaut : `"`<br />Ancêtres : `CSV` | Non | 
| FileHeaderInfo | Décrit la première ligne des données d'entrée. Il s'agit de l'une des valeurs ENUM.+  `NONE`: La première ligne n'est pas un en-tête. <br />+  `IGNORE`: La première ligne est un en-tête, mais vous ne pouvez pas utiliser les valeurs d'en-tête pour indiquer la colonne d'une expression. Vous pouvez utiliser la position de la colonne (telle que \_1, \_2,...) pour indiquer la colonne (`SELECT s._1 FROM OBJECT s`). <br />+  `Use`: La première ligne est un en-tête, et vous pouvez utiliser la valeur de l'en-tête pour identifier une colonne dans une expression (`SELECT "name" FROM OBJECT`).  <br />Type : énumération<br />Valeurs valides : `NONE \| USE \| IGNORE`<br />Ancêtres : `CSV` | Non | 
| Comments | Caractère nique utilisé pour indiquer qu'une ligne doit être ignorée lorsque le caractère est présent au début de cette ligne. Vous pouvez spécifier n'importe quel caractère pour indiquer une ligne de commentaire.<br />Type : Chaîne<br />Ancêtres : `CSV` | Non | 


**L'élément conteneur CSV (dans les `OutputSerialization` éléments) contient les éléments suivants.**  

|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| QuoteFields | Indique s'il faut utiliser des guillemets autour des champs de sortie. +  `ALWAYS`: utilisez toujours des guillemets pour les champs de sortie. <br />+  `ASNEEDED`: utilisez des guillemets pour les champs de sortie si nécessaire. <br />Type : énumération<br />Valeurs valides : `ALWAYS \| ASNEEDED`<br />Valeur par défaut : `AsNeeded`<br />Ancêtres : `CSV` | Non | 
| RecordDelimiter | Caractère unique utilisé pour séparer les enregistrements individuels dans la sortie. Au lieu de la valeur par défaut, vous pouvez spécifier un délimiteur arbitraire. <br />Type : Chaîne<br />Valeur par défaut : `\n`<br />Ancêtres : `CSV` | Non | 
| FieldDelimiter | Caractère unique utilisé pour séparer les différents champs d'un enregistrement. Vous pouvez spécifier un délimiteur arbitraire. <br />Type : Chaîne<br />Valeur par défaut : `,`<br />Ancêtres : `CSV` | Non | 
| QuoteCharacter | Caractère unique utilisé pour échapper lorsque le délimiteur de champ fait partie de la valeur. Par exemple, si la valeur est`a, b`, Amazon S3 met la valeur de ce champ entre guillemets, comme suit : `" a , b "`<br />Type : Chaîne<br />Valeur par défaut : `"`<br />Ancêtres : `CSV` | Non | 
| QuoteEscapeCharacter | Caractère unique utilisé pour échapper au guillemet à l'intérieur d'une valeur déjà échappée. Par exemple, si la valeur est`" a , b "`, Amazon S3 met la valeur entre guillemets, comme suit : `""" a , b """`<br />Type : Chaîne<br />Ancêtres : `CSV` | Non | 


**L'élément conteneur S3 (dans l'`OutputLocation`élément) contient les éléments suivants.**  

|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| AccessControlList | Liste des subventions qui contrôlent l'accès aux résultats par étapes. <br />Type : Conteneur pour subvention<br />Ancêtres : `S3` | Non | 
| BucketName | Nom du compartiment S3 dans lequel les résultats de la restauration sélectionnée sont stockés. Le compartiment doit se trouver dans le même compartiment Région AWS que celui qui contient l'objet d'archive en entrée.<br />Type : Chaîne<br />Ancêtres : `S3` | Oui | 
| CannedACL | La liste de contrôle d'accès (ACL) prédéfinie à appliquer aux résultats de restauration sélectionnés.<br />Type : Chaîne<br />Valeurs valides : ` private \| public-read \| public-read-write \| aws-exec-read \| authenticated-read \| bucket-owner-read \| bucket-owner-full-control`<br />Ancêtres : `S3` | Non | 
| Encryption | Contient des informations de chiffrement pour les résultats enregistrés.<br />Type : Conteneur pour chiffrement<br />Ancêtres : `S3` | Non | 
| Prefix | Le préfixe ajouté aux résultats de la restauration sélectionnée. La longueur maximale du préfixe est de 512 caractères.<br />Type : Chaîne<br />Ancêtres : `S3` | Oui | 
| StorageClass | Classe de stockage utilisée pour stocker les résultats de la demande de sélection.<br />Type : Chaîne<br />Valeurs valides : `STANDARD` \| `REDUCED_REDUNDANCY` \| `STANDARD_IA` \| `ONEZONE_IA` <br />Ancêtres : `S3 ` | Non | 
| Tagging | Conteneur pour les informations sur les étiquettes.<br />Type : Structure des balises<br />Ancêtres : `S3 ` | Non | 
| UserMetadata | Contient une liste de métadonnées à stocker avec les résultats de restauration sélectionnés.<br />Type : MetadataEntry structure<br />Ancêtres : `S3` | Non | 


**L'élément conteneur du bénéficiaire (dans l'`AccessControlList`élément) contient les éléments suivants.**  

|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| DisplayName | Nom de l'écran du bénéficiaire.<br />Type : Chaîne<br />Ancêtres : `Grantee` | Non | 
| EmailAddress | Adresse e-mail du bénéficiaire.<br />Type : Chaîne<br />Ancêtres : `Grantee` | Non | 
| ID | ID d'utilisateur canonique du bénéficiaire.<br />Type : Chaîne<br />Ancêtres : `Grantee` | Non | 
| Type | Type du bénéficiaire.<br />Type : Chaîne<br />Ancêtres : `Grantee` | Non | 
| URI | URI du groupe du bénéficiaire.<br />Type : Chaîne<br />Ancêtres : `Grantee` | Non | 
| Permission | Autorisation accordée.<br />Type : Chaîne<br />Ancêtres : `Grantee` | Non | 


**L'élément `Conteneur de` chiffrement (dans S3) contient les éléments suivants.**  

|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| EncryptionType | Algorithme de chiffrement côté serveur utilisé lors du stockage des résultats des tâches. La valeur par défaut est sans chiffrement.<br />Type : Chaîne<br />Valeurs valides `aws:kms \| AES256`<br />Ancêtres : `Encryption`  | Non | 
| KMSContext | Facultatif. Si le type de cryptage est`aws:kms`, vous pouvez utiliser cette valeur pour spécifier le contexte de chiffrement pour les résultats de restauration sélectionnés.<br />Type : Chaîne<br />Ancêtres : Encryption  | Non | 
| KMSKeyId | L'ID de clé AWS Key Management Service (AWS KMS) à utiliser pour le chiffrement des objets.<br />Type : Chaîne<br />Ancêtres : `Encryption`  | Non | 


**L'élément `TagSet` conteneur (dans l'`élément de` balisage) contient l'élément suivant.**  

|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| Tag | Contient des étiquettes.<br />Type : Conteneur<br />Ancêtres : `TagSet`  | Non | 


**L'élément conteneur Tag (dans l'`TagSet`élément) contient les éléments suivants.**  

|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| Key | Nom de la balise. <br />Type : Chaîne<br />Ancêtres : `Tag` | Non | 
| Value | Valeur de la balise.<br />Type : Chaîne<br />Ancêtres : `Tag` | Non | 


**L'élément `MetadataEntry` conteneur (dans l'`UserMetadata`élément) contient les éléments de paire clé-valeur suivants à stocker avec un objet.**  

|  Nom  |  Description  |  Obligatoire  | 
| --- | --- | --- | 
| MetadataKey | Clé de métadonnées.<br />Type : Chaîne<br />Ancêtres : `` | Non | 
| MetadataEntry | La valeur des métadonnées.<br />Type : Chaîne<br />Ancêtres : `` | Non | 

## Réponses
<a name="RESTObjectPOSTrestore-responses"></a>

Une opération réussie renvoie le code `200 OK` d'`202 Accepted`état ou. 
+ Si la copie de l'objet n'a pas été restaurée précédemment, Amazon S3 le renvoie `202 Accepted` dans la réponse. 
+ Si la copie de l'objet a déjà été restaurée, Amazon S3 renvoie `200 OK` la réponse. 

### En-têtes de réponse
<a name="RESTObjectPOSTrestore-responses-response-headers"></a>

Cette implémentation de l'opération utilise uniquement les en-têtes de réponse communs à la plupart des réponses. Pour plus d'informations, consultez la section En-têtes [ de réponse ](RESTCommonResponseHeaders.md) communs.

### Éléments de réponse
<a name="RESTObjectPOSTrestore-responses-response-elements"></a>

Cette opération ne renvoie pas d'éléments de réponse.

### Erreurs spéciales
<a name="RESTObjectPOSTrestore-responses-special-errors"></a>


| Code d’erreur | Description | HTTP Status Code | Préfixe du code d'erreur SOAP | 
| --- | --- | --- | --- | 
| RestoreAlreadyInProgress | La restauration des objets est déjà en cours. (Cette erreur ne s'applique pas aux demandes de type SELECT.) | 409 – Conflit | Client | 
| GlacierExpeditedRetrievalNotAvailable | Les récupérations accélérées de la classe de stockage S3 Glacier ne sont actuellement pas disponibles. Réessayez ultérieurement. (Renvoyé si la capacité est insuffisante pour traiter la Expedited demande. Cette erreur s'applique uniquement aux Expedited extractions et non aux Standard Bulk extractions.) | 503 | N/A | 

## Exemples
<a name="RESTObjectPOSTrestore-responses-examples"></a>

### Restaurez un objet pendant deux jours à l'aide de l'option de récupération accélérée
<a name="RESTObjectPOSTrestore-responses-examples-sample-request"></a>

La demande de restauration suivante restaure une copie de l'`photo1.jpg`objet depuis Amazon Glacier pendant une période de deux jours à l'aide de l'option de récupération accélérée.

```
 1. POST /photo1.jpg?restore HTTP/1.1
 2. Host: examplebucket.s3.amazonaws.com
 3. Date: Mon, 22 Oct 2012 01:49:52 GMT
 4. Authorization: {{authorization string}}
 5. Content-Length: {{content length}}
 6. 
 7. <RestoreRequest>
 8.   <Days>2</Days>
 9.   <GlacierJobParameters>
10.     <Tier>Expedited</Tier>
11.   </GlacierJobParameters>
12. </RestoreRequest>
```

Si `examplebucket` aucune copie restaurée de l'objet n'est disponible, Amazon S3 renvoie la `202 Accepted` réponse suivante. 

```
HTTP/1.1 202 Accepted
x-amz-id-2: GFihv3y6+kE7KG11GEkQhU7/2/cHR3Yb2fCb2S04nxI423Dqwg2XiQ0B/UZlzYQvPiBlZNRcovw=
x-amz-request-id: 9F341CD3C4BA79E0
Date: Sat, 20 Oct 2012 23:54:05 GMT
Content-Length: 0
Server: AmazonS3
```

Si une copie de l'objet est déjà restaurée, Amazon S3 renvoie une `200 OK` réponse et met à jour uniquement l'heure d'expiration de la copie restaurée.

### Interroger une archive à l'aide d'une requête SELECT
<a name="RESTObjectPOSTrestore-responses-examples-select-request"></a>

Voici un exemple de demande de restauration sélective.

```
 1. POST /object-one.csv?restore HTTP/1.1
 2. Host: examplebucket.s3.amazonaws.com
 3. Date: Date: Sat, 20 Oct 2012 23:54:05 GMT
 4. Authorization: {{authorization string}}
 5. Content-Length: {{content length}}
 6. 
 7. <RestoreRequest xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
 8.   <Type>SELECT</Type>
 9.   <Tier>Expedited</Tier>
10.   <Description>this is a description</Description>
11.   <SelectParameters>
12.     <InputSerialization>
13.       <CSV>
14.         <FileHeaderInfo>IGNORE</FileHeaderInfo>
15.         <Comments>#</Comments>
16.         <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
17.         <RecordDelimiter>\n</RecordDelimiter>
18.         <FieldDelimiter>,</FieldDelimiter>
19.         <QuoteCharacter>"</QuoteCharacter>
20.       </CSV>
21.     </InputSerialization>
22.     <ExpressionType>SQL</ExpressionType>
23.     <Expression>select * from object</Expression>
24.     <OutputSerialization>
25.       <CSV>
26.         <QuoteFields>ALWAYS</QuoteFields>
27.         <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
28.         <RecordDelimiter>\n</RecordDelimiter>
29.         <FieldDelimiter>\t</FieldDelimiter>
30.         <QuoteCharacter>\'</QuoteCharacter>
31.       </CSV>
32.     </OutputSerialization>
33.   </SelectParameters>
34.   <OutputLocation>
35.     <S3>
36.       <BucketName>example-output-bucket</BucketName>
37.       <Prefix>test-s3</Prefix>
38.       <AccessControlList>
39.         <Grant>
40.           <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="AmazonCustomerByEmail">
41.             <EmailAddress>jane-doe@example.com</EmailAddress>
42.           </Grantee>
43.           <Permission>FULL_CONTROL</Permission>
44.         </Grant>
45.       </AccessControlList>
46.       <UserMetadata>
47.         <MetadataEntry>
48.           <Name>test</Name>
49.           <Value>test-value</Value>
50.         </MetadataEntry>
51.         <MetadataEntry>
52.           <Name>other</Name>
53.           <Value>something else</Value>
54.         </MetadataEntry>
55.       </UserMetadata>
56.       <StorageClass>STANDARD</StorageClass>
57.     </S3>
58.   </OutputLocation>
59. </RestoreRequest>
```

 Amazon S3 renvoie la `202 Accepted` réponse suivante. 

```
1. HTTP/1.1 202 Accepted
2. x-amz-id-2: GFihv3y6+kE7KG11GEkQhU7/2/cHR3Yb2fCb2S04nxI423Dqwg2XiQ0B/UZlzYQvPiBlZNRcovw=
3. x-amz-request-id: 9F341CD3C4BA79E0
4. x-amz-restore-output-path: js-test-s3/qE8nk5M0XIj-LuZE2HXNw6empQm3znLkHlMWInRYPS-Orl2W0uj6LyYm-neTvm1-btz3wbBxfMhPykd3jkl-lvZE7w42/
5. Date: Sat, 20 Oct 2012 23:54:05 GMT
6. Content-Length: 0
7. Server: AmazonS3
```

## Plus d'informations
<a name="RESTObjectPOSTrestore-responses-related-resources-post-res"></a>
+  [GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html) 
+ [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
+ [Référence SQL pour Amazon S3 Select et Amazon Glacier Select ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference.html) dans le guide de l'utilisateur d'*Amazon Simple Storage Service *