Operasi ini digunakan untuk menanyakan aturan enkripsi yang dikonfigurasi untuk sebuah bucket.
Catatan
Izin oss:GetBucketEncryption diperlukan untuk menanyakan aturan enkripsi bucket menggunakan GetBucketEncryption. Untuk detail lebih lanjut, lihat Contoh umum kebijakan RAM.
Hanya pemilik bucket atau pengguna RAM yang berwenang yang dapat menanyakan aturan enkripsi bucket. Jika pengguna lain mencoba melakukannya, OSS akan mengembalikan kode kesalahan 403. Untuk informasi lebih lanjut tentang enkripsi bucket, lihat Enkripsi sisi server.
Struktur permintaan
Get /? encryption HTTP/1.1
Date: GMT Date
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValueHeader permintaan
Permintaan GetBucketEncryption hanya mencakup header permintaan umum. Untuk detail lebih lanjut, lihat Header Permintaan Umum.
Header respons
Respons terhadap permintaan GetBucketEncryption hanya mencakup header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.
Elemen respons
Elemen | Tipe | Contoh | Deskripsi |
ServerSideEncryptionRule | Container | N/A | Kontainer yang menyimpan aturan enkripsi sisi server. Node anak: ApplyServerSideEncryptionByDefault |
ApplyServerSideEncryptionByDefault | Container | N/A | Kontainer yang menyimpan metode enkripsi sisi server default. Node anak: SSEAlgorithm dan KMSMasterKeyID |
SSEAlgorithm | String | KMS | Metode enkripsi sisi server default. Nilai valid: KMS dan AES256 |
KMSMasterKeyID | String | 9468da86-3509-4f8d-a61e-6eab1eac**** | ID CMK yang digunakan untuk enkripsi. Parameter ini hanya dikembalikan ketika nilai SSEAlgorithm adalah KMS dan ID CMK ditentukan dalam permintaan. Dalam kasus lain, parameter ini bernilai null. |
Contoh
Contoh Permintaan
Get /? encryption HTTP/1.1 Date: Tue, 20 Dec 2018 11:20:10 GMT Host: oss-example.oss-cn-hangzhou.aliyuncs.com Authorization: OSS qn6q**************:77Dv****************Contoh Respons
Respons berikut menunjukkan bahwa SSE-KMS telah dikonfigurasikan untuk bucket.
HTTP/1.1 204 NoContent x-oss-request-id: 5C1B138A109F4E405B2D8AEF Date: Tue, 20 Dec 2018 11:22:05 GMT <? xml version="1.0" encoding="UTF-8"? > <ServerSideEncryptionRule> <ApplyServerSideEncryptionByDefault> <SSEAlgorithm>KMS</SSEAlgorithm> <KMSMasterKeyID>9468da86-3509-4f8d-a61e-6eab1eac****</KMSMasterKeyID> </ApplyServerSideEncryptionByDefault> </ServerSideEncryptionRule>
SDK
Anda dapat menggunakan SDK OSS untuk bahasa pemrograman berikut guna memanggil GetBucketEncryption:
ossutil
Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetBucketEncryption, lihat get-bucket-encryption.
Kode kesalahan
Kode kesalahan | Kode status HTTP | Deskripsi |
AccessDenied | 403 | Pesan kesalahan yang dikembalikan karena Anda tidak memiliki izin untuk menanyakan aturan enkripsi yang dikonfigurasi untuk bucket. |
NoSuchBucket | 400 | Pesan kesalahan yang dikembalikan karena bucket yang aturan enkripsinya ingin Anda tanyakan tidak ada. |
NoSuchServerSideEncryptionRule | 400 | Pesan kesalahan yang dikembalikan karena tidak ada aturan enkripsi yang dikonfigurasi untuk bucket. |