本文へジャンプします。

Get Object acl

処理概要

指定したオブジェクトのアクセス権限情報を 取得します。

バージョン管理

特定のバージョンのACLを設定するにはversionIdを指定します。

指定するパラメーター

パラメーター 説明 必須 サンプル値
acl ACLリクエスト
値 : なし
 
versionId オブジェクトのバージョンID Type : int   999122348912293847

指定するヘッダー

必要なヘッダーはありません。

指定するボディ

必要なボディはありません。

応答フィールド

フィールド 説明 サンプル値
AccessControlPolicy AccessControlPolicyレスポンス
Type : Container
Ancestor : なし
Children : Owner,AccessControlList
 
Owner Ownerレスポンス
Type : Container
Ancestor : AccessControlPolicy
Children : ID,DisplayName
 
ID オーナーID
Type : xsd:string
Ancestor : AccessControlPolicy.Owner | AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
NCSS|ABC12345
DisplayName オーナー名
Type : xsd:string
Ancestor : AccessControlPolicy.Owner | AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
ABC12345
AccessControlList AccessControlListレスポンス
Type : Container
Ancestor : AccessControlPolicy
Children : Grant
 
Grant Grantレスポンス
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : Grantee
 
Grantee Granteeレスポンス
Type : Container
Ancestor : AccessControlPolicy.AccessControlList.Grant
Children : ID,DisplayName
 
Permission アクセス権限
FULL_CONTROL | WRITE | WRITE_ACP | READ | READ_ACP
Type : xsd:string
Ancestor : AccessControlPolicy.AccessControlList.Grant.Grantee
Children : なし
 

リクエストサンプル(versionId指定なし)

GET /sample.txt?acl= HTTP/1.1
Host: my-first-bucket.ncss.nifty.com
Date: Thu, 29 Sep 2011 12:00:00 GMT
Authorization: NIFTY 07cbb45fc128390123f4:DqvngOELb9qE8e1fv8dKpH7b2fM=

応答サンプル

HTTP/1.0 200 OK
Date: Thu, 29 Sep 2011 12:00:00 GMT
x-nifty-request-id: c73be9cc-358d-3b50-b186-522a26da2ab9
Content-Length: 439

<AccessControlPolicy xmlns="http://doc.ncss.nifty.com/2011-09-29">
  <Owner>
    <ID>NCSS|ABC12345</ID>
    <DisplayName>ABC12345</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>NCSS|ABC12345</ID>
        <DisplayName>ABC12345</DisplayName>
      </Grantee><Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

リクエストサンプル(versionId指定あり)

GET /sample.txt?acl&versionId=999122348912293847 HTTP/1.1
Host: my-first-bucket.ncss.nifty.com
Date: Thu, 29 Sep 2011 12:00:00 GMT
Authorization: NIFTY 07cbb45fc128390123f4:DqvngOELb9qE8e1fv8dKpH7b2fM=

応答サンプル

HTTP/1.0 200 OK
Date: Thu, 29 Sep 2011 12:00:00 GMT
x-nifty-request-id: c73be9cc-358d-3b50-b186-522a26da2ab9
x-nifty-version-id: 999122348912293847
Content-Length: 439

<AccessControlPolicy xmlns="http://doc.ncss.nifty.com/2011-09-29">
  <Owner>
    <ID>NCSS|ABC12345</ID>
    <DisplayName>ABC12345</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>NCSS|ABC12345</ID>
        <DisplayName>ABC12345</DisplayName>
      </Grantee><Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

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