--- title: "PutObjectACL" slug: "storage-objectstorage-putobjectacl" updated: 2026-09-17T09:58:30Z published: 2026-09-17T09:58:30Z canonical: "api.ncloud-docs.com/storage-objectstorage-putobjectacl" --- > ## 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. # PutObjectACL Classic/VPC環境で利用できます。 オブジェクトに適用する ACL(アクセス制御リスト)を作成します。 バケットに保存されている特定のオブジェクトへのアクセス権限を制御できます。アクセス権限は、アカウントごとに、または作成された基本 ACLに応じて付与できます。 参考 Object Storageサービスで付与可能な権限の種類と基本 ACLの詳細は、[Object Storageの概要](/docs/ja/storage-objectstorage)をご参照ください。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | PUT | /{bucket-name}/{object-name} | ### リクエスト構文 リクエスト構文は次の通りです。 ``` PUT https://{endpoint}/{bucket-name}/{object-name}?acl= # path style PUT https://{bucket-name}.{endpoint}/{object-name}?acl= # virtual host style ``` ### リクエストヘッダ PutObjectACLヘッダを紹介します。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` | String | Required | 付与する権限タイプ - `private` (デフォルト) \| `public-read` \| `authenticated-read` - `private`: 所有者に FULL_CONTROL権限を付与 - `public-read`: 所有者に FULL_CONTROL権限を、すべてのユーザーに READ権限を付与 - `authenticated-read`: 所有者に FULL_CONTROL権限を、認証済みのユーザーに READ権限を付与 | ### リクエストパスパラメータ パラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `bucket-name` | String | Required | オブジェクトが保存されているバケットの名前 | | `object-name` | String | Required | ACLを適用するオブジェクト | ### リクエストクエリパラメータ パラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `acl` | String | Required | オブジェクトに基本 ACL適用を宣言 - 値なしでキーだけ入力 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 #### 基本 ACL オブジェクトに基本 ACLを割り当てるサンプルコードは次の通りです。 ``` PUT /example-bucket/queen-bee?acl= HTTP/1.1 Authorization: {authorization-string} x-amz-date: 20161207T162842Z x-amz-acl: public-read Host: kr.object.ncloudstorage.com ``` #### オブジェクトアップロード時の ACL オブジェクトをアップロードする際に、ACLをすぐに割り当てるサンプルコードは次の通りです。 ``` PUT /example-bucket/queen-bee HTTP/1.1 Authorization: {authorization-string} x-amz-date: 20161207T162842Z x-amz-acl: public-read Host: kr.object.ncloudstorage.com ``` #### ユーザー定義 ACL ユーザーが定義した ACLを割り当てるサンプルコードは次の通りです。 ``` PUT /example-bucket/queen-bee?acl= HTTP/1.1 Authorization: {authorization-string} x-amz-date: 20161207T163315Z Content-Type: text/plain Host: kr.object.ncloudstorage.com Content-Length: 564 ``` ``` {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%98%A4%EB%A5%98%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 #### 基本 ACL 基本 ACLレスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Date: Wed, 07 Dec 2016 16:28:42 GMT Accept-Ranges: bytes x-amz-request-id: b8dea44f-af20-466d-83ec-2a8563f1617b Content-Length: 0 ``` #### オブジェクトアップロード時の ACL オブジェクトアップロード時の ACLレスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Date: Wed, 07 Dec 2016 16:28:42 GMT Accept-Ranges: bytes x-amz-request-id: b8dea44f-af20-466d-83ec-2a8563f1617b Content-Length: 0 ``` #### ユーザー定義 ACL ユーザー定義 ACLレスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Date: Wed, 07 Dec 2016 17:11:51 GMT Accept-Ranges: bytes x-amz-request-id: ef02ea42-6fa6-4cc4-bec4-c59bc3fcc9f7 Content-Length: 0 ```