Mendapatkan Kebijakan Akses Vault (PUT access-policy)

Deskripsi

Operasi ini mengonfigurasi kebijakan akses untuk vault dan akan menimpa kebijakan yang ada. Untuk mengonfigurasi kebijakan akses vault, kirim permintaan PUT ke subsumber daya access-policydari vault. Anda dapat menetapkan satu kebijakan akses per vault dan kebijakan dapat berukuran hingga 20 KB. Untuk informasi selengkapnya tentang kebijakan akses vault, lihat Kebijakan Akses Vault.

Permintaan

Sintaksis

Untuk menetapkan kebijakan akses, kirim permintaan PUT HTTP ke URI dari subsumber daya access-policy vault seperti yang ditunjukkan dalam contoh sintaks berikut.

PUT /AccountId/vaults/vaultName/access-policy HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
			
{
  "Policy": "string"
}

catatan

Nilai AccountId adalah ID Akun AWS dari akun yang memiliki vault. 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 menggunakan ID akun, jangan sertakan tanda hubung ('-') di ID.

Parameter Permintaan

Operasi ini tidak menggunakan 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

Isi permintaan berisi bidang JSON berikut.

Kebijakan

Kebijakan akses vault sebagai string JSON, yang menggunakan "\" sebagai karakter escape.

Jenis: Tali

Diperlukan: Ya

Respons

Sebagai respons, S3 Glacier mengembalikan 204 No Content jika kebijakan diterima.

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 PUT HTTP ke URI dari subsumber daya access-policy vault. String JSON Policy menggunakan "\" sebagai karakter escape.

PUT /-/vaults/examplevault/access-policy 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

{"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}"}

Contoh Respons

Jika permintaan berhasil, Amazon S3 Glacier (S3 Glacier) mengembalikan 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

• Menghapus Kebijakan Akses Vault (DELETE access-policy)

• Mendapatkan Kebijakan Akses Vault (GET access-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