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

Object Storage Service:GetBucketAccessMonitor

最終更新日:Jun 10, 2025

バケットのアクセストラッキングステータスをクエリします。 最終アクセス時間に基づいてライフサイクルルールを構成する場合、たとえば、アクセスパターンを監視し、コールドデータをより費用対効果の高いストレージタイプに移動するには、まずバケットのアクセストラッキングを有効にする必要があります。

注記

バケットのアクセストラッキングステータスをクエリするには、oss:GetBucketAccessMonitor 権限が必要です。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

リクエスト構文

GET /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通のリクエストヘッダー」をご参照ください。

レスポンスヘッダー

DescribeRegions リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通のレスポンスヘッダー」をご参照ください。

レスポンス要素

要素

タイプ

説明

AccessMonitorConfiguration

コンテナ

該当なし

バケットのアクセストラッキング構成。

子ノード: Status

Status

文字列

Enabled

バケットのアクセストラッキングステータス。有効な値:

  • Enabled: アクセストラッキングが有効です。

  • Disabled: アクセストラッキングが無効です。

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

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