**Diese Seite ist nur für Bestandskunden des Amazon Glacier-Service bestimmt, die Vaults und die ursprüngliche REST-API von 2012 verwenden.**

Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der Amazon Glacier-Speicherklassen in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive. Weitere Informationen zu diesen Speicheroptionen finden Sie unter [Amazon Glacier-Speicherklassen](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (ursprünglicher eigenständiger, auf Tresor basierender Service) akzeptiert keine Neukunden mehr. Amazon Glacier ist ein eigenständiger Service APIs , der Daten in Tresoren speichert und sich von den Speicherklassen Amazon S3 und Amazon S3 Glacier unterscheidet. Ihre vorhandenen Daten bleiben in Amazon Glacier auf unbestimmte Zeit sicher und zugänglich. Es ist keine Migration erforderlich. Für kostengünstige, langfristige Archivierungsspeicherung AWS empfiehlt sich die [Amazon S3 Glacier-Speicherklasse](https://aws.amazon.com/s3/storage-classes/glacier/), die mit S3-Bucket-Basis, voller AWS-Region Verfügbarkeit APIs, geringeren Kosten und AWS Serviceintegration ein hervorragendes Kundenerlebnis bieten. Wenn Sie erweiterte Funktionen wünschen, sollten Sie eine Migration zu Amazon S3 Glacier-Speicherklassen in Betracht ziehen, indem Sie unseren [AWS Lösungsleitfaden für die Übertragung von Daten aus Amazon Glacier-Tresoren in Amazon S3 Glacier-Speicherklassen](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/) verwenden.

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.

# Datenabrufoperationen
<a name="data-retrieval-policy-operations"></a>

Im Folgenden sind die in Amazon Glacier verfügbaren Vorgänge im Zusammenhang mit dem Datenabruf aufgeführt.

**Topics**
+ [Get Data Retrieval Policy (GET policy)](api-GetDataRetrievalPolicy.md)
+ [List Provisioned Capacity (GET provisioned-capacity)](api-ListProvisionedCapacity.md)
+ [Purchase Provisioned Capacity (POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)
+ [Set Data Retrieval Policy (PUT policy)](api-SetDataRetrievalPolicy.md)

# Get Data Retrieval Policy (GET policy)
<a name="api-GetDataRetrievalPolicy"></a>

## Beschreibung
<a name="api-GetDataRetrievalPolicy-description"></a>

Dieser Vorgang gibt die aktuelle Datenabrufrichtlinie für die in der AWS-Konto Anforderung angegebene AWS Region und zurück. `GET` Weitere Informationen zu Datenabrufrichtlinien finden Sie unter [Amazon Glacier-Richtlinien für den Datenabruf](data-retrieval-policy.md).

## Anforderungen
<a name="api-GetDataRetrievalPolicy-requests"></a>

Senden Sie eine HTTP-`GET`-Anforderung an den URI der Richtlinie für den Datenabruf, damit die aktuelle Datenabruf-Richtlinie zurückgegeben wird. Orientieren Sie sich dabei an dem folgenden Syntaxbeispiel.

### Syntax
<a name="api-GetDataRetrievalPolicy-requests-syntax"></a>

```
1. GET /AccountId/policies/data-retrieval HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**Anmerkung**  
Der `AccountId` Wert ist die AWS-Konto ID. Dieser Wert muss mit der AWS-Konto ID übereinstimmen, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Sie können entweder eine AWS-Konto ID oder optional ein einzelnes '`-`' (Bindestrich) angeben. In diesem Fall verwendet Amazon Glacier die AWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Wenn Sie Ihre Konto-ID angeben, müssen Sie sie ohne Bindestriche („-“) eingeben.

### Anforderungsparameter
<a name="api-GetDataRetrievalPolicy-requests-parameters"></a>

Dieser Vorgang verwendet keine Anforderungsparameter.

### Anforderungsheader
<a name="api-GetDataRetrievalPolicy-requests-headers"></a>

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter [Häufig verwendete Anforderungsheader](api-common-request-headers.md).

### Anforderungstext
<a name="api-GetDataRetrievalPolicy-requests-elements"></a>

Dieser Vorgang besitzt keinen Anforderungstext.

## Antworten
<a name="api-GetDataRetrievalPolicy-responses"></a>

### Syntax
<a name="api-GetDataRetrievalPolicy-responses-syntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Policy":
    {
      "Rules":[
         {
            "BytesPerHour": Number,
            "Strategy": String	 
         }
       ]
    }
}
```

### Antwort-Header
<a name="api-GetDataRetrievalPolicy-responses-headers"></a>

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter [Allgemeine Antwort-Header](api-common-response-headers.md).

### Antworttext
<a name="api-GetDataRetrievalPolicy-responses-elements"></a>

Der Antworttext enthält die folgenden JSON-Felder.

 

**BytesPerHour**  
Die Höchstanzahl an Bytes, die in einer Stunde abgerufen werden können.  
Dieses Feld ist nur vorhanden, wenn der Wert im **Strategy**-Feld `BytesPerHour` ist.   
*Typ*: Zahl

**Regeln**  
Die Richtlinienregel. Obwohl es sich um einen Listentyp handelt, gibt es derzeit nur eine Regel, die ein Strategiefeld und optional ein BytesPerHour Feld enthält.  
*Typ*: Array

**Strategie**  
Der Typ der Richtlinie für den Datenabruf.  
*Typ:* Zeichenfolge  
Gültige Werte: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` entspricht der Auswahl von **Max Retrieval Rate (Max. Abrufrate)** in der Konsole. `FreeTier` entspricht der Auswahl von **Free Tier Only (Nur kostenloses Kontingent)** in der Konsole. `None` entspricht der Auswahl von **No Retrieval Policy (Keine Abrufrichtlinie)** in der Konsole. Weitere Informationen zur Auswahl von Datenabrufrichtlinien in der Konsole finden Sie unter [Amazon Glacier-Richtlinien für den Datenabruf](data-retrieval-policy.md).

### Fehler
<a name="api-GetDataRetrievalPolicy-responses-errors"></a>

Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md).

## Beispiele
<a name="api-GetDataRetrievalPolicy-examples"></a>

Das folgende Beispiel demonstriert, wie eine Richtlinie für den Datenabruf abgerufen wird.

### Beispielanfrage
<a name="api-GetDataRetrievalPolicy-example-request"></a>

In diesem Beispiel wird eine `GET`-Anforderung an den URI für den Speicherort der Richtlinie gesendet.

```
1. GET /-/policies/data-retrieval HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### Beispielantwort
<a name="api-GetDataRetrievalPolicy-example-response"></a>

Falls die Anforderung erfolgreich beantwortet wird, wird die Richtlinie für den Datenabruf im Antworttext im JSON-Format angezeigt. 

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 85
 6.  
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.            "BytesPerHour":10737418240,
13.            "Strategy":"BytesPerHour"
14.           }
15.        ]
16.     }
17. }
```

## Zugehörige Abschnitte
<a name="related-sections-GetDataRetrievalPolicy"></a>

 
+ [Set Data Retrieval Policy (PUT policy)](api-SetDataRetrievalPolicy.md)

 
+ [Initiate Job (POST jobs)](api-initiate-job-post.md)

# List Provisioned Capacity (GET provisioned-capacity)
<a name="api-ListProvisionedCapacity"></a>

Dieser Vorgang führt die bereitgestellten Kapazitätseinheiten für das angegebene AWS-Konto auf. Weitere Informationen über bereitgestellte Kapazität finden Sie unter [Archiv-Abrufoptionen](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

Eine bereitgestellte Kapazitätseinheit ist ab dem Datum und der Uhrzeit des Kaufs (dem Startdatum), einen Monat lang gültig. Die Einheit läuft am Ablaufdatum ab, das auf die nächste Sekunde gerundet genau einen Monat nach dem Startdatum liegt. 

Wenn das Startdatum der 31. Tag eines Monats ist, dann ist der letzte Tag des nächsten Monats das Ablaufdatum. Beispiel: Ist das Startdatum der 31. August, dann ist der 30. September das Ablaufdatum. Ist das Startdatum der 31. Januar, dann ist der 28. Februar das Ablaufdatum. Diese Funktionalität wird im [Beispielantwort](#api-ListProvisionedCapacity-example1-response) veranschaulicht.

## Anforderungssyntax
<a name="api-ListProvisionedCapacity-RequestSyntax"></a>

Wenn Sie die bereitgestellte Abrufkapazität für ein Konto aufführen möchten, senden Sie eine HTTP GET-Anfrage an den URI der bereitgestellten Kapazität, wie im folgenden Syntax-Beispiel verdeutlicht wird.

```
1. GET /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**Anmerkung**  
Der `AccountId` Wert ist die AWS-Konto ID. Dieser Wert muss mit der AWS-Konto ID übereinstimmen, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Sie können entweder eine AWS-Konto ID oder optional ein einzelnes '`-`' (Bindestrich) angeben. In diesem Fall verwendet Amazon Glacier die AWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Wenn Sie Ihre Konto-ID angeben, müssen Sie sie ohne Bindestriche („-“) eingeben.

## Anforderungsparameter
<a name="api-ListProvisionedCapacity-RequestParameters"></a>

Dieser Vorgang verwendet keine Anforderungsparameter.

## Anforderungsheader
<a name="api-ListProvisionedCapacity-requests-headers"></a>

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter [Häufig verwendete Anforderungsheader](api-common-request-headers.md).

## Anforderungstext
<a name="api-ListProvisionedCapacity-requests-elements"></a>

Dieser Vorgang besitzt keinen Anforderungstext.

## Antworten
<a name="api-ListProvisionedCapacity-responses"></a>

Wenn die Operation erfolgreich ist, sendet der Service eine HTTP-`200 OK`-Antwort zurück.

### Antwortsyntax
<a name="api-ListProvisionedCapacity-ResponseSyntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "ProvisionedCapacityList": 
      {
         "CapacityId" : "string",
         "StartDate" : "string"
         "ExpirationDate" : "string"
      }
}
```

### Antwort-Header
<a name="api-ListProvisionedCapacity-headers"></a>

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter [Allgemeine Antwort-Header](api-common-response-headers.md).

### Antworttext
<a name="api-ListProvisionedCapacity-body"></a>

Der Antworttext enthält die folgenden JSON-Felder.

**CapacityId**  <a name="Glacier-ListProvisionedCapacity-response"></a>
Die ID, mit der die bereitgestellte Kapazitätseinheit identifiziert wird.  
 *Typ:* Zeichenfolge.

**StartDate**  
Das Datum (Coordinated Universal Time – UTC), an dem die bereitgestellte Kapazitätseinheit gekauft wurde.  
*Typ:* Zeichenfolge. Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, zum Beispiel `2013-03-20T17:03:43.221Z`.

**ExpirationDate**  
Das Datum (Coordinated Universal Time – UTC), an dem die bereitgestellte Kapazitätseinheit abläuft wurde.  
*Typ:* Zeichenfolge. Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, zum Beispiel `2013-03-20T17:03:43.221Z`.

### Fehler
<a name="api-ListProvisionedCapacity-errors"></a>

Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md).

## Beispiele
<a name="api-ListProvisionedCapacity-examples"></a>

Es folgt ein Beispiel für das Aufführen der bereitgestellten Kapazitätseinheiten für ein Konto.

### Beispielanforderung
<a name="api-ListProvisionedCapacity-example1-request"></a>

In diesem Beispiel wird eine GET-Anfrage gesendet, um eine Liste der bereitgestellten Kapazitätseinheiten für das angegebene Konto abzurufen.

```
1. GET /123456789012/priority-capacity HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
```

### Beispielantwort
<a name="api-ListProvisionedCapacity-example1-response"></a>

Wenn die Anfrage erfolgreich war, gibt Amazon Glacier (Amazon Glacier) a `HTTP 200 OK` mit einer Liste der bereitgestellten Kapazitätseinheiten für das Konto zurück, wie im folgenden Beispiel gezeigt.

 Die zuerst angeführte bereitgestellte Kapazitätseinheit ist ein Beispiel einer Einheit mit dem 31. Januar 2017 als Startdatum und dem 28. Februar 2017 als Ablaufdatum. Wie bereits erwähnt, ist das Ablaufdatum bei einem Startdatum am 31. Tag eines Monats der letzte Tag des nächsten Monats.

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:02:00 GMT
 4. Content-Type: application/json
 5. Content-Length: length
 6. 
 7. {
 8.    "ProvisionedCapacityList",
 9.       {
10.          "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
11.          "StartDate": "2017-01-31T14:26:33.031Z",
12.          "ExpirationDate": "2017-02-28T14:26:33.000Z",
13.       },
14.       {
15.          "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
16.          "StartDate": "2016-12-13T20:11:51.095Z"",
17.          "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
18.       },
19.       ...
20. }
```

## Zugehörige Abschnitte
<a name="api-ListProvisionedCapacity-related-sections"></a>

 
+ [Purchase Provisioned Capacity (POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)

# Purchase Provisioned Capacity (POST provisioned-capacity)
<a name="api-PurchaseProvisionedCapacity"></a>

Dieser Vorgang kauft eine bereitgestellte Kapazitätseinheit für ein AWS-Konto. 

Eine bereitgestellte Kapazitätseinheit ist ab dem Datum und der Uhrzeit des Kaufs (dem Startdatum), einen Monat lang gültig. Die Einheit läuft am Ablaufdatum ab, das auf die nächste Sekunde gerundet genau einen Monat nach dem Startdatum liegt. 

Wenn das Startdatum der 31. Tag eines Monats ist, dann ist der letzte Tag des nächsten Monats das Ablaufdatum. Beispiel: Ist das Startdatum der 31. August, dann ist der 30. September das Ablaufdatum. Ist das Startdatum der 31. Januar, dann ist der 28. Februar das Ablaufdatum.

Die bereitgestellte Kapazität hilft sicherzustellen, dass für Expedited-Abrufe Abrufkapazität verfügbar ist, wenn Sie sie benötigen. Jede Kapazitätseinheit stellt sicher, dass mindestens drei beschleunigte Abrufe alle fünf Minuten durchgeführt werden können, und bietet einen Abrufdurchsatz von bis zu 150 MB/s %. Weitere Informationen über bereitgestellte Kapazität finden Sie unter [Archiv-Abrufoptionen](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

**Anmerkung**  
Es gibt eine Obergrenze von zwei bereitgestellten Kapazitätseinheiten pro Einheit. AWS-Konto

## Anforderungen
<a name="api-PurchaseProvisionedCapacity-requests"></a>

Um eine bereitgestellte Kapazitätseinheit für einen zu erwerben, AWS-Konto senden Sie eine `POST` HTTP-Anfrage an die URI für bereitgestellte Kapazität.

### Syntax
<a name="api-PurchaseProvisionedCapacity-requests-syntax"></a>

```
1. POST /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
```

 

**Anmerkung**  
Der `AccountId` Wert ist die ID. AWS-Konto Dieser Wert muss mit der AWS-Konto ID übereinstimmen, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Sie können entweder eine AWS-Konto ID oder optional ein einzelnes '`-`' (Bindestrich) angeben. In diesem Fall verwendet Amazon Glacier die AWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Wenn Sie Ihre Konto-ID angeben, müssen Sie sie ohne Bindestriche („-“) eingeben.

### Anforderungsparameter
<a name="api-PurchaseProvisionedCapacity-requestParameters"></a>

#### Anforderungsheader
<a name="api-PurchaseProvisionedCapacity-requests-headers"></a>

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter [Häufig verwendete Anforderungsheader](api-common-request-headers.md).

#### Anforderungstext
<a name="api-PurchaseProvisionedCapacity-requests-elements"></a>

Dieser Vorgang besitzt keinen Anforderungstext.

## Antworten
<a name="api-PurchaseProvisionedCapacity-responses"></a>

Wenn die Anfrage erfolgreich ist, gibt der Service die HTTP-Antwort `201 Created` zurück.

### Syntax
<a name="api-PurchaseProvisionedCapacity-response-syntax"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-capacity-id: CapacityId
```

### Antwort-Header
<a name="api-PurchaseProvisionedCapacity-responses-headers"></a>

Eine erfolgreiche Antwort umfasst zusätzlich zu den Antwort-Headern, die allen Vorgängen gemeinsam sind, die folgenden Antwort-Header. Weitere Informationen über allgemeine Antwort-Header finden Sie unter [Allgemeine Antwort-Header](api-common-response-headers.md).


|  Name  |  Description | 
| --- | --- | 
|  `x-amz-capacity-id`   |  Die ID, mit der die bereitgestellte Kapazitätseinheit identifiziert wird. Typ: Zeichenfolge  | 

### Antworttext
<a name="api-PurchaseProvisionedCapacity-responses-elements"></a>

Dieser Vorgang gibt keinen Antworttext zurück.

### Fehler
<a name="api-PurchaseProvisionedCapacity-responses-errors"></a>

Dieser Vorgang umfasst zusätzlich zu den möglichen Fehlern, die allen Amazon Glacier-Vorgängen gemeinsam sind, die folgenden Fehler oder Fehler. Informationen zu Amazon Glacier-Fehlern und eine Liste der Fehlercodes finden Sie unter[Fehlermeldungen](api-error-responses.md).


| Code | Description | HTTP-Statuscode | Typ | 
| --- | --- | --- | --- | 
| LimitExceededException | Wird zurückgegeben, wenn die gestellte Anfrage das Limit für Einheiten bereitgestellter Kapazität des Kontos überschreiten würde.  | 400 Bad Request | Client | 

## Beispiele
<a name="api-PurchaseProvisionedCapacity-examples"></a>

Das Folgende ist ein Beispiel für den Kauf bereitgestellter Kapazität für ein Konto.

### Beispielanforderung
<a name="api-PurchaseProvisionedCapacity-example-request"></a>

Im folgenden Beispiel wir eine HTTP-POST-Anfrage gesendet, um eine Einheit bereitgestellter Kapazität zu kaufen. 

```
1. POST /123456789012/provisioned-capacity HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
```

### Beispielantwort
<a name="api-PurchaseProvisionedCapacity-example-response"></a>

Wenn die Anfrage erfolgreich war, gibt Amazon Glacier (Amazon Glacier) eine `HTTP 201 Created` Antwort zurück, wie im folgenden Beispiel gezeigt.

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z
```

## Zugehörige Abschnitte
<a name="api-PurchaseProvisionedCapacity-related-sections"></a>

 
+ [List Provisioned Capacity (GET provisioned-capacity)](api-ListProvisionedCapacity.md)

# Set Data Retrieval Policy (PUT policy)
<a name="api-SetDataRetrievalPolicy"></a>

## Beschreibung
<a name="api-SetDataRetrievalPolicy-description"></a>

Durch diesen Vorgang wird eine Datenabrufrichtlinie in der in der Anforderung angegebenen AWS Region festgelegt und anschließend umgesetzt. `PUT` Sie können eine Richtlinie pro AWS Region für eine festlegen. AWS-Konto Die Richtlinie wird bei einer erfolgreichen `PUT`-Operation innerhalb weniger Minuten umgesetzt. 

 Die Operation zur Einrichtung der Richtlinie wirkt sich nicht auf Abrufaufträge aus, die in Bearbeitung waren, bevor die Richtlinie umgesetzt wurde. Weitere Informationen zu Datenabrufrichtlinien finden Sie unter [Amazon Glacier-Richtlinien für den Datenabruf](data-retrieval-policy.md). 

## Anforderungen
<a name="api-SetDataRetrievalPolicy-requests"></a>

### Syntax
<a name="api-SetDataRetrievalPolicy-requests-syntax"></a>

Senden Sie eine HTTP-PUT-Anfrage an den URI der Datenabrufrichtlinie, um eine Datenabrufrichtlinie einzurichten. Orientieren Sie sich dabei an dem folgenden Syntaxbeispiel.

```
 1. PUT /AccountId/policies/data-retrieval HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.   "Policy":
10.     {
11.       "Rules":[
12.          {
13.              "Strategy": String,
14.              "BytesPerHour": Number          
15.          }
16.        ]
17.     }
18. }
```

 

**Anmerkung**  
Der `AccountId` Wert ist die AWS-Konto ID. Dieser Wert muss mit der AWS-Konto ID übereinstimmen, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Sie können entweder eine AWS-Konto ID oder optional ein einzelnes '`-`' (Bindestrich) angeben. In diesem Fall verwendet Amazon Glacier die AWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Wenn Sie Ihre Konto-ID angeben, müssen Sie sie ohne Bindestriche („-“) eingeben.

### Anforderungsparameter
<a name="api-SetDataRetrievalPolicy-requests-parameters"></a>

Dieser Vorgang verwendet keine Anforderungsparameter.

### Anforderungsheader
<a name="api-SetDataRetrievalPolicy-requests-headers"></a>

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter [Häufig verwendete Anforderungsheader](api-common-request-headers.md).

### Anforderungstext
<a name="api-SetDataRetrievalPolicy-requests-elements"></a>

Der Anforderungstext enthält die folgenden JSON-Felder.

 

**BytesPerHour**  
Die Höchstanzahl an Bytes, die in einer Stunde abgerufen werden können.  
Dieses Feld ist nur dann ein Pflichtfeld, wenn der Wert im Strategy-Feld `BytesPerHour` ist. Ihre PUT-Operation wird abgelehnt, wenn das Strategy-Feld nicht auf `BytesPerHour` festgelegt ist und Sie dieses Feld festlegen.  
*Typ*: Zahl  
*Erforderlich*: Ja, wenn das Strategie-Feld auf `BytesPerHour` festgelegt ist. Ansonsten nein.  
*Gültige Werte*: Mindestganzzahlwert 1. Höchstganzzahlwert 2^63 - 1 inklusive.

**Regeln**  
Die Richtlinienregel. Obwohl es sich um einen Listentyp handelt, darf es derzeit nur eine Regel geben, die ein Strategiefeld und optional ein BytesPerHour Feld enthält.  
*Typ*: Array  
*Erforderlich*: Ja

**Strategie**  
Der Typ der einzurichtenden Datenabrufrichtlinie.  
*Typ:* Zeichenfolge  
*Erforderlich*: Ja  
Gültige Werte: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` entspricht der Auswahl von **Max Retrieval Rate (Max. Abrufrate)** in der Konsole. `FreeTier` entspricht der Auswahl von **Free Tier Only (Nur kostenloses Kontingent)** in der Konsole. `None` entspricht der Auswahl von **No Retrieval Policy (Keine Abrufrichtlinie)** in der Konsole. Weitere Informationen zur Auswahl von Datenabrufrichtlinien in der Konsole finden Sie unter [Amazon Glacier-Richtlinien für den Datenabruf](data-retrieval-policy.md).

## Antworten
<a name="api-SetDataRetrievalPolicy-responses"></a>

### Syntax
<a name="api-SetDataRetrievalPolicyresponse-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### Antwort-Header
<a name="api-SetDataRetrievalPolicy-responses-headers"></a>

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter [Allgemeine Antwort-Header](api-common-response-headers.md).

### Antworttext
<a name="api-SetDataRetrievalPolicy-responses-elements"></a>

Dieser Vorgang gibt keinen Antworttext zurück.

### Fehler
<a name="api-SetDataRetrievalPolicy-responses-errors"></a>

Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md).

## Beispiele
<a name="api-SetDataRetrievalPolicy-examples"></a>

### Beispielanfrage
<a name="api-SetDataRetrievalPolicy-example-request"></a>

Im folgenden Beispiel wird eine HTTP-PUT-Anfrage gesendet, mit dem Strategy-Feld festgelegt auf `BytesPerHour`. 

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"BytesPerHour",
13.              "BytesPerHour":10737418240       
14.           }
15.        ]
16.     }
17. }
```

Im folgenden Beispiel wird eine HTTP-PUT-Anfrage gesendet, mit dem Strategy-Feld festgelegt auf `FreeTier`. 

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"FreeTier"   
13.           }
14.        ]
15.     }
16. }
```

Im folgenden Beispiel wird eine HTTP-PUT-Anfrage gesendet, mit dem Strategy-Feld festgelegt auf `None`. 

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"None"   
13.           }
14.        ]
15.     }
16. }
```

### Beispielantwort
<a name="api-SetDataRetrievalPolicy-example-response"></a>

Wenn die Anfrage erfolgreich war, legt Amazon Glacier (Amazon Glacier) die Richtlinie fest und gibt a zurück, `HTTP 204 No Content` wie im folgenden Beispiel gezeigt.

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```

## Zugehörige Abschnitte
<a name="related-sections-SetDataRetrievalPolicy"></a>

 
+ [Get Data Retrieval Policy (GET policy)](api-GetDataRetrievalPolicy.md)

 
+ [Initiate Job (POST jobs)](api-initiate-job-post.md)