GetBucketLogging - Consultar configuração de log de acesso do bucket - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

A operação GetBucketLogging exige a permissão oss:GetBucketLogging. Conceder políticas de acesso personalizadas a usuários RAM.

Sintaxe da solicitação

GET /?logging HTTP/1.1
Host: Host
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

O GetBucketLogging utiliza apenas cabeçalhos comuns de solicitação. Para mais informações, consulte Cabeçalhos comuns de solicitação.

Cabeçalhos da resposta

A resposta contém apenas cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.

Elementos da resposta

Nome	Tipo	Exemplo	Descrição
BucketLoggingStatus	Container	Não aplicável	Container do status do log de acesso. Elemento filho: LoggingEnabled Elemento pai: Nenhum Nota Se nenhuma regra de log estiver configurada para o bucket, o OSS retorna um corpo XML com um elemento BucketLoggingStatus vazio.
LoggingEnabled	Container	Não aplicável	Container das informações de log de acesso. Retornado apenas quando o registro de logs está ativado. Elementos filhos: TargetBucket, TargetPrefix e LoggingRole Elemento pai: BucketLoggingStatus
TargetBucket	String	mybucketlogs	Bucket que armazena os logs de acesso. Elemento filho: Nenhum Elemento pai: BucketLoggingStatus.LoggingEnabled
TargetPrefix	String	mybucket-access_log/	Prefixo dos arquivos de log de acesso armazenados. Elemento filho: Nenhum Elemento pai: BucketLoggingStatus.LoggingEnabled
LoggingRole	String	AliyunOSSLoggingDefaultRole	Função para autorização de armazenamento de logs. Elemento filho: Nenhum Elemento pai: BucketLoggingStatus.LoggingEnabled

Exemplos

Bucket de uso geral

Solicitação

Get /?logging HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Resposta

Resposta quando o registro de logs está ativado

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <LoggingEnabled>
        <TargetBucket>mybucketlogs</TargetBucket>
        <TargetPrefix>mybucket-access_log/</TargetPrefix>
        <LoggingRole>AliyunOSSLoggingDefaultRole</LoggingRole>
    </LoggingEnabled>
</BucketLoggingStatus>

Resposta quando o registro de logs está desativado

HTTP/1.1 200 
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 110  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
</BucketLoggingStatus>

Bucket vetorial

Buckets vetoriais usam IDs de região padrão do Alibaba Cloud (como cn-hangzhou) no cabeçalho Host, e não os IDs de região legados do OSS (como oss-cn-hangzhou).

Solicitação

Get /?logging HTTP/1.1
Host: exampebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Resposta

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
Server: AliyunOSS

{
  "BucketLoggingStatus": {
    "LoggingEnabled": {
      "TargetBucket": "mybucketlogs",
      "TargetPrefix": "mybucket-access_log/",
      "LoggingRole": "AliyunOSSLoggingDefaultRole"
    }
  }
}

SDK

SDKs suportados:

Ferramenta de linha de comando ossutil

O comando correspondente no ossutil é get-bucket-logging.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
NoSuchBucket	404	O bucket especificado não existe.
AccessDenied	403	Você não tem permissão para visualizar a configuração de log de acesso do bucket. Somente o proprietário do bucket possui essa permissão.