Consulta las reglas de cifrado del lado del servidor configuradas para un bucket.
Notas
Para llamar a GetBucketEncryption se requiere el permiso oss:GetBucketEncryption. Para obtener más información, consulte Common examples of RAM policies.
Solo el propietario del bucket o los usuarios de RAM autorizados pueden consultar las reglas de cifrado del bucket. Los demás usuarios reciben un error 403. Para obtener más información sobre el cifrado de buckets, consulte Server-side encryption.
Estructura de la solicitud
Get /? encryption HTTP/1.1
Date: GMT Date
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValueEncabezados de solicitud
Esta solicitud utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.
Encabezados de respuesta
Esta respuesta utiliza únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.
Elementos de respuesta
|
Elemento |
Tipo |
Ejemplo |
Descripción |
|
ServerSideEncryptionRule |
Container |
N/A |
Contenedor de las reglas de cifrado del lado del servidor. Nodo secundario: ApplyServerSideEncryptionByDefault |
|
ApplyServerSideEncryptionByDefault |
Container |
N/A |
Contenedor del método de cifrado del lado del servidor predeterminado. Nodos secundarios: SSEAlgorithm y KMSMasterKeyID |
|
SSEAlgorithm |
String |
KMS |
Método de cifrado del lado del servidor predeterminado. Valores válidos: KMS y AES256 |
|
KMSMasterKeyID |
String |
9468da86-3509-4f8d-a61e-6eab1eac**** |
ID de CMK usado para el cifrado. Se devuelve solo cuando SSEAlgorithm es KMS y se especifica un ID de CMK. De lo contrario, es nulo. |
Ejemplos
-
Solicitud de ejemplo
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 -
Respuesta de ejemplo
La siguiente respuesta indica que SSE-KMS está configurado para el 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 de OSS
Llame a GetBucketEncryption con los siguientes SDK de OSS:
ossutil
Para obtener información sobre el comando de ossutil correspondiente a la operación GetBucketEncryption, consulte get-bucket-encryption.
Códigos de error
|
Código de error |
Código de estado HTTP |
Descripción |
|
AccessDenied |
403 |
No tiene permiso para consultar las reglas de cifrado de este bucket. |
|
NoSuchBucket |
400 |
El bucket especificado no existe. |
|
NoSuchServerSideEncryptionRule |
400 |
No hay reglas de cifrado configuradas para este bucket. |