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
<a name="RESTObjectPOSTrestore"></a>

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

Dieser Vorgang führt die folgenden Arten von Anfragen aus: 
+ `select`— Führt eine Auswahlabfrage für ein archiviertes Objekt durch
+ `restore an archive`— Stellt ein archiviertes Objekt wieder her

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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources) und [ Verwaltung der Zugriffsberechtigungen für Ihre Amazon S3-Ressourcen ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) im * Amazon Simple Storage Service-Benutzerhandbuch. *

## Archive mit Select Requests abfragen
<a name="RESTObjectPOSTrestore-select-request"></a>

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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/querying-glacier-archives.html) im * Amazon Simple Storage Service-Benutzerhandbuch. *

Gehen Sie wie folgt vor, wenn Sie eine Auswahlanfrage stellen:
+ Definieren Sie einen Ausgabeort für die Ausgabe der Auswahlabfrage. Dies muss ein Amazon S3-Bucket sein, der dem Bucket entspricht AWS-Region , der das Archivobjekt enthält, das abgefragt wird. Der AWS-Konto , der den Job initiiert, muss über Schreibberechtigungen in den S3-Bucket verfügen. Sie können die Speicherklasse und die Verschlüsselung für die im Bucket gespeicherten Ausgabeobjekte angeben. Weitere Informationen zur Ausgabe finden Sie unter [ Abfragen archivierter Objekte ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/querying-glacier-archives.html) im * Amazon Simple Storage Service-Benutzerhandbuch*.

  Weitere Informationen zur `S3` Struktur im Anforderungstext finden Sie im Folgenden:
  + [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
  + [Verwaltung des Zugriffs mit ACLs ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3_ACLs_UsingACLs.html) im * Amazon Simple Storage Service-Benutzerhandbuch *
  + [Schutz von Daten mithilfe von Server-Side Verschlüsselung ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) im * Amazon Simple Storage Service-Benutzerhandbuch *
+ Definieren Sie den SQL-Ausdruck für die `SELECT` Art der Wiederherstellung Ihrer Abfrage in der `SelectParameters` Struktur des Anforderungstexts. Sie können Ausdrücke wie die folgenden Beispiele verwenden.
  + Der folgende Ausdruck gibt alle Datensätze aus dem angegebenen Objekt zurück.

    ```
    SELECT * FROM Object
    ```
  + Unter der Annahme, dass Sie keine Überschriften für die im Objekt gespeicherten Daten verwenden, können Sie Spalten mit positionellen Überschriften angeben.

    ```
    SELECT s._1, s._2 FROM Object s WHERE s._3 > 100
    ```
  + Wenn Sie Header haben und diese `fileHeaderInfo` in der `CSV` Struktur im Anforderungstext auf setzen`USE`, können Sie Header in der Abfrage angeben. (Wenn Sie das Feld `fileHeaderInfo` auf `IGNORE` setzen, wird die erste Zeile für die Abfrage übersprungen.) Sie können Ordinalpositionen nicht mit Headerspaltennamen mischen. 

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

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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference.html) im * Amazon Simple Storage Service-Benutzerhandbuch. * 

Wenn Sie eine Auswahlanfrage stellen, können Sie auch Folgendes tun:
+ Um Ihre Abfragen zu beschleunigen, geben Sie die `Expedited` Stufe an. Weitere Informationen zu Ebenen finden Sie unter „Archive wiederherstellen“ weiter unten in diesem Thema.
+ Geben Sie Details zum Datenserialisierungsformat sowohl des abgefragten Eingabeobjekts als auch der Serialisierung der Abfrageergebnisse an. CSV-encoded 

Im Folgenden finden Sie weitere wichtige Fakten zur Auswahlfunktion:
+ Die Ausgabeergebnisse sind neue Amazon S3-Objekte. Im Gegensatz zu Archivabrufen werden sie so lange gespeichert, bis sie explizit gelöscht werden — manuell oder im Rahmen einer Lebenszyklusrichtlinie.
+ Sie können mehr als eine Select-Anfrage für dasselbe Amazon S3-Objekt stellen. Amazon S3 dedupliziert keine Anfragen. Vermeiden Sie es daher, doppelte Anfragen zu stellen.
+  Amazon S3 akzeptiert eine Auswahlanfrage, auch wenn das Objekt bereits wiederhergestellt wurde. Eine Auswahlanforderung gibt keine Fehlerantwort zurück`409`.

## Archive wiederherstellen
<a name="RESTObjectPOSTrestore-restore-request"></a>

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: 
+ **`Expedited`**- Mit beschleunigten Abrufen können Sie schnell auf Ihre in der Speicherklasse GLACIER gespeicherten Daten zugreifen, wenn gelegentlich dringende Anfragen für eine Teilmenge von Archiven erforderlich sind. Für alle archivierten Objekte mit Ausnahme der größten (über 250 MB) werden Daten, auf die mit beschleunigten Abrufen zugegriffen wird, in der Regel innerhalb von 1—5 Minuten verfügbar gemacht. Die bereitgestellte Kapazität stellt sicher, dass für Expedited-Abrufe Abrufkapazität verfügbar ist, wenn Sie sie benötigen. Beschleunigte Abrufe und bereitgestellte Kapazität sind für die Speicherklasse DEEP\_ARCHIVE nicht verfügbar.
+ **`Standard`** - Standard-Abrufe ermöglichen Ihnen den Zugriff auf Ihre archivierten Objekte innerhalb einiger Stunden. Dies ist die Standardoption für die GLACIER- und DEEP\_ARCHIVE-Abrufanforderungen, die die Abrufoption nicht angeben. Standardabrufe werden in der Regel innerhalb von 3 bis 5 Stunden ab der Speicherklasse GLACIER und in der Regel innerhalb von 12 Stunden ab der Speicherklasse DEEP\_ARCHIVE abgeschlossen. 
+ **`Bulk`**- Massenabrufe sind die kostengünstigste Abruffoption von Amazon Glacier, mit der Sie große Datenmengen, sogar Petabyte, kostengünstig an einem Tag abrufen können. Massenabrufe werden in der Regel innerhalb von 5 bis 12 Stunden ab der Speicherklasse GLACIER und in der Regel innerhalb von 48 Stunden ab der Speicherklasse DEEP\_ARCHIVE abgeschlossen.

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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html) 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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html#restoring-objects-upgrade-tier.title.html) 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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/NotificationHowTo.html) 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 ](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html) [ Object Lifecycle Management ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) im * Amazon Simple Storage Service-Benutzerhandbuch*.

## Anforderungen
<a name="RESTObjectPOSTrestore-requests"></a>

### Syntax
<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 Anfragen authentifizieren (AWS Signatur (Version 4))
5. Content-MD5: {{MD5}}
6. 
7.  {{request body }}
```

**Anmerkung**  
Die Syntax zeigt einige der Anforderungsheader. Eine vollständige Liste finden Sie unter „Anforderungsheader“ weiter unten in diesem Thema.

### Anforderungsparameter
<a name="RESTObjectPOSTrestore-requests-request-parameters"></a>

Bei dieser Implementierung der Operation werden keine Anforderungsparameter verwendet.

### Anforderungsheader
<a name="RESTObjectPOSTrestore-requests-request-headers"></a>


|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| Content-MD5 | Der Base64-kodierte 128-Bit-MD5-Digest der Daten. Sie müssen diesen Header zur Überprüfung der Nachrichtenintegrität verwenden, um sicherzustellen, dass der Anforderungstext bei der Übertragung nicht beschädigt wurde. Weitere Informationen finden Sie unter [ RFC ](http://www.ietf.org/rfc/rfc1864.txt) 1864.<br />Typ: Zeichenfolge <br />Standard: keiner | Ja  | 

### Anfrage-Elemente
<a name="RESTObjectPOSTrestore-requests-request-elements"></a>

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. 


|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| RestoreRequest | Container für Wiederherstellungsinformationen.<br />Typ: Container | Ja | 
| Days | Lebensdauer der wiederhergestellten (aktiven) Kopie. Die Mindestanzahl an Tagen, für die Sie ein Objekt aus Amazon Glacier wiederherstellen können, ist 1. Nachdem die Objektkopie die angegebene Lebensdauer erreicht hat, entfernt Amazon S3 sie aus dem Bucket. Wenn Sie ein Archiv wiederherstellen, ist dieses Element erforderlich. <br />Verwenden Sie dieses Element nicht mit einer `SELECT` Art von Anfrage.<br />Typ: Positive Ganzzahl<br />Vorfahren: `RestoreRequest` | Ja, wenn ein Archiv wiederhergestellt wird | 
| GlacierJobParameters | Container für Auftragsparameter der S3 Glacier-Speicherklasse.<br />Verwenden Sie dieses Element nicht mit einer `SELECT` Art von Anfrage.<br />Typ: Container<br />Vorfahren: `RestoreRequest` | Nein | 
| Tier | Die Datenzugriffsebene, die bei der Wiederherstellung des Archivs verwendet werden soll. `Standard`ist die Standardeinstellung.<br />Type: Zähler<br />Zulässige Werte: `Expedited` \| `Standard` \| `Bulk`<br />Vorfahren: `GlacierJobParameters` | Nein | 

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. 


|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| RestoreRequest | Container für Wiederherstellungsinformationen.<br />Typ: Container | Ja | 
| Tier | Die Datenzugriffsebene, die bei der Wiederherstellung des Archivs verwendet werden soll. `Standard`ist die Standardeinstellung.<br />Type: Zähler<br />Zulässige Werte: `Expedited` \| `Standard` \| `Bulk`<br />Vorfahren: `RestoreRequest` | Nein | 
| Description | Die optionale Beschreibung der Anfrage.<br />Typ: Zeichenfolge<br />Vorfahren: `RestoreRequest` | Nein | 
| SelectParameters | Beschreibt die Parameter für die Job-Anfrage zur Auswahl.<br />Typ: Container<br />Vorfahren: `RestoreRequest` | Ja, wenn der Anfragetyp lautet SELECT  | 
| OutputLocation | Beschreibt den Ort, an dem die Ergebnisse der Auswahlwiederherstellungsanforderung empfangen werden.<br />Typ: Container für Amazon S3<br />Vorfahren: `RestoreRequest` | Ja, wenn der Anfragetyp lautet SELECT  | 


**Das `SelectParameters` Containerelement enthält die folgenden Elemente.**  

|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| Expression | Der SQL-Ausdruck. Beispiel:+  Der folgende SQL-Ausdruck ruft die erste Spalte der Daten aus dem im CSV-Format gespeicherten Objekt ab: <br />`SELECT s._1 FROM Object s` <br />+  Der folgende SQL-Ausdruck gibt alles aus dem Objekt zurück: <br />`SELECT * FROM Object` <br />Typ: Zeichenfolge<br />Vorfahren: `SelectParameters` | Ja | 
| ExpressionType | Identifiziert den Ausdruckstyp.<br />Typ: Zeichenfolge<br />Zulässige Werte: `SQL`<br />Vorfahren: `SelectParameters` | Ja | 
| InputSerialization | Beschreibt das Serialisierungsformat des Objekts.<br />Typ: Container für CSV<br />Vorfahren: `SelectParameters` | Ja | 
| OutputSerialization | Beschreibt, wie die Ergebnisse des Auswahlauftrags serialisiert werden.<br />Typ: Container für CSV<br />Vorfahren: `SelectParameters` | Ja | 


**Das CSV-Containerelement im `InputSerialization` Element enthält die folgenden Elemente.**  

|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| RecordDelimiter | Ein einzelnes Zeichen, das verwendet wird, um einzelne Datensätze in der Eingabe zu trennen. Anstelle des Standardwerts können Sie ein beliebiges Trennzeichen angeben.<br />Typ: Zeichenfolge<br />Standard: `\n`<br />Vorfahren: `CSV` | Nein | 
| FieldDelimiter | Ein einzelnes Zeichen, das verwendet wird, um einzelne Felder in einem Datensatz zu trennen. Sie können ein beliebiges Trennzeichen angeben. <br />Typ: Zeichenfolge<br />Standard: `,`<br />Vorfahren: `CSV` | Nein | 
| QuoteCharacter | Ein einzelnes Zeichen, das als Escape-Zeichen verwendet wird, wenn das Feldtrennzeichen Teil des Werts ist.<br />Betrachten Sie dieses Beispiel in einer CSV-Datei: <br />`"a, b" `<br />Wenn Sie den Wert in Anführungszeichen setzen, wird dieser Wert zu einem einzelnen Feld. Wenn Sie keine Anführungszeichen verwenden, ist das Komma ein Feldtrennzeichen (was es zu zwei getrennten Feldwerten macht, a und b).<br />Typ: Zeichenfolge<br />Standard: `"`<br />Vorfahren: `CSV` | Nein | 
| QuoteEscapeCharacter | Ein einzelnes Zeichen, das verwendet wird, um das Anführungszeichen innerhalb eines bereits mit Escape-Zeichen versehenen Werts zu umgehen. Der Wert `""" a , b """` wird beispielsweise als geparst. `" a , b "`<br />Typ: Zeichenfolge<br />Standard: `"`<br />Vorfahren: `CSV` | Nein | 
| FileHeaderInfo | Beschreibt die erste Zeile in den Eingabedaten. Es ist einer der ENUM-Werte.+  `NONE`: Die erste Zeile ist kein Header. <br />+  `IGNORE`: Die erste Zeile ist eine Überschrift, aber Sie können die Header-Werte nicht verwenden, um die Spalte in einem Ausdruck anzugeben. Sie können die Spaltenposition (z. B. \_1, \_2,...) verwenden, um die Spalte (`SELECT s._1 FROM OBJECT s`) anzugeben. <br />+  `Use`: Die erste Zeile ist eine Überschrift, und Sie können den Header-Wert verwenden, um eine Spalte in einem Ausdruck (`SELECT "name" FROM OBJECT`) zu identifizieren.  <br />Type: Zähler<br />Zulässige Werte: `NONE \| USE \| IGNORE`<br />Vorfahren: `CSV` | Nein | 
| Comments | Ein einzelnes Zeichen, mit dem angegeben wird, dass eine Zeile ignoriert werden soll, wenn das Zeichen am Anfang der Reihe vorhanden ist Sie können ein beliebiges Zeichen angeben, um eine Kommentarzeile zu kennzeichnen.<br />Typ: Zeichenfolge<br />Vorfahren: `CSV` | Nein | 


**Das CSV-Containerelement (in den `OutputSerialization` Elementen) enthält die folgenden Elemente.**  

|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| QuoteFields | Gibt an, ob Ausgabefelder in Anführungszeichen gesetzt werden sollen. +  `ALWAYS`: Verwenden Sie für Ausgabefelder immer Anführungszeichen. <br />+  `ASNEEDED`: Verwenden Sie bei Bedarf Anführungszeichen für Ausgabefelder. <br />Type: Zähler<br />Zulässige Werte: `ALWAYS \| ASNEEDED`<br />Standard: `AsNeeded`<br />Vorfahren: `CSV` | Nein | 
| RecordDelimiter | Ein einzelnes Zeichen, das verwendet wird, um einzelne Datensätze in der Ausgabe zu trennen. Anstelle des Standardwerts können Sie ein beliebiges Trennzeichen angeben. <br />Typ: Zeichenfolge<br />Standard: `\n`<br />Vorfahren: `CSV` | Nein | 
| FieldDelimiter | Ein einzelnes Zeichen, das verwendet wird, um einzelne Felder in einem Datensatz zu trennen. Sie können ein beliebiges Trennzeichen angeben. <br />Typ: Zeichenfolge<br />Standard: `,`<br />Vorfahren: `CSV` | Nein | 
| QuoteCharacter | Ein einzelnes Zeichen, das als Escape-Zeichen verwendet wird, wenn das Feldtrennzeichen Teil des Werts ist. Wenn der Wert beispielsweise lautet`a, b`, setzt Amazon S3 diesen Feldwert wie folgt in Anführungszeichen:. `" a , b "`<br />Typ: Zeichenfolge<br />Standard: `"`<br />Vorfahren: `CSV` | Nein | 
| QuoteEscapeCharacter | Ein einzelnes Zeichen, das verwendet wird, um das Anführungszeichen innerhalb eines bereits mit Escape-Zeichen versehenen Werts zu umgehen. Wenn der Wert beispielsweise lautet`" a , b "`, setzt Amazon S3 den Wert wie folgt in Anführungszeichen:. `""" a , b """`<br />Typ: Zeichenfolge<br />Vorfahren: `CSV` | Nein | 


**Das S3-Containerelement (im `OutputLocation` Element) enthält die folgenden Elemente.**  

|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| AccessControlList | Eine Liste von Zuweisungen, die den Zugriff auf die gestaffelten Ergebnisse steuern. <br />Typ: Behälter für Grant<br />Vorfahren: `S3` | Nein | 
| BucketName | Der Name des S3-Buckets, in dem die ausgewählten Wiederherstellungsergebnisse gespeichert werden. Der Bucket muss sich in demselben AWS-Region wie der Bucket befinden, der das Eingabearchivobjekt enthält.<br />Typ: Zeichenfolge<br />Vorfahren: `S3` | Ja | 
| CannedACL | Die vordefinierte Zugriffskontrollliste (ACL), die auf die ausgewählten Wiederherstellungsergebnisse angewendet werden soll.<br />Typ: Zeichenfolge<br />Zulässige Werte: ` private \| public-read \| public-read-write \| aws-exec-read \| authenticated-read \| bucket-owner-read \| bucket-owner-full-control`<br />Vorfahren: `S3` | Nein | 
| Encryption | Enthält Verschlüsselungsinformationen für die gespeicherten Ergebnisse.<br />Typ: Container für Verschlüsselung<br />Vorfahren: `S3` | Nein | 
| Prefix | Das Präfix, das den ausgewählten Wiederherstellungsergebnissen vorangestellt wird. Die maximale Länge für das Präfix beträgt 512 Byte.<br />Typ: Zeichenfolge<br />Vorfahren: `S3` | Ja | 
| StorageClass | Die Speicherklasse, die zum Speichern der Ergebnisse der ausgewählten Anfrage verwendet wird.<br />Typ: Zeichenfolge<br />Zulässige Werte: `STANDARD` \| `REDUCED_REDUNDANCY` \| `STANDARD_IA` \| `ONEZONE_IA` <br />Vorfahren: `S3 ` | Nein | 
| Tagging | Container für Tag-Informationen.<br />Typ: Tag-Struktur<br />Vorfahren: `S3 ` | Nein | 
| UserMetadata | Enthält eine Liste von Metadaten, die zusammen mit den ausgewählten Wiederherstellungsergebnissen gespeichert werden sollen.<br />Typ: MetadataEntry Struktur<br />Vorfahren: `S3` | Nein | 


**Das Grantee-Containerelement (im `AccessControlList` Element) enthält die folgenden Elemente.**  

|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| DisplayName | Der Anzeigename des Empfängers<br />Typ: Zeichenfolge<br />Vorfahren: `Grantee` | Nein | 
| EmailAddress | Die E-Mail-Adresse des Empfängers<br />Typ: Zeichenfolge<br />Vorfahren: `Grantee` | Nein | 
| ID | Die kanonische Benutzer-ID des Empfängers<br />Typ: Zeichenfolge<br />Vorfahren: `Grantee` | Nein | 
| Type | Der Typ des Empfängers<br />Typ: Zeichenfolge<br />Vorfahren: `Grantee` | Nein | 
| URI | Die URI der Empfängergruppe<br />Typ: Zeichenfolge<br />Vorfahren: `Grantee` | Nein | 
| Permission | Genehmigung erteilt.<br />Typ: Zeichenfolge<br />Vorfahren: `Grantee` | Nein | 


**Das `` Encryption-Containerelement (in S3) enthält die folgenden Elemente.**  

|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| EncryptionType | Der serverseitige Verschlüsselungsalgorithmus, der beim Speichern von Auftragsergebnissen verwendet wird. Standardmäßig wird keine Verschlüsselung verwendet.<br />Typ: Zeichenfolge<br />Gültige Werte `aws:kms \| AES256`<br />Vorfahren: `Encryption`  | Nein | 
| KMSContext | Optional. Wenn der Verschlüsselungstyp lautet`aws:kms`, können Sie diesen Wert verwenden, um den Verschlüsselungskontext für die ausgewählten Wiederherstellungsergebnisse anzugeben.<br />Typ: Zeichenfolge<br />Vorfahren: Verschlüsselung  | Nein | 
| KMSKeyId | Die AWS Key Management Service (AWS KMS) -Schlüssel-ID, die für die Objektverschlüsselung verwendet werden soll.<br />Typ: Zeichenfolge<br />Vorfahren: `Encryption`  | Nein | 


**Das `TagSet` Containerelement (im `` Tagging-Element) enthält das folgende Element.**  

|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| Tag | Enthält Schlagworte.<br />Typ: Container<br />Vorfahren: `TagSet`  | Nein | 


**Das Tag-Containerelement (im `TagSet` Element) enthält die folgenden Elemente.**  

|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| Key | Name des Tags. <br />Typ: Zeichenfolge<br />Vorfahren: `Tag` | Nein | 
| Value | Wert des Tags.<br />Typ: Zeichenfolge<br />Vorfahren: `Tag` | Nein | 


**Das `MetadataEntry` Containerelement (im `UserMetadata` Element) enthält die folgenden Schlüssel-Wert-Paar-Elemente, die zusammen mit einem Objekt gespeichert werden sollen.**  

|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
| MetadataKey | Der Metadatenschlüssel.<br />Typ: Zeichenfolge<br />Vorfahren: `` | Nein | 
| MetadataEntry | Der Metadatenwert.<br />Typ: Zeichenfolge<br />Vorfahren: `` | Nein | 

## Antworten
<a name="RESTObjectPOSTrestore-responses"></a>

Ein erfolgreicher Vorgang gibt entweder den `202 Accepted` Statuscode `200 OK` oder zurück. 
+ Wenn die Objektkopie zuvor nicht wiederhergestellt wurde, kehrt Amazon S3 `202 Accepted` in der Antwort zurück. 
+ Wenn die Objektkopie zuvor wiederhergestellt wurde, kehrt Amazon S3 `200 OK` in der Antwort zurück. 

### Antwort-Header
<a name="RESTObjectPOSTrestore-responses-response-headers"></a>

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

### Antwortelemente
<a name="RESTObjectPOSTrestore-responses-response-elements"></a>

Dieser Vorgang gibt keine Antwortelemente zurück.

### Spezielle Fehler
<a name="RESTObjectPOSTrestore-responses-special-errors"></a>


| Fehlercode | Description | HTTP-Statuscode | SOAP-Fehlercode-Präfix | 
| --- | --- | --- | --- | 
| RestoreAlreadyInProgress | Die Objektwiederherstellung ist bereits im Gange. (Dieser Fehler gilt nicht für Anfragen vom Typ SELECT.) | 409 Conflict (409 Konflikt) | Client | 
| GlacierExpeditedRetrievalNotAvailable | Beschleunigte Abrufe der S3 Glacier-Speicherklasse sind derzeit nicht verfügbar. Bitte versuchen Sie es später erneut. (Wird zurückgegeben, wenn die Kapazität nicht ausreicht, um die Anfrage zu verarbeiten. Expedited Dieser Fehler gilt nur für Expedited Abrufe und nicht für Bulk Abrufe.) Standard | 503 | N/A | 

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

### Stellen Sie mithilfe der Option „Beschleunigter Abruf“ ein Objekt für zwei Tage wieder her
<a name="RESTObjectPOSTrestore-responses-examples-sample-request"></a>

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.

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

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
<a name="RESTObjectPOSTrestore-responses-examples-select-request"></a>

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

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

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

## Weitere Infos
<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)
+ [SQL-Referenz für Amazon S3 Select und Amazon Glacier Select ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference.html) im * Amazon Simple Storage Service-Benutzerhandbuch *