Put Object acl
処理概要
指定した オブジェクトに対して、アクセス権限を設定します。
バージョン管理
特定のバージョンのACLを設定するにはversionIdを指定します。
指定するパラメーター
パラメーター | 説明 | 必須 | サンプル値 |
---|---|---|---|
acl | ACLリクエスト 値 : なし |
○ | |
versionId | オブジェクトのバージョンID Type : int |
999122348912293847 |
指定するヘッダー
パラメーター | 説明 | 必須 | サンプル値 |
---|---|---|---|
x-amz-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 : なし |
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>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.amazonaws.com/groups/global/AuthenticatedUsers</URI>
</Grantee>
未認証ユーザー
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="Group">
<URI>http://acs.amazonaws.com/groups/global/AllUsers</URI>
</Grantee>
応答フィールド
応答フィールドはありません。
リクエストサンプル(versionId指定なし)
PUT /sample.txt?acl= HTTP/1.1
Host: my-first-bucket.jp-east-2.storage.api.nifcloud.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:wW2I1mKrZhXwIGLBnGSgQ0XbACo=
Content-Length: 961
Content-Type: text/plain
<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>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.amazonaws.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.amazonaws.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.amazonaws.com/groups/global/AllUsers</URI>
</Grantee>
<Permission>READ</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 38af1fcc-91aa-3f90-9f40-e198d990079a
Content-Length: 0
リクエストサンプル(versionId指定あり)
PUT /sample.txt?acl&versionId=999122348912293847 HTTP/1.1
Host: my-first-bucket.jp-east-2.storage.api.nifcloud.com
Date: Wed, 29 Jun 2016 12:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:wW2I1mKrZhXwIGLBnGSgQ0XbACo=
Content-Length: 961
Content-Type: text/plain
<AccessControlPolicy xmlns="http://doc.s3.amazonaws.com/doc/2006-03-01/">
<Owner>
<ID>ABC12345</ID>
<DisplayName>ABC12345</DisplayName>
</Owner>
<AccessControlList>
<Grant>
<Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
<ID>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.amazonaws.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.amazonaws.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.amazonaws.com/groups/global/AllUsers</URI>
</Grantee>
<Permission>READ</Permission>
</Grant>
</AccessControlList>
</AccessControlPolicy>
応答サンプル
HTTP/1.1 200 OK
x-amz-request-id: 38af1fcc-91aa-3f90-9f40-e198d990079a
x-amz-version-id: 999122348912293847
Content-Length: 0