Consulta as regras de criptografia no lado do servidor configuradas para um bucket.
Observações
A operação GetBucketEncryption exige a permissão oss:GetBucketEncryption. Para mais informações, consulte Exemplos comuns de políticas do RAM.
Somente o proprietário do bucket ou usuários do RAM autorizados podem consultar as regras de criptografia do bucket. Outros usuários recebem um erro 403. Para mais detalhes sobre criptografia de bucket, consulte Criptografia no lado do servidor.
Estrutura da solicitação
Get /? encryption HTTP/1.1
Date: GMT Date
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValueCabeçalhos da solicitação
Esta solicitação utiliza apenas cabeçalhos comuns. Para mais informações, consulte Cabeçalhos comuns de solicitação.
Cabeçalhos da resposta
Esta resposta utiliza apenas cabeçalhos comuns. Para mais informações, consulte Cabeçalhos comuns de resposta.
Elementos da resposta
|
Elemento |
Tipo |
Exemplo |
Descrição |
|
ServerSideEncryptionRule |
Container |
N/A |
Contêiner das regras de criptografia no lado do servidor. Nó filho: ApplyServerSideEncryptionByDefault |
|
ApplyServerSideEncryptionByDefault |
Container |
N/A |
Contêiner do método padrão de criptografia no lado do servidor. Nós filhos: SSEAlgorithm e KMSMasterKeyID |
|
SSEAlgorithm |
String |
KMS |
Método padrão de criptografia no lado do servidor. Valores válidos: KMS e AES256 |
|
KMSMasterKeyID |
String |
9468da86-3509-4f8d-a61e-6eab1eac**** |
ID da CMK usada para criptografia. Retornado apenas quando SSEAlgorithm é KMS e há um ID de CMK especificado. Caso contrário, retorna nulo. |
Exemplos
-
Exemplo de solicitação
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 -
Exemplo de resposta
A resposta a seguir indica que o SSE-KMS está configurado para o 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>
SDKs do OSS
Use os seguintes SDKs do OSS para chamar a operação GetBucketEncryption:
ossutil
Para obter informações sobre o comando do ossutil correspondente à operação GetBucketEncryption, consulte get-bucket-encryption.
Códigos de erro
|
Código de erro |
Código de status HTTP |
Descrição |
|
AccessDenied |
403 |
Permissão insuficiente para consultar as regras de criptografia deste bucket. |
|
NoSuchBucket |
400 |
O bucket especificado não existe. |
|
NoSuchServerSideEncryptionRule |
400 |
Nenhuma regra de criptografia configurada para este bucket. |