Menanyakan aturan Enkripsi sisi server yang dikonfigurasi untuk suatu bucket.
Catatan
Pemanggilan GetBucketEncryption memerlukan izin oss:GetBucketEncryption. Untuk informasi selengkapnya, lihat Contoh umum kebijakan RAM.
Hanya Pemilik bucket atau Pengguna RAM yang berwenang yang dapat menanyakan aturan enkripsi bucket. Pengguna lain akan menerima error 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 ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.
Header respons
Respons ini hanya menggunakan header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.
Elemen respons
|
Elemen |
Tipe |
Contoh |
Deskripsi |
|
ServerSideEncryptionRule |
Container |
N/A |
Container untuk aturan Enkripsi sisi server. Node anak: ApplyServerSideEncryptionByDefault |
|
ApplyServerSideEncryptionByDefault |
Container |
N/A |
Container untuk metode Enkripsi sisi server default. Node anak: SSEAlgorithm dan KMSMasterKeyID |
|
SSEAlgorithm |
String |
KMS |
Metode Enkripsi sisi server default. Nilai yang valid: KMS dan AES256 |
|
KMSMasterKeyID |
String |
9468da86-3509-4f8d-a61e-6eab1eac**** |
ID CMK yang digunakan untuk Enkripsi. Dikembalikan hanya ketika SSEAlgorithm adalah KMS dan ID CMK ditentukan. Jika tidak, bernilai null. |
Contoh
-
Permintaan contoh
Get /? encryption HTTP/1.1 Date: Thu, 17 Apr 2025 11:20:10 GMT Host: oss-example.oss-cn-hangzhou.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e -
Respons contoh
Respons berikut menunjukkan bahwa SSE-KMS dikonfigurasi untuk bucket tersebut.
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>
OSS SDKs
Panggil GetBucketEncryption dengan OSS SDK berikut:
ossutil
Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetBucketEncryption, lihat get-bucket-encryption.
Kode error
|
Kode error |
Kode status HTTP |
Deskripsi |
|
AccessDenied |
403 |
Anda tidak memiliki izin untuk menanyakan aturan enkripsi untuk bucket ini. |
|
NoSuchBucket |
400 |
Bucket yang ditentukan tidak ada. |
|
NoSuchServerSideEncryptionRule |
400 |
Tidak ada aturan enkripsi yang dikonfigurasi untuk bucket ini. |