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

Description

Cette opération exécute les types de requêtes suivants :

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 et à la gestion des autorisations d'accès à vos ressources Amazon S3 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

Interroger les archives à l'aide de requêtes sélectionnées

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 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

Lorsque vous faites une demande de sélection, procédez comme suit :

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 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 :

Voici d'autres informations importantes concernant la fonction de sélection :

Restauration des archives

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 :

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 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 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-restoreen-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 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 la section Gestion du cycle de vie des objets dans le guide de l'utilisateur d'Amazon Simple Storage Service.

Requêtes

Syntaxe

POST /ObjectName?restore&versionId=VersionID HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Authorization: authorization string (see Demandes d'authentification (AWS Signature (version 4))
Content-MD5: MD5

 request body 
 

Paramètres de demande

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

En-têtes de demande

Elements de la demande

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.

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.

Réponses

Une opération réussie renvoie le code 200 OK d'202 Acceptedétat ou.

En-têtes de réponse

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 communs.

Éléments de réponse

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

Erreurs spéciales

Exemples

Restaurez un objet pendant deux jours à l'aide de l'option de récupération accélérée

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

POST /photo1.jpg?restore HTTP/1.1
Host: examplebucket.s3.amazonaws.com
Date: Mon, 22 Oct 2012 01:49:52 GMT
Authorization: authorization string
Content-Length: content length

<RestoreRequest>
  <Days>2</Days>
  <GlacierJobParameters>
    <Tier>Expedited</Tier>
  </GlacierJobParameters>
</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

Voici un exemple de demande de restauration sélective.

POST /object-one.csv?restore HTTP/1.1
Host: examplebucket.s3.amazonaws.com
Date: Date: Sat, 20 Oct 2012 23:54:05 GMT
Authorization: authorization string
Content-Length: content length

<RestoreRequest xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Type>SELECT</Type>
  <Tier>Expedited</Tier>
  <Description>this is a description</Description>
  <SelectParameters>
    <InputSerialization>
      <CSV>
        <FileHeaderInfo>IGNORE</FileHeaderInfo>
        <Comments>#</Comments>
        <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
        <RecordDelimiter>\n</RecordDelimiter>
        <FieldDelimiter>,</FieldDelimiter>
        <QuoteCharacter>"</QuoteCharacter>
      </CSV>
    </InputSerialization>
    <ExpressionType>SQL</ExpressionType>
    <Expression>select * from object</Expression>
    <OutputSerialization>
      <CSV>
        <QuoteFields>ALWAYS</QuoteFields>
        <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
        <RecordDelimiter>\n</RecordDelimiter>
        <FieldDelimiter>\t</FieldDelimiter>
        <QuoteCharacter>\'</QuoteCharacter>
      </CSV>
    </OutputSerialization>
  </SelectParameters>
  <OutputLocation>
    <S3>
      <BucketName>example-output-bucket</BucketName>
      <Prefix>test-s3</Prefix>
      <AccessControlList>
        <Grant>
          <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="AmazonCustomerByEmail">
            <EmailAddress>jane-doe@example.com</EmailAddress>
          </Grantee>
          <Permission>FULL_CONTROL</Permission>
        </Grant>
      </AccessControlList>
      <UserMetadata>
        <MetadataEntry>
          <Name>test</Name>
          <Value>test-value</Value>
        </MetadataEntry>
        <MetadataEntry>
          <Name>other</Name>
          <Value>something else</Value>
        </MetadataEntry>
      </UserMetadata>
      <StorageClass>STANDARD</StorageClass>
    </S3>
  </OutputLocation>
</RestoreRequest>

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
x-amz-restore-output-path: js-test-s3/qE8nk5M0XIj-LuZE2HXNw6empQm3znLkHlMWInRYPS-Orl2W0uj6LyYm-neTvm1-btz3wbBxfMhPykd3jkl-lvZE7w42/
Date: Sat, 20 Oct 2012 23:54:05 GMT
Content-Length: 0
Server: AmazonS3

Plus d'informations