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

# Set Vault Access Policy (PUT access-policy)
<a name="api-SetVaultAccessPolicy"></a>

## Description
<a name="api-SetVaultAccessPolicy-description"></a>

Mit diesem Vorgang wird eine Zugriffsichtlinie für einen Tresor festgelegt, wodurch gleichzeitig eine bereits vorhandene Richtlinie überschrieben wird. Senden Sie eine `PUT`-Anforderung an die `access-policy`-Unterressource des Tresors, um eine Tresor-Zugriffsrichtlinie zu konfigurieren. Sie können pro Tresor eine Zugriffsrichtlinie mit einer Größe von bis zu 20 KB festlegen. Weitere Informationen zu Tresorzugriffsrichtlinien finden Sie unter [Richtlinien für den Tresorzugriff](vault-access-policy.md). 

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

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

Sie legen eine Tresor-Zugriffsrichtlinie fest, indem Sie eine HTTP-`PUT`-Anforderung an den URI der `access-policy`-Unterressource des Tresors senden. Orientieren Sie sich dabei an dem folgenden Syntaxbeispiel.

```
 1. PUT /AccountId/vaults/vaultName/access-policy 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": "string"
10. }
```

 

**Anmerkung**  
Der `AccountId` Wert ist die AWS-Konto ID des Kontos, dem der Tresor gehört. 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 eine Konto-ID verwenden, darf die ID keine Bindestriche („-“) enthalten.

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

Dieser Vorgang verwendet keine Anforderungsparameter.

### Anforderungsheader
<a name="api-SetVaultAccessPolicy-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-SetVaultAccessPolicy-requests-elements"></a>

Der Anforderungstext enthält die folgenden JSON-Felder.

 **Richtlinie**   
Die Tresorzugriffsrichtlinie als eine JSON-Zeichenfolge, die "\$1" als Escape-Zeichen verwendet.  
 Typ: Zeichenfolge   
 Erforderlich: Ja

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

Als Antwort gibt Amazon Glacier zurück, `204 No Content` wenn die Richtlinie akzeptiert wird.

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

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

### Antwort-Header
<a name="api-SetVaultAccessPolicy-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-SetVaultAccessPolicy-responses-elements"></a>

Dieser Vorgang gibt keinen Antworttext zurück.

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

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

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

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

Das folgende Beispiel sendet eine HTTP-`PUT`-Anfrage an den URI der `access-policy`-Unterressource des Tresors. In der JSON-Zeichenfolge `Policy` wird „\$1“ als Escape-Zeichen verwendet.

```
1. PUT /-/vaults/examplevault/access-policy 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
7. 
8. {"Policy":"{\"Version\":\"2012-10-17\",		 	 	 \"Statement\":[{\"Sid\":\"Define-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}"}
```

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

Wenn die Anfrage erfolgreich war, gibt Amazon Glacier (Amazon Glacier) 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-SetVaultAccessPolicy"></a>

 
+ [Delete Vault Access Policy (DELETE access-policy)](api-DeleteVaultAccessPolicy.md)

 
+ [Get Vault Access Policy (GET access-policy)](api-GetVaultAccessPolicy.md)

## Weitere Informationen finden Sie unter:
<a name="api-SetVaultAccessPolicy_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen Amazon SDKs finden Sie im Folgenden:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-access-policy.html)