本文へジャンプします。

Put Object acl

処理概要

指定した オブジェクトに対して、アクセス権限を設定します。

バージョン管理

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

指定するパラメーター

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

指定するヘッダー

パラメーター 説明 必須 サンプル値
x-nifty-acl CannedACL
Type : String
Default : private
値 : private | public-read | authenticated-read
   

指定するボディ

フィールド 説明 サンプル値
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 : なし
 

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>

応答フィールド

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

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

PUT /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:wW2I1mKrZhXwIGLBnGSgQ0XbACo=
Content-Length: 961
Content-Type: text/plain

<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>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
        <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
      </Grantee>
      <Permission>WRITE</Permission>
    </Grant>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
        <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
      </Grantee>
      <Permission>READ</Permission>
    </Grant>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
        <URI>http://acs.nifty.com/groups/global/AllUsers</URI>
      </Grantee>  
      <Permission>READ</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

応答サンプル

HTTP/1.1 200 OK
x-nifty-request-id: 38af1fcc-91aa-3f90-9f40-e198d990079a
Content-Length: 0

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

PUT /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:wW2I1mKrZhXwIGLBnGSgQ0XbACo=
Content-Length: 961
Content-Type: text/plain

<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>
    <Grant>
    <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
      <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
    </Grantee>
      <Permission>WRITE</Permission>
    </Grant>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
      <URI>http://acs.nifty.com/groups/global/AuthenticatedUsers</URI>
    </Grantee>
      <Permission>READ</Permission>
    </Grant>
    <Grant>
    <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
      <URI>http://acs.nifty.com/groups/global/AllUsers</URI>
    </Grantee>
      <Permission>READ</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

応答サンプル

HTTP/1.1 200 OK
x-nifty-request-id: 38af1fcc-91aa-3f90-9f40-e198d990079a
x-nifty-version-id: 999122348912293847
Content-Length: 0

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