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.

Nesta página

Funções
Sintaxe da solicitação
Parâmetros de solicitação
Cabeçalhos de solicitação
Elementos de solicitação
Sintaxe da resposta
Cabeçalhos de resposta
Elementos de resposta
Respostas de erro
Solicitação de exemplo
Resposta de exemplo

Mostrar todos

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

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

Atualizado em 2022-11-07 GMT+08:00

Ver PDF

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>

      

    
   

Tópico principal: Configurações avançadas de bucket

Tópico anterior: Configuração de registração para um bucket

Próximo tópico: Configuração de regras de ciclo de vida de um bucket

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar