Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

POST Object-Wiederherstellung

Description

Dieser Vorgang führt die folgenden Arten von Anfragen aus:

Um diesen Vorgang verwenden zu können, müssen Sie über die Berechtigungen zum Ausführen der s3:GetObject Aktionen s3:RestoreObject und verfügen. Der Bucket-Besitzer hat diese Berechtigung standardmäßig und kann diese Berechtigung anderen gewähren. Weitere Informationen zu Berechtigungen finden Sie unter Berechtigungen im Zusammenhang mit Bucket-Unterressourcenoperationen und Verwaltung der Zugriffsberechtigungen für Ihre Amazon S3-Ressourcen im Amazon Simple Storage Service-Benutzerhandbuch.

Archive mit Select Requests abfragen

Sie verwenden einen ausgewählten Anforderungstyp, um SQL-Abfragen an archivierten Objekten durchzuführen. Die archivierten Objekte, die mit der Auswahlanforderung abgefragt werden, müssen als unkomprimierte Dateien mit kommagetrennten Werten (CSV) formatiert werden. Sie können Abfragen und benutzerdefinierte Analysen für Ihre archivierten Daten ausführen, ohne Ihre Daten auf einer höheren Amazon S3-Ebene wiederherstellen zu müssen. Eine Übersicht über ausgewählte Anfragen finden Sie unter Abfragen archivierter Objekte im Amazon Simple Storage Service-Benutzerhandbuch.

Gehen Sie wie folgt vor, wenn Sie eine Auswahlanfrage stellen:

Weitere Informationen zur Verwendung von SQL mit Amazon Glacier Select Restore finden Sie unter SQL-Referenz für Amazon S3 Select und Amazon Glacier Select im Amazon Simple Storage Service-Benutzerhandbuch.

Wenn Sie eine Auswahlanfrage stellen, können Sie auch Folgendes tun:

Im Folgenden finden Sie weitere wichtige Fakten zur Auswahlfunktion:

Archive wiederherstellen

Objekte in den Speicherklassen GLACIER und DEEP_ARCHIVE werden archiviert. Um auf ein archiviertes Objekt zuzugreifen, müssen Sie zunächst eine Wiederherstellungsanforderung initiieren. Dadurch wird eine temporäre Kopie des archivierten Objekts wiederhergestellt. In einer Wiederherstellungsanforderung geben Sie an, wie viele Tage die wiederhergestellte Kopie existieren soll. Nach Ablauf des angegebenen Zeitraums löscht Amazon S3 die temporäre Kopie, das Objekt bleibt jedoch in der Speicherklasse GLACIER oder DEEP_ARCHIVE archiviert, aus der das Objekt wiederhergestellt wurde.

Um eine bestimmte Objektversion wiederherzustellen, können Sie eine Versions-ID angeben. Wenn Sie keine Versions-ID angeben, stellt Amazon S3 die aktuelle Version wieder her.

Die Zeit, die für die Fertigstellung von Wiederherstellungsaufträgen benötigt wird, hängt davon ab, aus welcher Speicherklasse das Objekt wiederhergestellt wird und welche Datenzugriffsebene Sie angeben.

Wenn Sie ein archiviertes Objekt wiederherstellen (oder eine Auswahlanfrage verwenden), können Sie im Tier Element des Anforderungstextes eine der folgenden Optionen für die Datenzugriffsebene angeben:

Weitere Informationen zu den Optionen zum Abrufen von Archiven und zur bereitgestellten Kapazität für den Expedited Datenzugriff finden Sie unter Wiederherstellung archivierter Objekte im Amazon Simple Storage Service-Benutzerhandbuch.

Sie können das Amazon S3-Wiederherstellungsgeschwindigkeitsupgrade verwenden, um die Wiederherstellungsgeschwindigkeit während der Ausführung auf eine höhere Geschwindigkeit zu ändern. Sie erhöhen die Geschwindigkeit einer laufenden Wiederherstellung, indem Sie eine weitere Wiederherstellungsanforderung an dasselbe Objekt senden und dabei ein neues Tier Anforderungselement festlegen. Bei der Ausgabe einer Anfrage für ein Upgrade der Wiederherstellungsstufe müssen Sie eine Stufe wählen, die schneller als die von der Wiederherstellung in Bearbeitung verwendete Stufe ist. Sie dürfen keine anderen Parameter ändern, beispielsweise das Anforderungselement Days. Weitere Informationen finden Sie unter Upgrading the Speed of an In-Progress Restore im Amazon Simple Storage Service-Benutzerhandbuch.

Um den Status der Objektwiederherstellung abzurufen, können Sie eine HEAD Anfrage senden. Operationen geben in der Antwort den x-amz-restore Header zurück, der Informationen über den Wiederherstellungsstatus enthält. Sie können Amazon S3-Ereignisbenachrichtigungen verwenden, um Sie zu benachrichtigen, wenn eine Wiederherstellung eingeleitet oder abgeschlossen wird. Weitere Informationen finden Sie unter Konfiguration von Amazon S3-Ereignisbenachrichtigungen im Amazon Simple Storage Service-Benutzerhandbuch.

Nach der Wiederherstellung eines archivierten Objekts können Sie den Wiederherstellungszeitraum aktualisieren, indem Sie die Anfrage mit einem neuen Zeitraum erneut ausstellen. Amazon S3 aktualisiert den Wiederherstellungszeitraum relativ zur aktuellen Uhrzeit und berechnet nur die Anfrage — es fallen keine Gebühren für die Datenübertragung an. Sie können den Wiederherstellungszeitraum nicht aktualisieren, wenn Amazon S3 Ihre aktuelle Wiederherstellungsanforderung für das Objekt aktiv verarbeitet.

Wenn Ihr Bucket über eine Lebenszykluskonfiguration mit einer Regel verfügt, die eine Ablaufaktion beinhaltet, überschreibt der Ablauf des Objekts die Lebensdauer, die Sie in einer Wiederherstellungsanforderung angeben. Wenn Sie beispielsweise eine Objektkopie für 10 Tage wiederherstellen, das Objekt aber voraussichtlich in 3 Tagen abläuft, löscht Amazon S3 das Objekt in 3 Tagen. Weitere Informationen zur Lebenszykluskonfiguration finden Sie unter PutBucketLifecycleConfiguration Object Lifecycle Management im Amazon Simple Storage Service-Benutzerhandbuch.

Anforderungen

Syntax

POST /ObjectName?restore&versionId=VersionID HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Authorization: authorization string (see Anfragen authentifizieren (AWS Signatur (Version 4))
Content-MD5: MD5

 request body 
 

Anforderungsparameter

Bei dieser Implementierung der Operation werden keine Anforderungsparameter verwendet.

Anforderungsheader

Anfrage-Elemente

Im Folgenden finden Sie ein XML-Beispiel für einen Anforderungstext für die Wiederherstellung eines Archivs.

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

In der folgenden Tabelle wird das XML für die Archivwiederherstellung im Anforderungstext erläutert.

Das folgende XML ist der Anforderungstext für eine Auswahlabfrage für ein archiviertes Objekt:

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

In den folgenden Tabellen wird das XML für einen SELECT Wiederherstellungstyp im Anforderungstext erläutert.

Antworten

Ein erfolgreicher Vorgang gibt entweder den 202 Accepted Statuscode 200 OK oder zurück.

Antwort-Header

Diese Implementierung des Vorgangs verwendet nur Antwort-Header, die den meisten Antworten gemeinsam sind. Weitere Informationen finden Sie unter Allgemeine Antwortheader.

Antwortelemente

Dieser Vorgang gibt keine Antwortelemente zurück.

Spezielle Fehler

Beispiele

Stellen Sie mithilfe der Option „Beschleunigter Abruf“ ein Objekt für zwei Tage wieder her

Mit der folgenden Wiederherstellungsanforderung wird mithilfe der Option „Beschleunigter Abruf“ eine Kopie des photo1.jpg Objekts aus Amazon Glacier für einen Zeitraum von zwei Tagen wiederhergestellt.

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>

Wenn examplebucket keine wiederhergestellte Kopie des Objekts vorhanden ist, gibt Amazon S3 die folgende Antwort zurück. 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

Wenn eine Kopie des Objekts bereits wiederhergestellt wurde, gibt Amazon S3 eine 200 OK Antwort zurück und aktualisiert nur die Ablaufzeit der wiederhergestellten Kopie.

Fragen Sie ein Archiv mit einer SELECT-Anfrage ab

Im Folgenden finden Sie ein Beispiel für eine Auswahlwiederherstellungsanforderung.

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 gibt die folgende 202 Accepted Antwort zurück.

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

Weitere Infos