Todos os produtos
Search
Central de documentação

Object Storage Service:Query the access tracking status of a bucket by calling GetBucketAccessMonitor

Última atualização: Sep 22, 2026

Consulta o status de rastreamento de acesso de um bucket. Para configure uma regra de ciclo de vida baseada no último horário de acesso — por exemplo, monitorar padrões de acesso e mover dados frios para uma classe de armazenamento mais econômica —, ative primeiro o rastreamento de acesso no bucket.

Observação

Para consultar o status de rastreamento de acesso de um bucket, você precisa ter a permissão oss:GetBucketAccessMonitor. Para obter mais informações, consulte Grant a custom policy.

Sintaxe da requisição

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

Cabeçalhos de requisição

A operação DescribeRegions usa apenas cabeçalhos de requisição comuns. Para obter mais informações, consulte Common request headers.

Cabeçalhos de resposta

A resposta contém apenas cabeçalhos de resposta comuns. Para obter mais informações, consulte Common response headers.

Elementos de resposta

Elemento

Tipo

Exemplo

Descrição

AccessMonitorConfiguration

Container

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: o rastreamento de acesso está ativado.

  • Disabled: o rastreamento de acesso está desativado.

Nó pai: AccessMonitorConfiguration

Exemplo

Exemplo de requisição

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

Exemplo de resposta

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

  • Para obter mais informações sobre regras de ciclo de vida baseadas no último horário de acesso, consulte Lifecycle rules based on last access time.

  • Após ative o rastreamento de acesso, chame a operação PutBucketLifecycle para configure uma regra de ciclo de vida baseada no último horário de acesso. Para obter mais informações, consulte PutBucketLifecycle.

OSS SDKs

Use os OSS SDKs para as seguintes linguagens de programação para chamar a operação GetBucketAccessMonitor:

ossutil

Para informações sobre o comando 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

Você não tem autorização para acessar o bucket.

NoSuchBucket

404

O bucket não existe.