

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