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 :
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
Après avoir activé le suivi d'accès, appelez l'opération PutBucketLifecycle pour configurer des règles de cycle de vie basées sur la dernière date d'accès. Pour plus d'informations, consultez la rubrique PutBucketLifecycle.
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. |