

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Contoh Amazon Glacier menggunakan AWS CLI
<a name="cli_glacier_code_examples"></a>

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan Amazon Glacier. AWS Command Line Interface 

*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

**Topics**
+ [Tindakan](#actions)

## Tindakan
<a name="actions"></a>

### `abort-multipart-upload`
<a name="glacier_AbortMultipartUpload_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`abort-multipart-upload`.

**AWS CLI**  
Perintah berikut menghapus unggahan multipart yang sedang berlangsung ke vault bernama: `my-vault`  

```
aws glacier abort{{-}}multipart-upload --account-id - --vault-name {{my-vault}} --upload-id {{19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ}}
```
Perintah ini tidak menghasilkan output apa pun. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan. ID unggahan dikembalikan oleh `aws glacier initiate-multipart-upload` perintah dan juga dapat diperoleh dengan menggunakan`aws glacier list-multipart-uploads`.  
*Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan CLI, lihat Menggunakan Amazon Glacier AWS di Panduan Pengguna CLI.AWS *  
+  Untuk detail API, lihat [AbortMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-multipart-upload.html)di *Referensi AWS CLI Perintah*. 

### `abort-vault-lock`
<a name="glacier_AbortVaultLock_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`abort-vault-lock`.

**AWS CLI**  
**Untuk membatalkan proses penguncian vault yang sedang berlangsung**  
`abort-vault-lock`Contoh berikut menghapus kebijakan kunci vault dari vault yang ditentukan dan mengatur ulang status kunci kunci vault menjadi tidak terkunci.  

```
aws glacier abort{{-}}vault-lock \
    --account-id - \
    --vault-name {{MyVaultName}}
```
Perintah ini tidak menghasilkan output.  
*Untuk informasi selengkapnya, lihat [Batalkan Kunci Vault (HAPUS kebijakan kunci)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-AbortVaultLock.html) di Panduan Pengembang Amazon Glacier API.*  
+  Untuk detail API, lihat [AbortVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-vault-lock.html)di *Referensi AWS CLI Perintah*. 

### `add-tags-to-vault`
<a name="glacier_AddTagsToVault_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`add-tags-to-vault`.

**AWS CLI**  
Perintah berikut menambahkan dua tag ke vault bernama`my-vault`:  

```
aws glacier add{{-}}tags-to-vault --account-id - --vault-name {{my-vault}} --tags {{id=1234,date=july2015}}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [AddTagsToVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/add-tags-to-vault.html)di *Referensi AWS CLI Perintah*. 

### `complete-multipart-upload`
<a name="glacier_CompleteMultipartUpload_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`complete-multipart-upload`.

**AWS CLI**  
Perintah berikut menyelesaikan unggahan multipart untuk arsip 3 MiB:  

```
aws glacier complete-multipart-upload --archive-size {{3145728}} --checksum {{9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67}} --upload-id {{19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ}} {{-}}-account-id - --vault-name {{my-vault}}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
ID unggahan dikembalikan oleh `aws glacier initiate-multipart-upload` perintah dan juga dapat diperoleh dengan menggunakan`aws glacier list-multipart-uploads`. Parameter checksum mengambil hash pohon SHA-256 dari arsip dalam heksadesimal.  
*Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan AWS CLI, termasuk petunjuk cara menghitung hash pohon, lihat Menggunakan Amazon Glacier di Panduan Pengguna CLI.AWS *  
+  Untuk detail API, lihat [CompleteMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-multipart-upload.html)di *Referensi AWS CLI Perintah*. 

### `complete-vault-lock`
<a name="glacier_CompleteVaultLock_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`complete-vault-lock`.

**AWS CLI**  
**Untuk menyelesaikan proses penguncian vault yang sedang berlangsung**  
`complete-vault-lock`Contoh berikut melengkapi progres penguncian yang sedang berlangsung untuk vault yang ditentukan dan menyetel status kunci kunci vault ke. `Locked` Anda mendapatkan nilai untuk `lock-id` parameter saat Anda menjalankan`initiate-lock-process`.  

```
aws glacier complete{{-}}vault-lock \
    --account-id - \
    --vault-name {{MyVaultName}} \
    --lock-id {{9QZgEXAMPLEPhvL6xEXAMPLE}}
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Complete Vault Lock (POST LocKid](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-CompleteVaultLock.html)) di Panduan Pengembang *Amazon Glacier API*.  
+  Untuk detail API, lihat [CompleteVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-vault-lock.html)di *Referensi AWS CLI Perintah*. 

### `create-vault`
<a name="glacier_CreateVault_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`create-vault`.

**AWS CLI**  
Perintah berikut membuat vault baru bernama`my-vault`:  

```
aws glacier create-vault --vault-name {{my-vault}} {{-}}-account-id -
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [CreateVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/create-vault.html)di *Referensi AWS CLI Perintah*. 

### `delete-archive`
<a name="glacier_DeleteArchive_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`delete-archive`.

**AWS CLI**  
**Untuk menghapus arsip dari vault**  
`delete-archive`Contoh berikut menghapus arsip yang ditentukan dari`example_vault`.  

```
aws glacier delete-archive \
    --account-id {{111122223333}}  \
    --vault-name {{example_vault}} \
    --archive-id {{Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w}}
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [DeleteArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-archive.html)di *Referensi AWS CLI Perintah*. 

### `delete-vault-access-policy`
<a name="glacier_DeleteVaultAccessPolicy_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`delete-vault-access-policy`.

**AWS CLI**  
**Untuk menghapus kebijakan akses vault**  
`delete-vault-access-policy`Contoh berikut menghapus kebijakan akses untuk vault yang ditentukan.  

```
aws glacier delete-vault-access-policy \
    --account-id {{111122223333}} \
    --vault-name {{example_vault}}
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [DeleteVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-access-policy.html)di *Referensi AWS CLI Perintah*. 

### `delete-vault-notifications`
<a name="glacier_DeleteVaultNotifications_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`delete-vault-notifications`.

**AWS CLI**  
**Untuk menghapus notifikasi SNS untuk vault**  
`delete-vault-notifications`Contoh berikut menghapus notifikasi yang dikirim oleh Amazon Simple Notification Service (Amazon SNS) untuk vault yang ditentukan.  

```
aws glacier delete-vault-notifications \
    --account-id {{111122223333}} \
    --vault-name {{example_vault}}
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [DeleteVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-notifications.html)di *Referensi AWS CLI Perintah*. 

### `delete-vault`
<a name="glacier_DeleteVault_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`delete-vault`.

**AWS CLI**  
Perintah berikut menghapus vault bernama: `my-vault`  

```
aws glacier delete-vault --vault-name {{my-vault}} {{-}}-account-id -
```
Perintah ini tidak menghasilkan output apa pun. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [DeleteVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault.html)di *Referensi AWS CLI Perintah*. 

### `describe-job`
<a name="glacier_DescribeJob_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`describe-job`.

**AWS CLI**  
Perintah berikut mengambil informasi tentang pekerjaan pengambilan inventaris pada vault bernama: `my-vault`  

```
aws glacier describe{{-}}job --account-id - --vault-name {{my-vault}} --job-id {{zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW}}
```
Output:  

```
{
    "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"
}
```
ID pekerjaan dapat ditemukan di output `aws glacier initiate-job` dan`aws glacier list-jobs`. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-job.html)di *Referensi AWS CLI Perintah*. 

### `describe-vault`
<a name="glacier_DescribeVault_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`describe-vault`.

**AWS CLI**  
Perintah berikut mengambil data tentang vault bernama: `my-vault`  

```
aws glacier describe-vault --vault-name {{my-vault}} {{-}}-account-id -
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [DescribeVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-vault.html)di *Referensi AWS CLI Perintah*. 

### `get-data-retrieval-policy`
<a name="glacier_GetDataRetrievalPolicy_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`get-data-retrieval-policy`.

**AWS CLI**  
Perintah berikut mendapatkan kebijakan pengambilan data untuk akun yang sedang digunakan:  

```
aws glacier get{{-}}data-retrieval-policy --account-id -
```
Output:  

```
{
    "Policy": {
        "Rules": [
            {
                "BytesPerHour": 10737418240,
                "Strategy": "BytesPerHour"
            }
        ]
    }
}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [GetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-data-retrieval-policy.html)di *Referensi AWS CLI Perintah*. 

### `get-job-output`
<a name="glacier_GetJobOutput_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`get-job-output`.

**AWS CLI**  
Perintah berikut menyimpan output dari pekerjaan inventaris vault ke file di direktori saat ini bernama`output.json`:  

```
aws glacier get{{-}}job-output --account-id - --vault-name {{my-vault}} --job-id {{zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW}} {{output.json}}
```
`job-id`Tersedia dalam output dari`aws glacier list-jobs`. Perhatikan bahwa nama file output adalah argumen posisi yang tidak diawali dengan nama opsi. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
Output:  

```
{
    "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"}]}
```
+  Untuk detail API, lihat [GetJobOutput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-job-output.html)di *Referensi AWS CLI Perintah*. 

### `get-vault-access-policy`
<a name="glacier_GetVaultAccessPolicy_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`get-vault-access-policy`.

**AWS CLI**  
**Untuk mengambil kebijakan akses vault**  
`get-vault-access-policy`Contoh berikut mengambil kebijakan akses untuk vault yang ditentukan.  

```
aws glacier get-vault-access-policy \
    --account-id {{111122223333}} \
    --vault-name {{example_vault}}
```
Output:  

```
{
    "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\"}]}"
    }
}
```
+  Untuk detail API, lihat [GetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-access-policy.html)di *Referensi AWS CLI Perintah*. 

### `get-vault-lock`
<a name="glacier_GetVaultLock_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`get-vault-lock`.

**AWS CLI**  
**Untuk mendapatkan detail kunci brankas**  
`get-vault-lock`Contoh berikut mengambil detail tentang kunci untuk brankas yang ditentukan.  

```
aws glacier get{{-}}vault-lock \
    --account-id - \
    --vault-name {{MyVaultName}}
```
Output:  

```
{
    "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"
}
```
Untuk informasi selengkapnya, lihat [Mendapatkan Kunci Vault (kebijakan kunci GET)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-GetVaultLock.html) di Panduan Pengembang *Amazon* Glacier API.  
+  Untuk detail API, lihat [GetVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-lock.html)di *Referensi AWS CLI Perintah*. 

### `get-vault-notifications`
<a name="glacier_GetVaultNotifications_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`get-vault-notifications`.

**AWS CLI**  
Perintah berikut mendapatkan deskripsi konfigurasi notifikasi untuk vault bernama`my-vault`:  

```
aws glacier get{{-}}vault-notifications --account-id - --vault-name {{my-vault}}
```
Output:  

```
{
    "vaultNotificationConfig": {
        "Events": [
            "InventoryRetrievalCompleted",
            "ArchiveRetrievalCompleted"
        ],
        "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault"
    }
}
```
Jika tidak ada pemberitahuan yang dikonfigurasi untuk brankas, kesalahan akan dikembalikan. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [GetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-notifications.html)di *Referensi AWS CLI Perintah*. 

### `initiate-job`
<a name="glacier_InitiateJob_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`initiate-job`.

**AWS CLI**  
Perintah berikut memulai pekerjaan untuk mendapatkan inventaris `my-vault` vault:  

```
aws glacier initiate{{-}}job --account-id - --vault-name {{my-vault}} --job-parameters '{{{"Type": "inventory-retrieval"}}}'
```
Output:  

```
{
    "location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
    "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW"
}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
Perintah berikut memulai pekerjaan untuk mengambil arsip dari vault: `my-vault`  

```
aws glacier initiate{{-}}job --account-id - --vault-name {{my-vault}} --job-parameters {{file://job-archive-retrieval.json}}
```
`job-archive-retrieval.json`adalah file JSON di folder lokal yang menentukan jenis pekerjaan, ID arsip, dan beberapa parameter opsional:  

```
{
  "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"
}
```
Arsip IDs tersedia dalam output `aws glacier upload-archive` dan`aws glacier get-job-output`.  
Output:  

```
{
    "location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
    "jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav"
}
```
Lihat Memulai Pekerjaan di *Referensi Amazon Glacier* API untuk detail tentang format parameter pekerjaan.  
+  Untuk detail API, lihat [InitiateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-job.html)di *Referensi AWS CLI Perintah*. 

### `initiate-multipart-upload`
<a name="glacier_InitiateMultipartUpload_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`initiate-multipart-upload`.

**AWS CLI**  
Perintah berikut memulai unggahan multipart ke vault bernama `my-vault` dengan ukuran bagian 1 MiB (1024 x 1024 byte) per file:  

```
aws glacier initiate{{-}}multipart-upload --account-id - --part-size {{1048576}} --vault-name {{my-vault}} --archive-description {{"multipart upload test"}}
```
Parameter deskripsi arsip adalah opsional. Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
Perintah ini mengeluarkan ID unggahan saat berhasil. Gunakan ID unggahan saat mengunggah setiap bagian arsip Anda. `aws glacier upload-multipart-part` *Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan CLI, lihat Menggunakan Amazon Glacier AWS di Panduan Pengguna CLI.AWS *  
+  Untuk detail API, lihat [InitiateMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-multipart-upload.html)di *Referensi AWS CLI Perintah*. 

### `initiate-vault-lock`
<a name="glacier_InitiateVaultLock_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`initiate-vault-lock`.

**AWS CLI**  
**Untuk memulai proses penguncian vault**  
`initiate-vault-lock`Contoh berikut menginstal kebijakan kunci vault pada vault yang ditentukan dan menyetel status kunci kunci vault ke. `InProgress` Anda harus menyelesaikan proses dengan menelepon `complete-vault-lock` dalam waktu 24 jam untuk mengatur status kunci brankas. `Locked`  

```
aws glacier initiate{{-}}vault-lock \
    --account-id - \
    --vault-name {{MyVaultName}} \
    --policy {{file://vault_lock_policy.json}}
```
Isi dari `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\"}}}]}"}
```
Outputnya adalah ID kunci vault yang dapat Anda gunakan untuk menyelesaikan proses penguncian vault.  

```
{
    "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE"
}
```
*Untuk informasi selengkapnya, lihat [Memulai Kunci Vault (kebijakan penguncian POST)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-InitiateVaultLock.html) di Panduan Pengembang Amazon Glacier API.*  
+  Untuk detail API, lihat [InitiateVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-vault-lock.html)di *Referensi AWS CLI Perintah*. 

### `list-jobs`
<a name="glacier_ListJobs_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-jobs`.

**AWS CLI**  
Perintah berikut mencantumkan pekerjaan yang sedang berlangsung dan baru saja diselesaikan untuk vault bernama: `my-vault`  

```
aws glacier list{{-}}jobs --account-id - --vault-name {{my-vault}}
```
Output:  

```
{
    "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 memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-jobs.html)di *Referensi AWS CLI Perintah*. 

### `list-multipart-uploads`
<a name="glacier_ListMultipartUploads_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-multipart-uploads`.

**AWS CLI**  
Perintah berikut menunjukkan semua unggahan multipart yang sedang berlangsung untuk vault bernama: `my-vault`  

```
aws glacier list{{-}}multipart-uploads --account-id - --vault-name {{my-vault}}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
*Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan CLI, lihat Menggunakan Amazon Glacier AWS di Panduan Pengguna CLI.AWS *  
+  Untuk detail API, lihat [ListMultipartUploads](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-multipart-uploads.html)di *Referensi AWS CLI Perintah*. 

### `list-parts`
<a name="glacier_ListParts_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-parts`.

**AWS CLI**  
Perintah berikut mencantumkan bagian yang diunggah untuk unggahan multibagian ke vault bernama: `my-vault`  

```
aws glacier list{{-}}parts --account-id - --vault-name {{my-vault}} --upload-id {{"SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"}}
```
Output:  

```
{
    "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 memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
*Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan CLI, lihat Menggunakan Amazon Glacier AWS di Panduan Pengguna CLI.AWS *  
+  Untuk detail API, lihat [ListParts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-parts.html)di *Referensi AWS CLI Perintah*. 

### `list-provisioned-capacity`
<a name="glacier_ListProvisionedCapacity_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-provisioned-capacity`.

**AWS CLI**  
**Untuk mengambil unit kapasitas yang disediakan**  
`list-provisioned-capacity`Contoh berikut mengambil rincian untuk setiap unit kapasitas yang disediakan untuk akun yang ditentukan.  

```
aws glacier list-provisioned-capacity \
    --account-id {{111122223333}}
```
Output:  

```
{
    "ProvisionedCapacityList": [
        {
            "CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K",
            "ExpirationDate": "2020-03-18T19:59:24.000Z",
            "StartDate": "2020-02-18T19:59:24.912Z"
        }
    ]
}
```
+  Untuk detail API, lihat [ListProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-provisioned-capacity.html)di *Referensi AWS CLI Perintah*. 

### `list-tags-for-vault`
<a name="glacier_ListTagsForVault_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-tags-for-vault`.

**AWS CLI**  
Perintah berikut mencantumkan tag yang diterapkan ke vault bernama`my-vault`:  

```
aws glacier list{{-}}tags-for-vault --account-id - --vault-name {{my-vault}}
```
Output:  

```
{
    "Tags": {
        "date": "july2015",
        "id": "1234"
    }
}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [ListTagsForVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-tags-for-vault.html)di *Referensi AWS CLI Perintah*. 

### `list-vaults`
<a name="glacier_ListVaults_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-vaults`.

**AWS CLI**  
Perintah berikut mencantumkan vault di akun dan wilayah default:  

```
aws glacier list{{-}}vaults --account-id -
```
Output:  

```
{
    "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 memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [ListVaults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-vaults.html)di *Referensi AWS CLI Perintah*. 

### `purchase-provisioned-capacity`
<a name="glacier_PurchaseProvisionedCapacity_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`purchase-provisioned-capacity`.

**AWS CLI**  
**Untuk membeli unit kapasitas yang disediakan**  
`purchase-provisioned-capacity`Contoh berikut membeli unit kapasitas yang disediakan.  

```
aws glacier purchase-provisioned-capacity \
    --account-id {{111122223333}}
```
Output:  

```
{
    "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}
```
+  Untuk detail API, lihat [PurchaseProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/purchase-provisioned-capacity.html)di *Referensi AWS CLI Perintah*. 

### `remove-tags-from-vault`
<a name="glacier_RemoveTagsFromVault_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`remove-tags-from-vault`.

**AWS CLI**  
Perintah berikut menghapus tag dengan kunci `date` dari vault bernama`my-vault`:  

```
aws glacier remove{{-}}tags-from-vault --account-id - --vault-name {{my-vault}} --tag-keys {{date}}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [RemoveTagsFromVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/remove-tags-from-vault.html)di *Referensi AWS CLI Perintah*. 

### `set-data-retrieval-policy`
<a name="glacier_SetDataRetrievalPolicy_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`set-data-retrieval-policy`.

**AWS CLI**  
Perintah berikut mengonfigurasi kebijakan pengambilan data untuk akun yang sedang digunakan:  

```
aws glacier set{{-}}data-retrieval-policy --account-id - --policy {{file://data-retrieval-policy.json}}
```
`data-retrieval-policy.json`adalah file JSON di folder saat ini yang menentukan kebijakan pengambilan data:  

```
{
  "Rules":[
     {
         "Strategy":"BytesPerHour",
         "BytesPerHour":10737418240
      }
   ]
}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
Perintah berikut menetapkan kebijakan pengambilan data untuk `FreeTier` menggunakan JSON inline:  

```
aws glacier set{{-}}data-retrieval-policy --account-id - --policy '{{{"Rules":[{"Strategy":"FreeTier"}]}}}'
```
Lihat Menyetel Kebijakan Pengambilan Data di *Referensi API Amazon Glacier* untuk detail tentang format kebijakan.  
+  Untuk detail API, lihat [SetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-data-retrieval-policy.html)di *Referensi AWS CLI Perintah*. 

### `set-vault-access-policy`
<a name="glacier_SetVaultAccessPolicy_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`set-vault-access-policy`.

**AWS CLI**  
**Untuk menyetel kebijakan akses vault**  
`set-vault-access-policy`Contoh berikut melampirkan kebijakan izin ke vault yang ditentukan.  

```
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\"}]}"}}}'
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [SetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-access-policy.html)di *Referensi AWS CLI Perintah*. 

### `set-vault-notifications`
<a name="glacier_SetVaultNotifications_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`set-vault-notifications`.

**AWS CLI**  
Perintah berikut mengonfigurasi notifikasi SNS untuk vault bernama: `my-vault`  

```
aws glacier set{{-}}vault-notifications --account-id - --vault-name {{my-vault}} --vault-notification-config {{file://notificationconfig.json}}
```
`notificationconfig.json`adalah file JSON di folder saat ini yang menentukan topik SNS dan peristiwa yang akan dipublikasikan:  

```
{
  "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
  "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"]
}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
+  Untuk detail API, lihat [SetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-notifications.html)di *Referensi AWS CLI Perintah*. 

### `upload-archive`
<a name="glacier_UploadArchive_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`upload-archive`.

**AWS CLI**  
Perintah berikut mengunggah arsip di folder saat ini bernama `archive.zip` ke vault bernama: `my-vault`  

```
aws glacier upload{{-}}archive --account-id - --vault-name {{my-vault}} --body {{archive.zip}}
```
Output:  

```
{
    "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
    "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67",
    "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw"
}
```
Amazon Glacier memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
Untuk mengambil arsip yang diunggah, mulailah pekerjaan pengambilan dengan perintah aws glacier initiate-job.  
+  Untuk detail API, lihat [UploadArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-archive.html)di *Referensi AWS CLI Perintah*. 

### `upload-multipart-part`
<a name="glacier_UploadMultipartPart_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`upload-multipart-part`.

**AWS CLI**  
Perintah berikut mengunggah bagian 1 MiB (1024 x 1024 byte) pertama dari sebuah arsip:  

```
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 memerlukan argumen ID akun saat melakukan operasi, tetapi Anda dapat menggunakan tanda hubung untuk menentukan akun yang sedang digunakan.  
Parameter body mengambil jalur ke file bagian pada sistem file lokal. Parameter rentang mengambil rentang konten HTTP yang menunjukkan byte yang ditempati bagian dalam arsip yang lengkap. ID unggahan dikembalikan oleh `aws glacier initiate-multipart-upload` perintah dan juga dapat diperoleh dengan menggunakan`aws glacier list-multipart-uploads`.  
*Untuk informasi selengkapnya tentang unggahan multipart ke Amazon Glacier menggunakan CLI, lihat Menggunakan Amazon Glacier AWS di Panduan Pengguna CLI.AWS *  
+  Untuk detail API, lihat [UploadMultipartPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html)di *Referensi AWS CLI Perintah*. 