バケットのアクセス追跡を有効または無効にします。 バケットのアクセス追跡が有効になっている場合、OSSはバケット内のオブジェクトの最終アクセス時刻を記録します。 この場合、最終アクセス時間に基づいてライフサイクルルールを設定し、データアクセスパターンに基づいてホットデータとコールドデータを識別し、コールドデータをより費用対効果の高いストレージクラスに移動できます。
使用上の注意
バケットのアクセス追跡を有効または無効にするには、oss:PutBucketAccessMonitor権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
リクエスト構文
PUT /?accessmonitor HTTP/1.1
ホスト: BucketName.oss.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
<ステータス> 有効 </ステータス>
</AccessMonitorConfiguration> リクエストヘッダー
このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
リクエスト要素
要素 | データ型 | 必須 | 例 | 説明 |
AccessMonitorConfiguration | Container | 必須 | N/A | バケットのアクセス追跡設定。 子ノード: ステータス |
Status | String | 必須 | Enabled | バケットのアクセス追跡を有効にするかどうかを指定します。 有効な値：
親ノード: AccessMonitorConfiguration |
レスポンスヘッダー
このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
例
リクエストの例
PUT /?accessmonitor HTTP/1.1
ホスト: oss-example.oss.aliyuncs.com
日付: 7月26日月曜日2021 13:08:38 GMT
権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 ****
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
<ステータス> 有効 </ステータス>
</AccessMonitorConfiguration> レスポンスの例
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D ****
日付: 7月26日月曜日2021 13:08:38 GMT
コンテンツ長: 0
接続: キープアライブ
サーバー: AliyunOSS 参考資料
最終アクセス時間に基づくライフサイクルルールの詳細については、「最終アクセス時間に基づくライフサイクルルール」をご参照ください。
アクセス追跡を有効にした後、PutBucketLifecycle操作を呼び出して、最終アクセス時刻に基づいてライフサイクルルールを設定できます。 詳細については、「PutBucketLifecycle」をご参照ください。
エラーコード
エラーコード | HTTPステータスコード | 説明 |
MalformedXML | 400 | アクセス追跡設定が無効です。 |
AccessMonitorDisableNotAllowed | 400 | バケットには最終アクセス時刻に基づくライフサイクルルールがあるため、アクセス追跡ステータスを無効に設定することはできません。 |
AccessDenied | 403 | バケットにアクセスする権限がありません。 |
NoSuchBucket | 404 | ユーザーは存在しません。 |