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.
# Amazon Glacier-Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Glacier Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `abort-multipart-upload`
Das folgende Codebeispiel zeigt, wie Sie`abort-multipart-upload`.
**AWS CLI**
Mit dem folgenden Befehl wird ein laufender mehrteiliger Upload in einen Tresor namens `my-vault` gelöscht:
```
aws glacier abort{{-}}multipart-upload --account-id - --vault-name {{my-vault}} --upload-id {{19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ}}
```
Dieser Befehl erzeugt keine Ausgabe. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben. Die Upload-ID wird vom Befehl `aws glacier initiate-multipart-upload` zurückgegeben und kann auch mithilfe von `aws glacier list-multipart-uploads` abgerufen werden.
Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [AbortMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-multipart-upload.html)in der *AWS CLI Befehlsreferenz*.
### `abort-vault-lock`
Das folgende Codebeispiel zeigt die Verwendung`abort-vault-lock`.
**AWS CLI**
**So brechen Sie einen laufenden Tresorverriegelungsprozess ab**
Im folgenden Beispiel für `abort-vault-lock` wird eine Tresorverriegelungsrichtlinie aus dem angegebenen Tresor gelöscht und der Sperrstatus der Tresorverriegelung auf „Unlocked“ zurückgesetzt.
```
aws glacier abort{{-}}vault-lock \
--account-id - \
--vault-name {{MyVaultName}}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Abbrechen der Tresorverriegelung (DELETE lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-AbortVaultLock.html) im *Entwicklerhandbuch für die Amazon-Glacier-API*.
+ Einzelheiten zur API finden Sie [AbortVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-vault-lock.html)in der *AWS CLI Befehlsreferenz*.
### `add-tags-to-vault`
Das folgende Codebeispiel zeigt die Verwendung`add-tags-to-vault`.
**AWS CLI**
Der folgende Befehl fügt zwei Tags zu einem Tresor mit dem Namen `my-vault` hinzu:
```
aws glacier add{{-}}tags-to-vault --account-id - --vault-name {{my-vault}} --tags {{id=1234,date=july2015}}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [AddTagsToVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/add-tags-to-vault.html)in der *AWS CLI Befehlsreferenz*.
### `complete-multipart-upload`
Das folgende Codebeispiel zeigt die Verwendung`complete-multipart-upload`.
**AWS CLI**
Mit dem folgenden Befehl wird ein mehrteiliger Upload für ein 3-MiB-Archiv abgeschlossen:
```
aws glacier complete-multipart-upload --archive-size {{3145728}} --checksum {{9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67}} --upload-id {{19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ}} {{-}}-account-id - --vault-name {{my-vault}}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
Die Upload-ID wird vom Befehl `aws glacier initiate-multipart-upload` zurückgegeben und kann auch mithilfe von `aws glacier list-multipart-uploads` abgerufen werden. Der Checksum-Parameter verwendet einen SHA-256-Struktur-Hash des Archivs im Hexadezimalformat.
Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI, einschließlich Anweisungen zur Berechnung eines Tree-Hashs, finden Sie unter Using Amazon Glacier im *AWS CLI-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [CompleteMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-multipart-upload.html)in der *AWS CLI Befehlsreferenz*.
### `complete-vault-lock`
Das folgende Codebeispiel zeigt die Verwendung`complete-vault-lock`.
**AWS CLI**
**So schließen Sie einen laufenden Tresorverriegelungsprozess ab**
Im folgenden Beispiel für `complete-vault-lock` wird der laufende Verriegelungsprozess für den angegebenen Tresor abgeschlossen und der Sperrstatus der Tresorverriegelung auf `Locked` festgelegt. Sie erhalten den Wert für den `lock-id`-Parameter, wenn Sie `initiate-lock-process` ausführen.
```
aws glacier complete{{-}}vault-lock \
--account-id - \
--vault-name {{MyVaultName}} \
--lock-id {{9QZgEXAMPLEPhvL6xEXAMPLE}}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Abschließen der Tresorverriegelung (POST lockId)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-CompleteVaultLock.html) im *Entwicklerhandbuch für die Amazon-Glacier-API*.
+ Einzelheiten zur API finden Sie [CompleteVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-vault-lock.html)in der *AWS CLI Befehlsreferenz*.
### `create-vault`
Das folgende Codebeispiel zeigt die Verwendung`create-vault`.
**AWS CLI**
Der folgende Befehl erstellt einen neuen Tresor mit dem Namen `my-vault`:
```
aws glacier create-vault --vault-name {{my-vault}} {{-}}-account-id -
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [CreateVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/create-vault.html)in der *AWS CLI Befehlsreferenz*.
### `delete-archive`
Das folgende Codebeispiel zeigt die Verwendung`delete-archive`.
**AWS CLI**
**So löschen Sie ein Archiv aus einem Tresor**
Im folgenden Beispiel für `delete-archive` wird das angegebene Archiv aus `example_vault` entfernt.
```
aws glacier delete-archive \
--account-id {{111122223333}} \
--vault-name {{example_vault}} \
--archive-id {{Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w}}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [DeleteArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-archive.html)in der *AWS CLI Befehlsreferenz*.
### `delete-vault-access-policy`
Das folgende Codebeispiel zeigt die Verwendung`delete-vault-access-policy`.
**AWS CLI**
**So entfernen Sie die Zugriffsrichtlinie eines Tresors**
Im folgenden Beispiel für `delete-vault-access-policy` wird die Zugriffsrichtlinie für den angegebenen Tresor entfernt.
```
aws glacier delete-vault-access-policy \
--account-id {{111122223333}} \
--vault-name {{example_vault}}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [DeleteVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-access-policy.html)in der *AWS CLI Befehlsreferenz*.
### `delete-vault-notifications`
Das folgende Codebeispiel zeigt die Verwendung`delete-vault-notifications`.
**AWS CLI**
**So entfernen Sie die SNS-Benachrichtigungen für einen Tresor**
Im folgenden Beispiel für `delete-vault-notifications` werden Benachrichtigungen, die von Amazon Simple Notification Service (Amazon SNS) gesendet wurden, für den angegebenen Tresor entfernt.
```
aws glacier delete-vault-notifications \
--account-id {{111122223333}} \
--vault-name {{example_vault}}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [DeleteVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-notifications.html)in der *AWS CLI Befehlsreferenz*.
### `delete-vault`
Das folgende Codebeispiel zeigt die Verwendung`delete-vault`.
**AWS CLI**
Der folgende Befehl löscht einen Tresor mit dem Namen `my-vault`:
```
aws glacier delete-vault --vault-name {{my-vault}} {{-}}-account-id -
```
Dieser Befehl erzeugt keine Ausgabe. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [DeleteVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault.html)in der *AWS CLI Befehlsreferenz*.
### `describe-job`
Das folgende Codebeispiel zeigt die Verwendung`describe-job`.
**AWS CLI**
Der folgende Befehl ruft Informationen über einen Auftrag zum Abrufen von Inventar in einem Tresor mit dem Namen `my-vault` ab:
```
aws glacier describe{{-}}job --account-id - --vault-name {{my-vault}} --job-id {{zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW}}
```
Ausgabe:
```
{
"InventoryRetrievalParameters": {
"Format": "JSON"
},
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"Completed": false,
"JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
"Action": "InventoryRetrieval",
"CreationDate": "2015-07-17T20:23:41.616Z",
"StatusCode": "InProgress"
}
```
Die Auftrags-ID finden Sie in der Ausgabe von `aws glacier initiate-job` und `aws glacier list-jobs`. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-job.html)in der *AWS CLI Befehlsreferenz*.
### `describe-vault`
Das folgende Codebeispiel zeigt die Verwendung`describe-vault`.
**AWS CLI**
Der folgende Befehl ruft Daten über einen Tresor mit dem Namen `my-vault` ab:
```
aws glacier describe-vault --vault-name {{my-vault}} {{-}}-account-id -
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [DescribeVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-vault.html)in der *AWS CLI Befehlsreferenz*.
### `get-data-retrieval-policy`
Das folgende Codebeispiel zeigt die Verwendung`get-data-retrieval-policy`.
**AWS CLI**
Mit dem folgenden Befehl wird die Datenabrufrichtlinie für das verwendete Konto abgerufen:
```
aws glacier get{{-}}data-retrieval-policy --account-id -
```
Ausgabe:
```
{
"Policy": {
"Rules": [
{
"BytesPerHour": 10737418240,
"Strategy": "BytesPerHour"
}
]
}
}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [GetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-data-retrieval-policy.html)in der *AWS CLI Befehlsreferenz*.
### `get-job-output`
Das folgende Codebeispiel zeigt die Verwendung`get-job-output`.
**AWS CLI**
Der folgende Befehl speichert die Ausgabe eines Tresor-Inventarauftrags in einer Datei im aktuellen Verzeichnis mit dem Namen `output.json`:
```
aws glacier get{{-}}job-output --account-id - --vault-name {{my-vault}} --job-id {{zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW}} {{output.json}}
```
Die `job-id` ist in der Ausgabe von `aws glacier list-jobs` verfügbar. Beachten Sie, dass der Name der Ausgabedatei ein Positionsargument ist, dem kein Optionsname vorangestellt ist. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
Ausgabe:
```
{
"status": 200,
"acceptRanges": "bytes",
"contentType": "application/json"
}
```
`output.json`:
```
{"VaultARN":"arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault","InventoryDate":"2015-04-07T00:26:18Z","ArchiveList":[{"ArchiveId":"kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw","ArchiveDescription":"multipart upload test","CreationDate":"2015-04-06T22:24:34Z","Size":3145728,"SHA256TreeHash":"9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67"}]}
```
+ Einzelheiten zur API finden Sie [GetJobOutput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-job-output.html)in der *AWS CLI Befehlsreferenz*.
### `get-vault-access-policy`
Das folgende Codebeispiel zeigt die Verwendung`get-vault-access-policy`.
**AWS CLI**
**So rufen Sie die Zugriffsrichtlinie eines Tresors ab**
Im folgenden Beispiel für `get-vault-access-policy` wird die Zugriffsrichtlinie für den angegebenen Tresor abgerufen.
```
aws glacier get-vault-access-policy \
--account-id {{111122223333}} \
--vault-name {{example_vault}}
```
Ausgabe:
```
{
"policy": {
"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"
}
}
```
+ Einzelheiten zur API finden Sie [GetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-access-policy.html)in der *AWS CLI Befehlsreferenz*.
### `get-vault-lock`
Das folgende Codebeispiel zeigt die Verwendung`get-vault-lock`.
**AWS CLI**
**So rufen Sie die Details einer Tresorverriegelung ab**
Im folgenden Beispiel für `get-vault-lock` werden die Details zur Verriegelung für den angegebenen Tresor abgerufen.
```
aws glacier get{{-}}vault-lock \
--account-id - \
--vault-name {{MyVaultName}}
```
Ausgabe:
```
{
"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:99999999999:vaults/MyVaultName\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}",
"State": "Locked",
"CreationDate": "2019-07-29T22:25:28.640Z"
}
```
Weitere Informationen finden Sie unter [Abrufen der Tresorverriegelung (GET lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-GetVaultLock.html) im *Entwicklerhandbuch für die Amazon-Glacier-API*.
+ Einzelheiten zur API finden Sie [GetVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-lock.html)in der *AWS CLI Befehlsreferenz*.
### `get-vault-notifications`
Das folgende Codebeispiel zeigt die Verwendung`get-vault-notifications`.
**AWS CLI**
Der folgende Befehl ruft eine Beschreibung der Benachrichtigungskonfiguration für einen Tresor mit dem Namen `my-vault` ab:
```
aws glacier get{{-}}vault-notifications --account-id - --vault-name {{my-vault}}
```
Ausgabe:
```
{
"vaultNotificationConfig": {
"Events": [
"InventoryRetrievalCompleted",
"ArchiveRetrievalCompleted"
],
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault"
}
}
```
Wenn keine Benachrichtigungen für den Tresor konfiguriert wurden, wird ein Fehler zurückgegeben. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [GetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-notifications.html)in der *AWS CLI Befehlsreferenz*.
### `initiate-job`
Das folgende Codebeispiel zeigt die Verwendung`initiate-job`.
**AWS CLI**
Mit dem folgenden Befehl wird ein Auftrag zum Abrufen eines Bestands des Tresors `my-vault` eingeleitet:
```
aws glacier initiate{{-}}job --account-id - --vault-name {{my-vault}} --job-parameters '{{{"Type": "inventory-retrieval"}}}'
```
Ausgabe:
```
{
"location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
"jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW"
}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
Mit dem folgenden Befehl wird ein Auftrag zum Abrufen eines Archivs des Tresors `my-vault` eingeleitet:
```
aws glacier initiate{{-}}job --account-id - --vault-name {{my-vault}} --job-parameters {{file://job-archive-retrieval.json}}
```
`job-archive-retrieval.json` ist eine JSON-Datei im lokalen Ordner, die den Auftragstyp, die Archiv-ID und einige optionale Parameter angibt:
```
{
"Type": "archive-retrieval",
"ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
"Description": "Retrieve archive on 2015-07-17",
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-topic"
}
```
Archive IDs sind in der Ausgabe von `aws glacier upload-archive` und verfügbar`aws glacier get-job-output`.
Ausgabe:
```
{
"location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
"jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav"
}
```
Details zum Format der Auftragsparameter finden Sie unter „Einleiten eines Auftrags“ in der *API-Referenz zu Amazon Glacier*.
+ Einzelheiten zur API finden Sie [InitiateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-job.html)in der *AWS CLI Befehlsreferenz*.
### `initiate-multipart-upload`
Das folgende Codebeispiel zeigt die Verwendung`initiate-multipart-upload`.
**AWS CLI**
Mit dem folgenden Befehl wird ein mehrteiliger Upload in einen Tresor namens `my-vault` mit einer Teilgröße von 1 MiB (1 024 x 1 024 Byte) pro Datei eingeleitet:
```
aws glacier initiate{{-}}multipart-upload --account-id - --part-size {{1048576}} --vault-name {{my-vault}} --archive-description {{"multipart upload test"}}
```
Der Parameter für die Archivbeschreibung ist optional. Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
Dieser Befehl gibt bei Erfolg eine Upload-ID aus. Verwenden Sie die Upload-ID, wenn Sie jeden Teil Ihres Archivs mit `aws glacier upload-multipart-part` hochladen. Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [InitiateMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-multipart-upload.html)in der *AWS CLI Befehlsreferenz*.
### `initiate-vault-lock`
Das folgende Codebeispiel zeigt die Verwendung`initiate-vault-lock`.
**AWS CLI**
**So leiten Sie den Tresorverriegelungsprozess ein**
Im folgenden Beispiel für `initiate-vault-lock` wird eine Tresorverriegelungsrichtlinie für den angegebenen Tresor installiert und der Sperrstatus der Tresorverriegelung auf `InProgress` festgelegt. Sie müssen den Prozess innerhalb von 24 Stunden abschließen, indem Sie `complete-vault-lock` aufrufen, um den Status der Tresorverriegelung auf `Locked` festzulegen.
```
aws glacier initiate{{-}}vault-lock \
--account-id - \
--vault-name {{MyVaultName}} \
--policy {{file://vault_lock_policy.json}}
```
Inhalt von `vault_lock_policy.json`:
```
{"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}
```
Die Ausgabe ist die Tresorverriegelungs-ID, mit der Sie den Tresorverriegelungsprozess abschließen können.
```
{
"lockId": "9QZgEXAMPLEPhvL6xEXAMPLE"
}
```
Weitere Informationen finden Sie unter [Einleiten der Tresorverriegelung (POST lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-InitiateVaultLock.html) im *Entwicklerhandbuch für die Amazon-Glacier-API*.
+ Einzelheiten zur API finden Sie [InitiateVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-vault-lock.html)in der *AWS CLI Befehlsreferenz*.
### `list-jobs`
Das folgende Codebeispiel zeigt die Verwendung`list-jobs`.
**AWS CLI**
Der folgende Befehl listet laufende und kürzlich abgeschlossene Aufträge für einen Tresor mit dem Namen `my-vault` auf:
```
aws glacier list{{-}}jobs --account-id - --vault-name {{my-vault}}
```
Ausgabe:
```
{
"JobList": [
{
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"RetrievalByteRange": "0-3145727",
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
"Completed": false,
"SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
"JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
"ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
"JobDescription": "Retrieve archive on 2015-07-17",
"ArchiveSizeInBytes": 3145728,
"Action": "ArchiveRetrieval",
"ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
"CreationDate": "2015-07-17T21:16:13.840Z",
"StatusCode": "InProgress"
},
{
"InventoryRetrievalParameters": {
"Format": "JSON"
},
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"Completed": false,
"JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
"Action": "InventoryRetrieval",
"CreationDate": "2015-07-17T20:23:41.616Z",
"StatusCode": ""InProgress""
}
]
}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-jobs.html)in der *AWS CLI Befehlsreferenz*.
### `list-multipart-uploads`
Das folgende Codebeispiel zeigt die Verwendung`list-multipart-uploads`.
**AWS CLI**
Mit dem folgenden Befehl werden alle laufenden mehrteiligen Uploads für einen Tresor namens `my-vault` angezeigt:
```
aws glacier list{{-}}multipart-uploads --account-id - --vault-name {{my-vault}}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListMultipartUploads](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-multipart-uploads.html)in der *AWS CLI Befehlsreferenz*.
### `list-parts`
Das folgende Codebeispiel zeigt die Verwendung`list-parts`.
**AWS CLI**
Mit dem folgenden Befehl werden die hochgeladenen Teile für einen mehrteiligen Upload in einen Tresor namens `my-vault` aufgelistet:
```
aws glacier list{{-}}parts --account-id - --vault-name {{my-vault}} --upload-id {{"SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"}}
```
Ausgabe:
```
{
"MultipartUploadId": "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D",
"Parts": [
{
"RangeInBytes": "0-1048575",
"SHA256TreeHash": "e1f2a7cd6e047350f69b9f8cfa60fa606fe2f02802097a9a026360a7edc1f553"
},
{
"RangeInBytes": "1048576-2097151",
"SHA256TreeHash": "43cf3061fb95796aed99a11a6aa3cd8f839eed15e655ab0a597126210636aee6"
}
],
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"CreationDate": "2015-07-18T00:05:23.830Z",
"PartSizeInBytes": 1048576
}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [ListParts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-parts.html)in der *AWS CLI Befehlsreferenz*.
### `list-provisioned-capacity`
Das folgende Codebeispiel zeigt die Verwendung`list-provisioned-capacity`.
**AWS CLI**
**So rufen Sie die bereitgestellten Kapazitätseinheiten ab**
Im folgenden Beispiel für `list-provisioned-capacity` werden Details zu allen bereitgestellten Kapazitätseinheiten für das angegebene Konto abgerufen.
```
aws glacier list-provisioned-capacity \
--account-id {{111122223333}}
```
Ausgabe:
```
{
"ProvisionedCapacityList": [
{
"CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K",
"ExpirationDate": "2020-03-18T19:59:24.000Z",
"StartDate": "2020-02-18T19:59:24.912Z"
}
]
}
```
+ Einzelheiten zur API finden Sie [ListProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-provisioned-capacity.html)in der *AWS CLI Befehlsreferenz*.
### `list-tags-for-vault`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-vault`.
**AWS CLI**
Der folgende Befehl listet die Tags auf, die auf einen Tresor mit dem Namen `my-vault` angewendet wurden:
```
aws glacier list{{-}}tags-for-vault --account-id - --vault-name {{my-vault}}
```
Ausgabe:
```
{
"Tags": {
"date": "july2015",
"id": "1234"
}
}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [ListTagsForVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-tags-for-vault.html)in der *AWS CLI Befehlsreferenz*.
### `list-vaults`
Das folgende Codebeispiel zeigt die Verwendung`list-vaults`.
**AWS CLI**
Der folgende Befehl listet die Tresore im Standardkonto und der Standardregion auf:
```
aws glacier list{{-}}vaults --account-id -
```
Ausgabe:
```
{
"VaultList": [
{
"SizeInBytes": 3178496,
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"LastInventoryDate": "2015-04-07T00:26:19.028Z",
"VaultName": "my-vault",
"NumberOfArchives": 1,
"CreationDate": "2015-04-06T21:23:45.708Z"
}
]
}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [ListVaults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-vaults.html)in der *AWS CLI Befehlsreferenz*.
### `purchase-provisioned-capacity`
Das folgende Codebeispiel zeigt die Verwendung`purchase-provisioned-capacity`.
**AWS CLI**
**So erwerben Sie eine bereitgestellte Kapazitätseinheit**
Im folgenden Beispiel für `purchase-provisioned-capacity` wird eine bereitgestellte Kapazitätseinheit erworben.
```
aws glacier purchase-provisioned-capacity \
--account-id {{111122223333}}
```
Ausgabe:
```
{
"capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}
```
+ Einzelheiten zur API finden Sie [PurchaseProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/purchase-provisioned-capacity.html)in der *AWS CLI Befehlsreferenz*.
### `remove-tags-from-vault`
Das folgende Codebeispiel zeigt die Verwendung`remove-tags-from-vault`.
**AWS CLI**
Mit dem folgenden Befehl wird ein Tag mit dem Schlüssel `date` aus einem Tresor namens `my-vault` entfernt:
```
aws glacier remove{{-}}tags-from-vault --account-id - --vault-name {{my-vault}} --tag-keys {{date}}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [RemoveTagsFromVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/remove-tags-from-vault.html)in der *AWS CLI Befehlsreferenz*.
### `set-data-retrieval-policy`
Das folgende Codebeispiel zeigt die Verwendung`set-data-retrieval-policy`.
**AWS CLI**
Mit dem folgenden Befehl wird eine Datenabrufrichtlinie für das verwendete Konto konfiguriert:
```
aws glacier set{{-}}data-retrieval-policy --account-id - --policy {{file://data-retrieval-policy.json}}
```
`data-retrieval-policy.json` ist eine JSON-Datei im aktuellen Ordner, die eine Datenabrufrichtlinie angibt:
```
{
"Rules":[
{
"Strategy":"BytesPerHour",
"BytesPerHour":10737418240
}
]
}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
Mit dem folgenden Befehl wird die Datenabrufrichtlinie mithilfe von Inline-JSON auf `FreeTier` festgelegt:
```
aws glacier set{{-}}data-retrieval-policy --account-id - --policy '{{{"Rules":[{"Strategy":"FreeTier"}]}}}'
```
Details zum Richtlinienformat finden Sie unter „Festlegen einer Datenabrufrichtlinie“ in der *API-Referenz zu Amazon Glacier*.
+ Einzelheiten zur API finden Sie [SetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-data-retrieval-policy.html)in der *AWS CLI Befehlsreferenz*.
### `set-vault-access-policy`
Das folgende Codebeispiel zeigt die Verwendung`set-vault-access-policy`.
**AWS CLI**
**So legen Sie die Zugriffsrichtlinie eines Tresors fest**
Im folgenden Beispiel für `set-vault-access-policy` wird eine Berechtigungsrichtlinie an den angegebenen Tresor angehängt.
```
aws glacier set-vault-access-policy \
--account-id {{111122223333}} \
--vault-name {{example_vault}}
--policy '{{{"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"}}}'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [SetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-access-policy.html)in der *AWS CLI Befehlsreferenz*.
### `set-vault-notifications`
Das folgende Codebeispiel zeigt die Verwendung`set-vault-notifications`.
**AWS CLI**
Der folgende Befehl konfiguriert SNS-Benachrichtigungen für einen Tresor mit dem Namen `my-vault`:
```
aws glacier set{{-}}vault-notifications --account-id - --vault-name {{my-vault}} --vault-notification-config {{file://notificationconfig.json}}
```
`notificationconfig.json` ist eine JSON-Datei im aktuellen Ordner, die ein SNS-Thema und die zu veröffentlichenden Ereignisse angibt:
```
{
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
"Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"]
}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
+ Einzelheiten zur API finden Sie [SetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-notifications.html)in der *AWS CLI Befehlsreferenz*.
### `upload-archive`
Das folgende Codebeispiel zeigt die Verwendung`upload-archive`.
**AWS CLI**
Der folgende Befehl lädt ein Archiv im aktuellen Ordner mit dem Namen `archive.zip` in einen Tresor mit dem Namen `my-vault` hoch:
```
aws glacier upload{{-}}archive --account-id - --vault-name {{my-vault}} --body {{archive.zip}}
```
Ausgabe:
```
{
"archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
"checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67",
"location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw"
}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
Um ein hochgeladenes Archiv abzurufen, initiieren Sie einen Abrufauftrag mit dem Befehl aws glacier initiate-job.
+ Einzelheiten zur API finden Sie [UploadArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-archive.html)in der *AWS CLI Befehlsreferenz*.
### `upload-multipart-part`
Das folgende Codebeispiel zeigt die Verwendung`upload-multipart-part`.
**AWS CLI**
Der folgende Befehl lädt den ersten, 1 MiB (1024 x 1024 Byte) umfassenden Teil eines Archivs hoch:
```
aws glacier upload-multipart-part --body {{part1}} --range '{{bytes 0-1048575/*}}' {{-}}-account-id - --vault-name {{my-vault}} --upload-id {{19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ}}
```
Amazon Glacier benötigt bei der Durchführung von Operationen ein Konto-ID-Argument, Sie können jedoch einen Bindestrich verwenden, um das verwendete Konto anzugeben.
Der Parameter „body“ nimmt einen Pfad zu einer Teildatei im lokalen Dateisystem an. Der Parameter „range“ nimmt einen HTTP-Inhaltsbereich an, der die Byte angibt, die der Teil im fertigen Archiv belegt. Die Upload-ID wird vom Befehl `aws glacier initiate-multipart-upload` zurückgegeben und kann auch mithilfe von `aws glacier list-multipart-uploads` abgerufen werden.
Weitere Informationen zu mehrteiligen Uploads auf Amazon Glacier mithilfe der AWS CLI finden Sie unter Verwenden von Amazon Glacier im *AWS CLI-Benutzerhandbuch*.
+ Einzelheiten zur API finden Sie [UploadMultipartPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html)in der *AWS CLI Befehlsreferenz*.