GetBucketLogging を呼び出してバケットのアクセスログ設定を表示する - Object Storage Service

GetBucketLogging 操作を呼び出して、バケットのアクセスログ設定を表示できます。この操作を実行できるのは、バケットのオーナーのみです。

使用上の注意

GetBucketLogging 操作を呼び出すには、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	文字列	mybucketlogs	アクセスログが保存されるバケット。子要素: なし親要素: BucketLoggingStatus.LoggingEnabled
ターゲットプレフィックス	文字列	mybucket-access_log/	保存されるアクセスログファイルのプレフィックス。子要素: なし親要素: BucketLoggingStatus.LoggingEnabled
LoggingRole	文字列	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.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

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus>
    <LoggingEnabled>
        <TargetBucket>mybucketlogs</TargetBucket>
        <TargetPrefix>mybucket-access_log/</TargetPrefix>
        <LoggingRole>AliyunOSSLoggingDefaultRole</LoggingRole>
    </LoggingEnabled>
</BucketLoggingStatus>

SDK

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

ossutil コマンドラインツール

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

エラーコード

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