--- title: "PutBucketACL" slug: "storage-objectstorage-putbucketacl" updated: 2026-09-17T09:58:30Z published: 2026-09-17T09:58:30Z canonical: "api.ncloud-docs.com/storage-objectstorage-putbucketacl" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # PutBucketACL Classic/VPC環境で利用できます。 Object Storageのバケットに適用するアクセス制御リスト(ACL)を作成したり、既存の ACLを変更したりします。 ACLを適用すると、アカウントの IDやあらかじめ作成された ACL(基本ACL)を利用して、ストレージアカウントごとに異なる権限の集合を付与できます。 参考 NAVERクラウドプラットフォーム Object Storageサービスを利用中の会員を対象に、バケットとオブジェクトへのアクセス権限を付与できます。 詳細は、[アクセス制御リスト(ACL)](/docs/ja/storage-objectstorage#%EC%A0%91%EA%B7%BC%EC%A0%9C%EC%96%B4%EB%AA%A9%EB%A1%9DACL)をご参照ください。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | PUT | {bucket-name} | ### リクエスト構文 リクエスト構文は次の通りです。 ``` PUT https://{endpoint}/{bucket-name}?acl= # path style PUT https://{bucket-name}.{endpoint}?acl= # virtual host style ``` ### リクエストヘッダ バケット ACL設定の APIヘッダを紹介します。Object Storage APIで共通して使用されるヘッダの詳細は、[Object Storageの共通ヘッダ](/docs/ja/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 | ヘッダ | 説明 | | --- | --- | | `x-amz-acl` | 所有者およびユーザーに付与された権限 | ### リクエストパスパラメータ パラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `bucket-name` | String | Required | アクセス制御リスト(ACL)を作成または変更するバケットの名前 | ### リクエストクエリパラメータ パラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `acl` | String | Optional | アクセス制御リスト(ACL)を作成または変更 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ### 基本 ACL 次は、`x-amz-acl`リクエストヘッダを通じてバケットに`public-read`権限を付与するようにリクエストするサンプルコードです。この権限が付与されると、ストレージアカウントを使用するすべてのユーザーがこのバケットの内容と ACLの詳細情報を確認できます。 ``` PUT /{bucket-name}?acl= HTTP/1.1 Host: kr.object.ncloudstorage.com X-amz-date: {Timestamp} x-amz-acl: public-read Authorization: {authorization-string} ``` ### ユーザー定義 ACL 次は、他アカウントを使用した場合、バケットに適用された ACLを確認することはできますが、バケットに保存されたオブジェクトは照会できないようにリクエストするサンプルコードです。 下記の XML内容のうち2番目のアカウントにはすべての権限が付与されているため、同じバケット内ではすべてのオペレーションを実行できます。システムにより認証されたユーザーは、誰でもバケットにあるオブジェクトを照会できます。 ``` PUT /{bucket-name}?acl= HTTP/1.1 Host: kr.object.ncloudstorage.com X-amz-date: {Timestamp} Authorization: {authorization-string} ``` ``` {owner-user-id} {owner-user-id} {first-grantee-user-id} {first-grantee-user-id} READ_ACP {second-grantee-user-id} {second-grantee-user-id} FULL_CONTROL ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスヘッダ Object Storage APIで共通して使用されるレスポンスヘッダの詳細は、[Object Storageの共通レスポンスヘッダ](/docs/ja/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。 ### レスポンスステータスコード Object Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Object Storageのレスポンスステータスコード](/docs/ja/storage-objectstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 #### 基本 ACL 基本 ACLレスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Date: Wed, 24 Aug 2016 17:45:25 GMT Accept-Ranges: bytes x-amz-request-id: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx Content-Length: 0 ``` #### ユーザー定義 ACL ユーザー定義 ACLレスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Date: Wed, 24 Aug 2016 17:45:25 GMT Accept-Ranges: bytes x-amz-request-id: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx ```