PutBucketAccessMonitor API - OSS bucket access tracking - Object Storage Service

Habilita o deshabilita el seguimiento de acceso para un bucket. Cuando esta función está habilitada, OSS registra la última hora de acceso de los objetos. Posteriormente, puede configurar reglas de ciclo de vida basadas en la última hora de acceso para identificar datos frecuentes y poco frecuentes, y mover estos últimos a clases de almacenamiento de menor costo.

Notas de uso

Debe contar con el permiso oss:PutBucketAccessMonitor. Para obtener más información, consulte Grant a custom policy.

Sintaxis de la solicitud

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>

Encabezados de la solicitud

DescribeRegions utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Elementos de la solicitud

Elemento

Tipo

Obligatorio

Ejemplo

Descripción

AccessMonitorConfiguration

Contenedor

Sí

N/A

Configuración de seguimiento de acceso del bucket.

Nodos secundarios: Status

Status

Cadena

Sí

Enabled

Indica si se debe habilitar el seguimiento de acceso. Valores válidos:

Enabled: habilita el seguimiento de acceso.

OSS establece la hora en que se habilita el seguimiento de acceso como la última hora de acceso inicial de los objetos y la actualiza cada vez que se accede a ellos.

La última hora de acceso se actualiza de forma asíncrona. Dentro de un periodo de 24 horas, solo el primer acceso actualiza este valor. Puede configurar reglas de ciclo de vida basadas en la última hora de acceso para el bucket.
Disabled: deshabilita el seguimiento de acceso.

El seguimiento de acceso solo se puede deshabilitar si el bucket no tiene reglas de ciclo de vida basadas en la última hora de acceso.

Nodos principales: AccessMonitorConfiguration

Encabezados de la respuesta

La respuesta contiene únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Ejemplos

Solicitud de ejemplo

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>

Respuesta de ejemplo

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: AliyunOSS

Referencias

Lifecycle rules based on last access time
Después de habilitar el seguimiento de acceso, llame a PutBucketLifecycle para configurar reglas de ciclo de vida basadas en la última hora de acceso. Para obtener más información, consulte PutBucketLifecycle.

SDK de OSS

Los siguientes SDK de OSS admiten PutBucketAccessMonitor:

ossutil

Para consultar el comando correspondiente de ossutil, consulte put-bucket-access-monitor.

Códigos de error

Código de error	Código de estado HTTP	Descripción
MalformedXML	400	La configuración de seguimiento de acceso no es válida.
AccessMonitorDisableNotAllowed	400	No se puede establecer el estado de seguimiento de acceso en Disabled porque el bucket tiene una regla de ciclo de vida basada en la última hora de acceso.
AccessDenied	403	No tiene autorización para acceder al bucket.
NoSuchBucket	404	El bucket no existe.