Todos os produtos
Search
Central de documentação

Object Storage Service:Consultar o status de rastreamento de acesso de um bucket chamando GetBucketAccessMonitor

Última atualização: Jul 03, 2026

Consulta o status de rastreamento de acesso de um bucket. Ative o rastreamento de acesso do bucket antes de configurar uma regra de ciclo de vida baseada na hora do último acesso. Isso permite, por exemplo, monitorar padrões de acesso e mover dados frios para uma classe de armazenamento mais econômica.

Nota

Para consultar o status de rastreamento de acesso de um bucket, é necessária a permissão oss:GetBucketAccessMonitor. Para mais informações, consulte Conceder uma política personalizada.

Sintaxe da solicitação

GET /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

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

Cabeçalhos da resposta

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

Elementos da resposta

Elemento

Tipo

Exemplo

Descrição

AccessMonitorConfiguration

Contêiner

N/A

Configurações de rastreamento de acesso do bucket.

Nós filhos: Status

Status

String

Enabled

Status de rastreamento de acesso do bucket. Valores válidos:

  • Enabled: Rastreamento de acesso ativado.

  • Disabled: Rastreamento de acesso desativado.

Nó pai: AccessMonitorConfiguration

Exemplo

Solicitação de exemplo

GET /?accessmonitor HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Date: Thu, 17 Apr 2025 13:08:38 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Resposta de exemplo

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 125
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
  <Status>Enabled</Status>
</AccessMonitorConfiguration>

Referências

SDKs do OSS

Use os SDKs do OSS nas seguintes linguagens de programação para chamar o GetBucketAccessMonitor:

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação GetBucketAccessMonitor, consulte get-bucket-access-monitor.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

AccessDenied

403

Acesso ao bucket não autorizado.

NoSuchBucket

404

O bucket não existe.