バケットのアクセストラッキングを有効または無効にします。 バケットのアクセストラッキングが有効になっている場合、OSS はバケット内のオブジェクトの最終アクセス時間を記録します。 この場合、最終アクセス時間に基づいてライフサイクルルールを構成し、データアクセスパターンに基づいてホットデータとコールドデータを識別し、コールドデータをより費用対効果の高いストレージタイプに移動できます。
使用方法
バケットのアクセストラッキングを有効または無効にするには、oss:PutBucketAccessMonitor 権限が必要です。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。
リクエスト構文
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>リクエストヘッダー
DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。
リクエスト要素
要素 | タイプ | 必須 | 例 | 説明 |
AccessMonitorConfiguration | コンテナ | はい | 該当なし | バケットのアクセストラッキング構成。 子ノード: Status |
Status | 文字列 | はい | Enabled | バケットのアクセストラッキングを有効にするかどうかを指定します。有効な値:
親ノード: AccessMonitorConfiguration |
レスポンスヘッダー
DescribeRegions リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。
例
リクエスト例
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>レスポンス例
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参照
最終アクセス時間に基づくライフサイクルルールの詳細については、「最終アクセス時間に基づくライフサイクルルール」をご参照ください。
アクセストラッキングが有効になったら、PutBucketLifecycle 操作を呼び出して、最終アクセス時間に基づくライフサイクルルールを構成できます。 詳細については、「PutBucketLifecycle」をご参照ください。
OSS SDK
次のプログラミング言語の OSS SDK を使用して、PutBucketAccessMonitor を呼び出すことができます。
ossutil
PutBucketAccessMonitor 操作に対応する ossutil コマンドについては、「put-bucket-access-monitor」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
MalformedXML | 400 | アクセストラッキング構成が無効です。 |
AccessMonitorDisableNotAllowed | 400 | バケットに最終アクセス時間に基づくライフサイクルルールがあるため、アクセストラッキングステータスを Disabled に設定できません。 |
AccessDenied | 403 | バケットにアクセスする権限がありません。 |
NoSuchBucket | 404 | バケットが存在しません。 |