Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Object Storage Service/ Referência de API/ As API/ Configurações avançadas de bucket/ Obtenção da configuração de encriptação de um bucket
Atualizado em 2022-11-07 GMT+08:00
Ver PDF
Compartilhar

Obtenção da configuração de encriptação de um bucket

Funções

O OBS usa o método GET para obter a configuração de encriptação de um bucket especificado.

Para executar essa operação, você deve ter a permissão GetEncryptionConfiguration. Por padrão, somente o proprietário do bucket pode excluir as tags de um bucket. O proprietário do bucket pode permitir que outros usuários executem essa operação definindo uma política de bucket ou concedendo a eles a permissão.

Para obter mais informações sobre o controle de permissão, consulte o controle de permissão no Guia de configuração de permissão do OBS.

Sintaxe da solicitação

1
2
3
4
5
6
 
GET /?encryption  HTTP/1.1
User-Agent: curl/7.29.0
Host: bucketname.obs.region.myhuaweicloud.com 
Accept: */*
Date: date 
Authorization: authorization string

Parâmetros de solicitação

Esta solicitação não contém nenhum parâmetro.

Cabeçalhos de solicitação

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
 
HTTP/1.1 status_code
x-obs-request-id: request id 
x-obs-id-2: id  
Content-Type: application/xml 
Content-Length: length 
Date: date 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<ServerSideEncryptionConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Rule>
        <ApplyServerSideEncryptionByDefault>
            <SSEAlgorithm>kms</SSEAlgorithm>
            <KMSMasterKeyID>kmskeyid-value</KMSMasterKeyID>
            <ProjectID>projectid</ProjectID>
        </ApplyServerSideEncryptionByDefault>
    </Rule>
</ServerSideEncryptionConfiguration>

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Elementos de resposta

Essa resposta contém os seguintes elementos para detalhar a configuração de encriptação do bucket:

Tabela 1 Elementos de configuração da encriptação de bucket

Cabeçalho

Descrição

ServerSideEncryptionConfiguration

Elemento raiz da configuração de encriptação padrão de um bucket.

Tipo: elemento

Antepassado: nenhum

Crianças: Regra

Rule

Subelemento da configuração de encriptação padrão de um bucket.

Tipo: elemento

Antepassado: ServerSideEncryptionConfiguration

Crianças: ApplyServerSideEncryptionByDefault

ApplyServerSideEncryptionByDefault

Subelemento da configuração de encriptação padrão de um bucket.

Tipo: elemento

Antepassado: Regra

Crianças: SSEAlgorithm, KMSMasterKeyID

SSEAlgorithm

O algoritmo de encriptação do lado do servidor usado para a configuração de encriptação de um bucket.

Tipo: string

Valores válidos: kms

Antepassado: ApplyServerSideEncryptionByDefault

KMSMasterKeyID

ID da chave mestra do cliente (CMK) usada para SSE-KMS.

Tipo: string

Antepassado: ApplyServerSideEncryptionByDefault

ProjectID

ID do projeto ao qual a chave mestre do KMS pertence no modo SSE-KMS.

Tipo: string

Antepassado: ApplyServerSideEncryptionByDefault

Respostas de erro

Além de códigos de erro comuns, essa API também retorna outros códigos de erro. A tabela a seguir lista erros comuns e possíveis causas. Para mais detalhes, consulte Tabela 2.

Tabela 2 Códigos de erro relacionados à obtenção da configuração de encriptação do bucket

Código de erro

Descrição

Código de status HTTP

NoSuchEncryptionConfiguration

O bucket especificado não tem configurações de encriptação

404 Not Found

Solicitação de exemplo

1
2
3
4
5
6
 
GET /?encryption HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date:  Thu, 21 Feb 2019 03:05:34 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:DpSAlmLX/BTdjxU5HOEwflhM0WI=

Resposta de exemplo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF26000001643670AC06E7B9A7767921
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSvK6z8HV6nrJh49gsB5vqzpgtohkiFm
Date: Thu, 21 Feb 2019 03:05:34 GMT
Content-Length: 788

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<ServerSideEncryptionConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> 
    <Rule>
        <ApplyServerSideEncryptionByDefault>
            <SSEAlgorithm>kms</SSEAlgorithm>
            <KMSMasterKeyID>4f1cd4de-ab64-4807-920a-47fc42e7f0d0</KMSMasterKeyID>
        </ApplyServerSideEncryptionByDefault>
    </Rule>
</ServerSideEncryptionConfiguration>