Tous les produits
Search
Centre de documentation

Object Storage Service:PutBucketAccessMonitor - Enable or disable bucket access tracking

Dernière mise à jour :Aug 18, 2026

Active ou désactive le suivi d'accès pour un bucket. Une fois activé, OSS enregistre la dernière date d'accès aux objets. Vous pouvez ensuite configurer des règles de cycle de vie basées sur cette date pour identifier les données chaudes et froides, et déplacer les données froides vers des classes de stockage moins coûteuses.

Notes d'utilisation

Vous devez disposer de l'autorisation oss:PutBucketAccessMonitor. Pour plus d'informations, consultez la rubrique Accorder une stratégie personnalisée.

Syntaxe de la requête

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>

En-têtes de requête

Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la rubrique En-têtes de requête communs.

Éléments de requête

Élément

Type

Obligatoire

Exemple

Description

AccessMonitorConfiguration

Container

Oui

S.O.

Configuration du suivi d'accès du bucket.

Nœuds enfants : Status

Status

String

Oui

Enabled

Indique si le suivi d'accès est activé. Valeurs possibles :

  • Enabled : active le suivi d'accès.

    OSS définit la date d'activation du suivi comme date initiale de dernier accès aux objets et la met à jour lors de chaque accès.

    La mise à jour de la dernière date d'accès est asynchrone. Sur une période de 24 heures, seul le premier accès met à jour cette date. Vous pouvez configurer des règles de cycle de vie pour le bucket en vous basant sur la dernière date d'accès.

  • Disabled : désactive le suivi d'accès.

    Le suivi d'accès ne peut être désactivé que si le bucket ne contient aucune règle de cycle de vie basée sur la dernière date d'accès.

Nœuds parents : AccessMonitorConfiguration

En-têtes de réponse

La réponse contient uniquement les en-têtes de réponse communs. Pour plus d'informations, consultez la rubrique En-têtes de réponse communs.

Exemples

Exemple de requête

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>

Exemple de réponse

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

Références

Kits SDK OSS

Les kits SDK OSS suivants prennent en charge l'opération PutBucketAccessMonitor :

ossutil

Pour la commande ossutil correspondante, consultez la rubrique put-bucket-access-monitor.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

MalformedXML

400

La configuration du suivi d'accès n'est pas valide.

AccessMonitorDisableNotAllowed

400

Le statut du suivi d'accès ne peut pas être défini sur Disabled car le bucket possède une règle de cycle de vie basée sur la dernière date d'accès.

AccessDenied

403

Vous n'êtes pas autorisé à accéder au bucket.

NoSuchBucket

404

Le bucket n'existe pas.