バケットのアクセストラッキングステータスをクエリします。 最終アクセス時間に基づいてライフサイクルルールを構成する場合、たとえば、アクセスパターンを監視し、コールドデータをより費用対効果の高いストレージタイプに移動するには、まずバケットのアクセストラッキングを有効にする必要があります。
注記
バケットのアクセストラッキングステータスをクエリするには、oss:GetBucketAccessMonitor 権限が必要です。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。
リクエスト構文
GET /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストヘッダー
DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通のリクエストヘッダー」をご参照ください。
レスポンスヘッダー
DescribeRegions リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通のレスポンスヘッダー」をご参照ください。
レスポンス要素
要素 | タイプ | 例 | 説明 |
AccessMonitorConfiguration | コンテナ | 該当なし | バケットのアクセストラッキング構成。 子ノード: Status |
Status | 文字列 | Enabled | バケットのアクセストラッキングステータス。有効な値:
親ノード: AccessMonitorConfiguration |
例
リクエスト例
GET /?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レスポンス例
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 125
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
<Status>Enabled</Status>
</AccessMonitorConfiguration>参照
最終アクセス時間に基づくライフサイクルルールの詳細については、「最終アクセス時間に基づくライフサイクルルール」をご参照ください。
アクセストラッキングが有効になったら、PutBucketLifecycle 操作を呼び出して、最終アクセス時間に基づくライフサイクルルールを構成できます。 詳細については、「PutBucketLifecycle」をご参照ください。
OSS SDK
次のプログラミング言語の OSS SDK を使用して、GetBucketAccessMonitor を呼び出すことができます。
ossutil
GetBucketAccessMonitor 操作に対応する ossutil コマンドの詳細については、「get-bucket-access-monitor」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
AccessDenied | 403 | バケットにアクセスする権限がありません。 |
NoSuchBucket | 404 | バケットが存在しません。 |