put-bucket-logging コマンドを使用して、バケットのロギングを有効にします。 - Object Storage Service

Object Storage Service (OSS) バケットのロギングを有効にします。ロギングを有効にすると、OSS は事前定義された命名規則に基づいて 1 時間ごとにアクセスログオブジェクトを生成し、指定されたバケットに保存します。

使用上の注意

ロギングを有効にする前に、この機能について理解していることを確認してください。詳細については、「ロギング」をご参照ください。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Alibaba Cloud アカウントの RAM ユーザーまたは RAM ロールは、デフォルトでは権限を持っていません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを通じて操作権限を付与する必要があります。

API	アクション	説明
PutBucketLogging	`oss:PutBucketLogging`	バケットのロギングを有効にします。
PutBucketLogging	`oss:PutObject`	バケットのロギングを有効にする際に、ログが別のバケットに書き込まれる場合、デスティネーションバケットに対するこの操作権限が必要です。

コマンド構文

ossutil api put-bucket-logging --bucket value --bucket-logging-status value [flags]

パラメーター	タイプ	説明
--bucket	string	バケットの名前。
--bucket-logging-status	string	ロギングステータス情報を格納するコンテナー。

説明

put-bucket-logging コマンドは、PutBucketLogging 操作と同等です。API 操作の詳細については、「PutBucketLogging」をご参照ください。

--bucket-logging-status

--bucket-logging-status パラメーターは、XML および JSON 形式をサポートしています。パラメーターの値が "file://" で始まる場合、構成は指定されたファイルからロードされます。

XML 形式:

<BucketLoggingStatus>
  <LoggingEnabled>
    <TargetBucket>string</TargetBucket>
    <TargetPrefix>string</TargetPrefix>
  </LoggingEnabled>
</BucketLoggingStatus>

JSON 形式:

{
  "LoggingEnabled": {
    "TargetBucket": "string",
    "TargetPrefix": "string"
  }
}

説明

サポートされているグローバルコマンドラインオプションの詳細については、「コマンドラインオプション」をご参照ください。

例

examplebucket バケットのロギングを有効にし、アクセスログに MyLog- というプレフィックスを付けて dest-bucket バケットに保存します。

XML 構成ファイル（この例では bucket-logging-status.xml）を使用する

<?xml version="1.0" encoding="UTF-8"?>
<BucketLoggingStatus>
  <LoggingEnabled>
    <TargetBucket>dest-bucket</TargetBucket>
    <TargetPrefix>MyLog-</TargetPrefix>
  </LoggingEnabled>
</BucketLoggingStatus>

コマンド例:

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.xml

JSON 構成ファイル（この例では bucket-logging-status.json）を使用する

{
  "LoggingEnabled": {
    "TargetBucket": "destBucket",
    "TargetPrefix": "MyLog-"
  }
}

コマンド例:

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.json

コマンドラインで JSON パラメーターを使用する

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status "{\"LoggingEnabled\":{\"TargetBucket\":\"destBucket\",\"TargetPrefix\":\"MyLog-\"}}"