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 registração de um bucket
Atualizado em 2022-11-07 GMT+08:00
Ver PDF
Compartilhar

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

Funções

Esta operação consulta o status de registração de um bucket. Ele usa o sub-recurso de registração para retornar o status de registração de um bucket.

Somente o proprietário do bucket ou os usuários que receberam a permissão GetBucketLogging podem consultar o status de registração do bucket.

Sintaxe da solicitação

1
2
3
4
 
GET /?logging HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization

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
18
19
20
21
 
HTTP/1.1 status_code
Content-Type: application/xml 
Date: date
Content-Length: length

<?xml version="1.0" encoding="UTF-8"?> 
<BucketLoggingStatus xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/">
<Agency>agency-name</Agency>
<LoggingEnabled> 
    <TargetBucket>bucketName</TargetBucket> 
    <TargetPrefix>prefix</TargetPrefix> 
        <TargetGrants> 
            <Grant> 
                <Grantee> 
                    <ID>id</ID> 
                </Grantee> 
                <Permission>permission</Permission> 
            </Grant> 
        </TargetGrants> 
    </LoggingEnabled> 
</BucketLoggingStatus>

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 elementos para especificar o status de registração do bucket. Tabela 1 descreve os elementos.

Tabela 1 Elementos de resposta

Elemento

Descrição

BucketLoggingStatus

Contêiner para registrar informações de status

Tipo: recipiente

Agency

Nome da agência criada pelo proprietário do bucket de registração para carregamento de arquivos de registro pelo OBS

Tipo: string

LoggingEnabled

Container para informações de registração. Este elemento ativa ou desativa a função de registração. Apresente esse elemento ao ativar a registração. Caso contrário, ausente.

Tipo: recipiente

Grant

Contêiner para o beneficiário e as permissões concedidas

Tipo: recipiente

Grantee

Contêiner para o usuário que é concedido com a permissão de registração

Tipo: recipiente

ID

ID de domínio do beneficiário, um ID globalmente exclusivo

Tipo: string

Permission

Permissão de log concedida ao beneficiário de um bucket. O proprietário do bucket recebe automaticamente a permissão FULL_CONTROL ao criar o bucket. As permissões de registração controlam o acesso aos registros diferentes.

Tipo: string

Opções de valor: FULL_CONTROL | READ | WRITE

TargetBucket

Ao ativar a função de registração, o proprietário do bucket que está sendo registrado pode especificar um bucket de destino para armazenar os arquivos de registros gerados. Os arquivos de registros gerados para vários buckets podem ser armazenados no mesmo bucket de destino. Se você fizer isso, precisará especificar TargetPrefixes diferentes para classificar registros para buckets diferentes.

Tipo: string

TargetPrefix

Você pode especificar um prefixo usando este elemento para que os arquivos de registros sejam nomeados com este prefixo.

Tipo: string

TargetGrants

Container para concessão de informações

Tipo: container

Respostas de erro

Nenhuma resposta de erro especial está envolvida. Para obter detalhes sobre respostas de erro, consulte Tabela 2.

Solicitação de exemplo

1
2
3
4
5
6
 
GET /?logging HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 02:42:46 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:hUk+jTnR07hcKwJh4ousF2E1U3E=

Resposta de exemplo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
 
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016436B8EEE7FBA2AA3335E3
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCShuQJoWFpS77C8bOv1mqURv0UY+0ejx
Content-Type: application/xml
Date: WED, 01 Jul 2015 02:42:46 GMT
Content-Length: 429

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<BucketLoggingStatus xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <Agency>agency-name</Agency>
  <LoggingEnabled>
    <TargetBucket>log-bucket</TargetBucket>
    <TargetPrefix>mybucket-access_log-/</TargetPrefix>
    <TargetGrants>
      <Grant>
        <Grantee>
          <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID>
        </Grantee>
        <Permission>READ</Permission>
      </Grant>
    </TargetGrants>
  </LoggingEnabled>
</BucketLoggingStatus>