Ativa ou desativa o rastreamento de acesso a um bucket. Quando ativado, o OSS registra a hora do último acesso aos objetos. Configure regras de ciclo de vida com base na hora do último acesso para identificar dados quentes e frios e mover os dados frios para classes de armazenamento de menor custo.
Notas de uso
Você precisa da permissão oss:PutBucketAccessMonitor. Para mais informações, consulte Conceder uma política personalizada.
Sintaxe da solicitação
PUT /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
<Status>Enabled</Status>
</AccessMonitorConfiguration>Cabeçalhos da solicitação
O DescribeRegions usa apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.
Elementos da solicitação
|
Elemento |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
AccessMonitorConfiguration |
Contêiner |
Sim |
N/A |
Configuração de rastreamento de acesso do bucket. Nós filhos: Status |
|
Status |
String |
Sim |
Enabled |
Indica se o rastreamento de acesso está ativado. Valores válidos:
Nós pais: AccessMonitorConfiguration |
Cabeçalhos da resposta
A resposta contém apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.
Exemplos
Exemplo de solicitação
PUT /?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
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
<Status>Enabled</Status>
</AccessMonitorConfiguration>Exemplo de resposta
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSSReferências
Após ativar o rastreamento de acesso, chame a operação PutBucketLifecycle para configurar regras de ciclo de vida baseadas na hora do último acesso. Para mais informações, consulte PutBucketLifecycle.
SDKs do OSS
Os seguintes SDKs do OSS oferecem suporte ao PutBucketAccessMonitor:
ossutil
Para obter o comando correspondente do ossutil, consulte put-bucket-access-monitor.
Códigos de erro
|
Código de erro |
Código de status HTTP |
Descrição |
|
MalformedXML |
400 |
A configuração de rastreamento de acesso é inválida. |
|
AccessMonitorDisableNotAllowed |
400 |
Não é possível definir o status de rastreamento de acesso como Disabled porque o bucket tem uma regra de ciclo de vida baseada na hora do último acesso. |
|
AccessDenied |
403 |
Você não tem autorização para acessar o bucket. |
|
NoSuchBucket |
404 |
O bucket não existe. |