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

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

    
         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

    
     
       
       
         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

    
         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

    
     
       
       
         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>

        

      

    
   