すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:PutBucketAccessMonitor を呼び出して、バケットのアクセストラッキングを有効または無効にする

最終更新日:Jun 09, 2025

バケットのアクセストラッキングを有効または無効にします。 バケットのアクセストラッキングが有効になっている場合、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

バケットのアクセストラッキングを有効にするかどうかを指定します。有効な値:

  • Enabled: アクセストラッキングを有効にします。

    OSS は、最初にアクセストラッキングが有効になった時間をバケット内のオブジェクトの最終アクセス時間として使用し、オブジェクトにアクセスがあった場合にオブジェクトの最終アクセス時間を更新します。

    オブジェクトの最終アクセス時間は非同期的に更新されます。 24 時間以内にオブジェクトに複数回アクセスした場合、その期間内にオブジェクトに対して行われた最初のアクセス操作のみが最終アクセス時間を更新します。 最終アクセス時間に基づいて、バケットのライフサイクルルールを指定できます。

  • Disabled: アクセストラッキングを無効にします。

    最終アクセス時間に基づくライフサイクルルールがバケットにない場合にのみ、アクセストラッキングを無効にすることができます。

親ノード: 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

バケットが存在しません。