Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

POST Object restore

Description

Questa operazione esegue i seguenti tipi di richieste:

Per utilizzare questa operazione, è necessario disporre delle autorizzazioni per eseguire le azioni s3:RestoreObject es3:GetObject. Il proprietario del bucket dispone di questa autorizzazione per impostazione predefinita e può concedere questa autorizzazione ad altri. Per ulteriori informazioni sulle autorizzazioni, consulta Autorizzazioni relative alle operazioni sulle subrisorse del bucket e Gestione delle autorizzazioni di accesso alle risorse Amazon S3 nella Guida per l'utente di Amazon Simple Storage Service.

Interrogazione degli archivi con Select Requests

Si utilizza un tipo di richiesta selezionato per eseguire interrogazioni SQL sugli oggetti archiviati. Gli oggetti archiviati interrogati dalla richiesta di selezione devono essere formattati come file CSV (valori separati da virgole) non compressi. Puoi eseguire query e analisi personalizzate sui dati archiviati senza doverli ripristinare su un livello Amazon S3 più caldo. Per una panoramica sulle richieste selezionate, consulta Querying Archived Objects nella Amazon Simple Storage Service User Guide.

Quando effettui una richiesta di selezione, procedi come segue:

Per ulteriori informazioni sull'utilizzo di SQL con Amazon Glacier Select restore, consulta SQL Reference for Amazon S3 Select e Amazon Glacier Select nella Amazon Simple Storage Service User Guide.

Quando effettui una richiesta di selezione, puoi anche fare quanto segue:

Di seguito sono riportati altri dati importanti sulla funzionalità di selezione:

Ripristino degli archivi

Gli oggetti nelle classi di archiviazione GLACIER e DEEP_ARCHIVE vengono archiviati. Per accedere a un oggetto archiviato, è necessario innanzitutto avviare una richiesta di ripristino. In questo modo viene ripristinata una copia temporanea dell'oggetto archiviato. In una richiesta di ripristino, si specifica il numero di giorni in cui si desidera che la copia ripristinata esista. Dopo il periodo specificato, Amazon S3 elimina la copia temporanea ma l'oggetto rimane archiviato nella classe di storage GLACIER o DEEP_ARCHIVE da cui è stato ripristinato l'oggetto.

Per ripristinare una versione specifica dell'oggetto, puoi fornire un ID di versione. Se non fornisci un ID di versione, Amazon S3 ripristina la versione corrente.

Il tempo necessario per completare i processi di ripristino dipende dalla classe di storage da cui viene ripristinato l'oggetto e dal livello di accesso ai dati specificato.

Quando si ripristina un oggetto archiviato (o si utilizza una richiesta di selezione), è possibile specificare una delle seguenti opzioni di livello di accesso ai dati nell'Tierelemento del corpo della richiesta:

Per ulteriori informazioni sulle opzioni di recupero degli archivi e sulla capacità assegnata per l'accesso ai Expedited dati, consulta Restoring Archived Objects nella Amazon Simple Storage Service User Guide.

Puoi utilizzare Amazon S3 Restore Speed Upgrade per modificare la velocità di ripristino a una velocità maggiore mentre è in corso. Puoi aumentare la velocità di un ripristino in corso inviando un'altra richiesta di ripristino sullo stesso oggetto, impostando un nuovo Tier elemento di richiesta. Quando si invia una richiesta di aggiornamento del livello di ripristino, è necessario scegliere un livello con velocità maggiore rispetto a quella del livello utilizzato dal ripristino in corso. Non devi cambiare gli altri parametri, ad esempio l'elemento della richiesta Days. Per ulteriori informazioni, consulta Upgrade the Speed of an In-Progress Restore nella Amazon Simple Storage Service User Guide.

Per conoscere lo stato del ripristino degli oggetti, puoi inviare una HEAD richiesta. Le operazioni restituiscono l'x-amz-restoreintestazione, che fornisce informazioni sullo stato del ripristino, nella risposta. Puoi utilizzare le notifiche di eventi di Amazon S3 per notificarti quando un ripristino viene avviato o completato. Per ulteriori informazioni, consulta Configurazione delle notifiche di eventi di Amazon S3 nella Guida per l'utente di Amazon Simple Storage Service.

Dopo aver ripristinato un oggetto archiviato, puoi aggiornare il periodo di ripristino riemettendo la richiesta con un nuovo periodo. Amazon S3 aggiorna il periodo di ripristino rispetto all'ora corrente e addebita solo la richiesta, senza costi di trasferimento dei dati. Non è possibile aggiornare il periodo di ripristino quando Amazon S3 sta elaborando attivamente la richiesta di ripristino corrente per l'oggetto.

Se il bucket ha una configurazione del ciclo di vita con una regola che include un'azione di scadenza, la scadenza dell'oggetto ha la precedenza sulla durata specificata in una richiesta di ripristino. Ad esempio, se ripristini una copia dell'oggetto per 10 giorni, ma la scadenza dell'oggetto è prevista tra 3 giorni, Amazon S3 elimina l'oggetto entro 3 giorni. Per ulteriori informazioni sulla configurazione del ciclo di vita, consulta la sezione Object Lifecycle Management nella PutBucketLifecycleConfiguration Amazon Simple Storage Service User Guide.

Richieste

Sintassi

POST /ObjectName?restore&versionId=VersionID HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Authorization: authorization string (see Autenticazione delle richieste (AWS Signature (versione 4))
Content-MD5: MD5

 request body 
 

Parametri della richiesta

Questa implementazione dell'operazione non utilizza parametri di richiesta.

Intestazioni di richiesta

Elementi della richiesta

Di seguito è riportato un esempio XML del corpo di una richiesta per il ripristino di un archivio.

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

La tabella seguente illustra il codice XML per il ripristino dell'archivio nel corpo della richiesta.

Il seguente codice XML è il corpo della richiesta per un'interrogazione di selezione su un oggetto archiviato:

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

Le tabelle seguenti spiegano il codice XML per un SELECT tipo di ripristino nel corpo della richiesta.

Risposte

Un'operazione riuscita restituisce il codice di 202 Accepted stato 200 OK o.

Intestazioni di risposta

Questa implementazione dell'operazione utilizza solo le intestazioni di risposta comuni alla maggior parte delle risposte. Per ulteriori informazioni, vedere Common Response Headers.

Elementi di risposta

Questa operazione non restituisce elementi di risposta.

Errori speciali

Esempi

Ripristina un oggetto per due giorni utilizzando l'opzione di recupero rapido

La seguente richiesta di ripristino ripristina una copia dell'photo1.jpgoggetto da Amazon Glacier per un periodo di due giorni utilizzando l'opzione di recupero rapido.

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>

Se non examplebucket dispone di una copia ripristinata dell'oggetto, Amazon S3 restituisce la seguente risposta. 202 Accepted

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

Se una copia dell'oggetto è già ripristinata, Amazon S3 restituisce una 200 OK risposta e aggiorna solo la data di scadenza della copia ripristinata.

Interroga un archivio con una richiesta SELECT

Di seguito è riportato un esempio di richiesta di ripristino di selezione.

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 restituisce la seguente 202 Accepted risposta.

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

Ulteriori informazioni