Menyelesaikan Kunci Vault (POST lockId)

Deskripsi

Operasi ini menyelesaikan proses penguncian vault dengan mengalihkan kunci vault dari status InProgress ke status Locked, yang menyebabkan kebijakan kunci vault menjadi tidak dapat berubah. Kunci vault ditetapkan ke dalam status InProgress dengan memanggil Memulai Kunci Vault (POST lock-policy). Anda bisa mendapatkan status kunci vault dengan memanggil Mendapatkan Kunci Vault (GET lock-policy). Untuk informasi selengkapnya tentang proses penguncian vault, lihat Kunci Vault S3 Glacier.

Operasi ini bersifat idempoten. Permintaan ini selalu berhasil jika status kunci vault adalah Locked dan ID kunci yang disediakan cocok dengan ID kunci yang awalnya digunakan untuk mengunci vault.

Jika ID kunci yang tidak valid diteruskan dalam permintaan ketika status kunci vault adalah Locked, operasi mengembalikan kesalahan AccessDeniedException. Jika ID kunci yang tidak valid diteruskan dalam permintaan ketika status kunci vault adalah InProgress, operasi menampilkan kesalahan InvalidParameter.

Permintaan

Untuk menyelesaikan proses penguncian vault, kirim permintaan POST HTTP ke URI subsumber daya lock-policy vault dengan ID kunci yang valid.

Sintaksis

POST /AccountId/vaults/vaultName/lock-policy/lockId HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01

catatan

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

Nilai lockId adalah ID kunci yang diperoleh dari permintaan Memulai Kunci Vault (POST lock-policy).

Parameter Permintaan

Header Permintaan

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat Header Permintaan Umum.

Isi Permintaan

Operasi ini tidak memiliki isi permintaan.

Respons

Jika permintaan operasi berhasil, layanan mengembalikan respons 204 No Content HTTP.

Sintaksis

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

Header Respons

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat Header Respons Umum.

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Kesalahan

Untuk informasi tentang pengecualian dan pesan kesalahan Amazon S3 Glacier, lihat Respons Kesalahan.

Contoh

Contoh Permintaan

Contoh berikut mengirimkan permintaan HTTP POST dengan ID kunci untuk menyelesaikan proses penguncian vault.

POST /-/vaults/examplevault/lock-policy/AE863rKkWZU53SLW5be4DUcW HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: length
x-amz-glacier-version: 2012-06-01

Contoh Respons

Jika permintaan berhasil, Amazon S3 Glacier (S3 Glacier) mengembalikan respons HTTP 204 No Content, seperti yang ditampilkan dalam contoh berikut.

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT

Bagian Terkait

• Membatalkan Kunci Vault (DELETE lock-policy)

• Mendapatkan Kunci Vault (GET lock-policy)

• Memulai Kunci Vault (POST lock-policy)

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu dari SDK Amazon spesifik bahasa, lihat berikut ini:

• AWS Command Line Interface