本文へジャンプします。

ニフティクラウド APIリファレンス

Put Bucket logging

処理概要

指定したバケットに対して、ロギングを設定します。

  • ロギングを有効にする場合
    BucketLoggingStatusに必要項目を設定し、リクエストします。
  • ロギングを無効にする場合
    空のBucketLoggingStatusをリクエストします。

バケットオーナーのみ設定することが可能です。

  • ※TargetBucketで指定するバケットはLogDelivery ACL設定されている必要があります。
  • ※TargetBucketを指定しない場合、指定バケット内にアクセスログが作成されます。
  • ※ロギングで作成されるアクセスログについては、「付録 アクセスログ」を参照してください。

指定するパラメーター

パラメーター 説明 必須 サンプル値
logging loggingリクエスト
値 : なし
 

指定するヘッダー

指定するヘッダーはありません。

指定するボディ

フィールド 説明 サンプル値
BucketLoggingStatus BucketLoggingStatusリクエスト
Type : Container
Ancestor : なし
Children : LoggingEnabled
 
LoggingEnabled LoggingEnabledリクエスト
Type : Container
Ancestor : BucketLoggingStatus
Children : TargetBucket,TargetPrefix,TargetGrants
 
TargetBucket ログ保存先バケット
Type : xsd:string
Ancestor : BucketLoggingStatus.LoggingEnabled
Children : なし
my-first-log-bucket
TargetPrefix ログファイル名(オブジェクトキー)のプレフィックス
Type : xsd:string
Ancestor : BucketLoggingStatus.LoggingEnabled
Children : なし
access-logs/
TargetGrants TargetGrantsリクエスト
Type : Container
Ancestor : BucketLoggingStatus.LoggingEnabled
Children : Grant
 
Grant Grantリクエスト
Type : Container
Ancestor : BucketLoggingStatus.LoggingEnabled.TargetGrants.Grant.Grantee
Children : Grantee,Permission
 
Grantee Granteeリクエスト
Type : Container
Ancestor : BucketLoggingStatus.LoggingEnabled.TargetGrants.Grant
Children : ID,DisplayName
 
Permission アクセス権限
FULL_CONTROL | READ|WRITE
Type : xsd:string
Ancestor : BucketLoggingStatus.LoggingEnabled.TargetGrants.Grant.Grantee
Children : なし
READ

Grantee

設定対象ユーザーと指定は以下となります。

特定ユーザー
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
  <ID>NCSS|Owner ID</ID>
  <DisplayName>Owner DisplayName(Owner ID)</DisplayName>
</Grantee>
認証ユーザー
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
  <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
未認証ユーザー
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
  <URI>http://acs.nifty.com/groups/global/AllUsers</URI>
</Grantee>

応答フィールド

応答フィールドはありません。

リクエストサンプル

PUT /?logging HTTP/1.1
Host: my-first-bucket.ncss.nifty.com
Date: Wed, 25 Jul 2012 00:00:00 GMT
Authorization: NIFTY 07cbb45fc128390123f4:9yEk4gFNL/wWrAcrml3K4g7++Dg=

<BucketLoggingStatus xmlns="http://ncss.nifty.com/doc/2011-09-29/">
 <LoggingEnabled>
  <TargetBucket>my-first-log-bucke</TargetBucket>
  <TargetPrefix>access-logs/</TargetPrefix>
  <TargetGrants>
   <Grant>
    <Grantee lns:xsi=http://www.w3.org/2001/XMLSchema-instance xsi:type="CanonicalUser">
     <ID>NCSS|ABC12345</ID>
     <DisplayName>ABC12345</DisplayName>
    </Grantee>
    <Permission>READ</Permission>
   </Grant>
  </TargetGrants>
 </LoggingEnabled>
</BucketLoggingStatus>

応答サンプル

HTTP/1.1 200 OK
x-nifty-request-id: d971e85c-1e5c-3ef5-b06c-346097415ce3

推奨画面サイズ 1024×768 以上