このAPIを呼び出して、バケットのACLを設定または変更できます。
使用上の注意
PutBucketAcl操作を呼び出すときは、次の項目に注意してください。
- この操作を呼び出すには、バケットに対する書き込み権限が必要です。
- PutBucketAclは上書きセマンティクスを使用します。 新しいACLは既存のACLを上書きします。
- この操作を呼び出したときに、ACLを設定する指定されたバケットが存在しない場合は、新しいバケットが作成されます。
リクエストの構造
PUT /? acl HTTP/1.1
x-oss-acl: 権限
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue リクエストヘッダー
| ヘッダー | データ型 | 必須 | 説明 |
| x-oss-acl | String | 必須 | バケットに設定するACL。 このヘッダーは、バケットのACLを設定するためのPutBucketAclリクエストに含まれています。 このヘッダーが含まれていない場合、ACL 設定は有効になりません。 有効な値：public-read-write、public-read、private
|
PutBucketAclリクエストに含まれる共通リクエストヘッダーについては、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
PutBucketAcl要求に対する応答は、共通の応答ヘッダのみを含む。 詳細については、「共通レスポンスヘッダー」をご参照ください。
例
リクエストの例
PUT /? acl HTTP/1.1
x-oss-acl: public-read
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
日付: 2月24日金曜日2012 03:21:12 GMT
権限付与: OSS qn6qrrqxo2oawuk53otf ****:KU5h8YMUC78M30dXqf3JxrT **** レスポンスの例
- 成功応答
のHTTP/1.1 200のサンプルOK x-oss-request-id: 534B371674E88A4D8906 **** 日付: 2月24日金曜日2012 03:21:12 GMT コンテンツ長: 0 接続: キープアライブ サーバー: AliyunOSS - 不正なACL設定
のHTTP/1.1 400不正なリクエストを含むリクエストへのサンプル応答 x-oss-request-id: 56594298207FB3044385 **** 日付: 2月24日金曜日2012 03:55:00 GMT コンテンツ-長さ: 309 コンテンツタイプ: text/xml; charset=UTF-8 接続: キープアライブ サーバー: AliyunOSS <? xml version="1.0" encoding="UTF-8"? > <エラー> <Code>InvalidArgument</Code> <Message>no such bucket access control exists</Message> <RequestId>5***9</RequestId> <HostId>***-test.example.com</HostId> <ArgumentName>x-oss-acl</ArgumentName> <ArgumentValue>error-acl</ArgumentValue> </エラー>
SDK
次のプログラミング言語のOSS SDKを使用して、PutBucketAcl操作を呼び出すことができます。
エラーコード
| エラーコード | HTTPステータスコード | 説明 |
| AccessDenied | 403 |
|