GetBucketLogging を使用してバケットのアクセスログ設定を表示 - Object Storage Service

使用上の注意

GetBucketLogging API を呼び出すには、oss:GetBucketLogging 権限が必要です。詳細については、「RAM ユーザーへのカスタムアクセスポリシーの付与」をご参照ください。

リクエスト構文

GET /?logging HTTP/1.1
Host: Host
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

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

レスポンスヘッダー

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

レスポンス要素

名前	タイプ	例	説明
BucketLoggingStatus	コンテナー	該当なし	アクセスログステータスのコンテナーです。子要素：LoggingEnabled 親要素：なし説明ソースバケットにロギングルールが設定されていない場合でも、OSS は XML メッセージボディを返しますが、BucketLoggingStatus 要素は空になります。
LoggingEnabled	コンテナー	該当なし	アクセスログ情報のコンテナーです。この要素はロギングが有効な場合にのみ返されます。子要素：TargetBucket、TargetPrefix、および LoggingRole 親要素：BucketLoggingStatus
TargetBucket	String	mybucketlogs	アクセスログが保存されるバケットです。子要素：なし親要素：BucketLoggingStatus.LoggingEnabled
TargetPrefix	String	mybucket-access_log/	保存されるアクセスログファイルのプレフィックスです。子要素：なし親要素：BucketLoggingStatus.LoggingEnabled
LoggingRole	String	AliyunOSSLoggingDefaultRole	ログストレージ認可のロールです。子要素：なし親要素：BucketLoggingStatus.LoggingEnabled

例

バケットの例

リクエスト例

Get /?logging HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com  
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

レスポンス例

ロギングルールが設定されている場合のレスポンス例

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <LoggingEnabled>
        <TargetBucket>mybucketlogs</TargetBucket>
        <TargetPrefix>mybucket-access_log/</TargetPrefix>
        <LoggingRole>AliyunOSSLoggingDefaultRole</LoggingRole>
    </LoggingEnabled>
</BucketLoggingStatus>

ロギングルールが設定されていないバケットのレスポンス

HTTP/1.1 200 
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 110  
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
</BucketLoggingStatus>

ベクターバケットの例

ベクターバケットの Host ヘッダーの region パラメーターは、汎用バケットで使用されるレガシー OSS リージョン ID (oss-cn-hangzhou など) ではなく、標準の Alibaba Cloud リージョン ID (cn-hangzhou など) を使用します。

リクエスト例

Get /?logging HTTP/1.1
Host: exampebucket-123***456.cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

レスポンス例

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 04 May 2012 05:31:04 GMT
Connection: keep-alive
Content-Length: 280  
Server: AliyunOSS

{
  "BucketLoggingStatus": {
    "LoggingEnabled": {
      "TargetBucket": "mybucketlogs",
      "TargetPrefix": "mybucket-access_log/",
      "LoggingRole": "AliyunOSSLoggingDefaultRole"
    }
  }
}

SDK

この操作は、次の SDK でサポートされています。

ossutil コマンドラインツール

GetBucketLogging API に対応する ossutil コマンドについては、「get-bucket-logging」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
NoSuchBucket	404	指定されたバケットが存在しません。
AccessDenied	403	バケットのアクセスログ設定を表示する権限がありません。この権限はバケット所有者のみに付与されます。