

 **Halaman ini hanya untuk pelanggan lama layanan Amazon Glacier menggunakan Vaults dan REST API asli dari 2012.**

Jika Anda mencari solusi penyimpanan arsip, sebaiknya gunakan kelas penyimpanan Amazon Glacier di Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat kelas penyimpanan [Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak lagi menerima pelanggan baru. Amazon Glacier adalah layanan mandiri dengan miliknya APIs sendiri yang menyimpan data di brankas dan berbeda dari Amazon S3 dan kelas penyimpanan Amazon S3 Glacier. Data Anda yang ada akan tetap aman dan dapat diakses di Amazon Glacier tanpa batas waktu. Tidak diperlukan migrasi. Untuk penyimpanan arsip jangka panjang berbiaya rendah, AWS rekomendasikan kelas [penyimpanan Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), yang memberikan pengalaman pelanggan yang unggul dengan APIs berbasis ember S3, ketersediaan penuh, biaya lebih rendah, Wilayah AWS dan integrasi layanan. AWS Jika Anda ingin meningkatkan kemampuan, pertimbangkan untuk bermigrasi ke kelas penyimpanan Amazon S3 Glacier dengan menggunakan [Panduan Solusi AWS kami untuk mentransfer data dari kubah Amazon Glacier ke kelas penyimpanan Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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

# Memulai Kunci Vault (POST lock-policy)
<a name="api-InitiateVaultLock"></a>

## Deskripsi
<a name="api-InitiateVaultLock-description"></a>

Operasi ini memulai proses penguncian vault dengan melakukan hal berikut: 
+ Menempatkan kebijakan kunci vault di vault yang ditentukan.
+ Mengatur status kunci dari kunci vault ke `InProgress`.
+ Mengembalikan ID kunci, yang digunakan untuk menyelesaikan proses penguncian vault. 

Anda dapat menetapkan satu kebijakan kunci vault untuk setiap vault dan kebijakan ini dapat berukuran hingga 20 KB. Untuk informasi selengkapnya tentang kebijakan kunci vault, lihat [Kebijakan Vault Lock](vault-lock-policy.md).

Anda harus menyelesaikan proses penguncian vault dalam waktu 24 jam setelah kunci vault memasuki status `InProgress`. Setelah 24 jam berakhir, ID kunci akan kedaluwarsa, vault secara otomatis keluar dari status `InProgress`, dan kebijakan kunci vault dihapus dari vault. Anda memanggil [Menyelesaikan Kunci Vault (POST lockId)](api-CompleteVaultLock.md) untuk menyelesaikan proses penguncian vault dengan menetapkan status kunci vault ke `Locked`. 

**catatan**  
Setelah kunci vault berada dalam status `Locked`, Anda tidak dapat memulai kunci vault baru untuk vault.

Anda dapat menghentikan proses penguncian vault dengan memanggil [Membatalkan Kunci Vault (DELETE lock-policy)](api-AbortVaultLock.md). Anda bisa mendapatkan status kunci vault dengan memanggil [Mendapatkan Kunci Vault (GET lock-policy)](api-GetVaultLock.md). Untuk informasi selengkapnya tentang proses penguncian vault, lihat [Kunci Gletser Amazon Glacier](vault-lock.md).

Jika operasi ini dipanggil saat kunci vault dalam status `InProgress`, operasi mengembalikan kesalahan `AccessDeniedException`. Saat kunci vault berada dalam status `InProgress`, Anda harus memanggil [Membatalkan Kunci Vault (DELETE lock-policy)](api-AbortVaultLock.md) sebelum Anda dapat memulai kebijakan kunci vault baru. 

## Permintaan
<a name="api-InitiateVaultLock-requests"></a>

Untuk memulai proses penguncian vault, kirim permintaan `POST` HTTP ke URI dari subsumber daya `lock-policy` vault, seperti yang ditunjukkan dalam contoh sintaks berikut.

### Sintaksis
<a name="api-InitiateVaultLock-requests-syntax"></a>

```
 1. POST /AccountId/vaults/vaultName/lock-policy HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.   "Policy": "string"
10. }
```

 

**catatan**  
`AccountId`Nilainya adalah Akun AWS ID. Nilai ini harus cocok dengan Akun AWS ID yang terkait dengan kredensional yang digunakan untuk menandatangani permintaan. Anda dapat menentukan Akun AWS ID atau secara opsional satu '`-`' (tanda hubung), dalam hal ini Amazon Glacier menggunakan Akun AWS ID yang terkait dengan kredenal yang digunakan untuk menandatangani permintaan. Jika Anda menentukan ID akun, jangan sertakan tanda hubung ('-') di ID.

### Parameter Permintaan
<a name="api-InitiateVaultLock-requests-parameters"></a>

Operasi ini tidak menggunakan parameter permintaan.

### Header Permintaan
<a name="api-InitiateVaultLock-requests-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Header Permintaan Umum](api-common-request-headers.md).

### Isi Permintaan
<a name="api-InitiateVaultLock-requests-elements"></a>

Isi permintaan berisi bidang JSON berikut.

 **Kebijakan**   
Kebijakan kunci vault sebagai string JSON, yang menggunakan "\$1" sebagai karakter escape.  
 Tipe: String   
 Diperlukan: Ya

## Respons
<a name="api-InitiateVaultLock-responses"></a>

Amazon Glacier (Amazon Glacier) mengembalikan `HTTP 201 Created` respons, jika kebijakan tersebut diterima.

### Sintaksis
<a name="api-InitiateVaultLock-response-syntax"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-lock-id: lockId
```

### Header Respons
<a name="api-InitiateVaultLock-responses-headers"></a>

Respons yang sukses termasuk header respon berikut, selain header respons yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header respons umum, lihat [Header Respons Umum](api-common-response-headers.md).


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  x-amz-lock-id  |  ID kunci, yang digunakan untuk menyelesaikan proses penguncian vault.  Tipe: String  | 

### Isi Respons
<a name="api-InitiateVaultLock-responses-elements"></a>

Operasi ini tidak mengembalikan isi respons.

### Kesalahan
<a name="api-InitiateVaultLock-responses-errors"></a>

Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md)

## Contoh
<a name="api-InitiateVaultLock-examples"></a>

### Contoh Permintaan
<a name="api-InitiateVaultLock-example-request"></a>

Contoh berikut mengirimkan permintaan `PUT` HTTP ke URI dari subsumber daya `lock-policy` vault. String JSON `Policy` menggunakan "\$1" sebagai karakter escape.

```
1. PUT /-/vaults/examplevault/lock-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
7. 
8. {"Policy":"{\"Version\":\"2012-10-17\",		 	 	 \"Statement\":[{\"Sid\":\"Define-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\"}}}]}"}
```

### Contoh Respons
<a name="api-InitiateVaultLock-example-response"></a>

Jika permintaan berhasil, Amazon Glacier mengembalikan respons, seperti `HTTP 201 Created` yang ditunjukkan pada contoh berikut.

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

## Bagian Terkait
<a name="related-sections-InitiateVaultLock"></a>

 
+ [Membatalkan Kunci Vault (DELETE lock-policy)](api-AbortVaultLock.md)

 
+ [Menyelesaikan Kunci Vault (POST lockId)](api-CompleteVaultLock.md)

 
+ [Mendapatkan Kunci Vault (GET lock-policy)](api-GetVaultLock.md)

## Lihat Juga
<a name="api-InitiateVaultLock_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu Amazon khusus bahasa SDKs, lihat berikut ini:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/initiate-vault-lock.html) 