--- title: "PutObjectACL" slug: "storage-objectstorage-putobjectacl" tags: ["Object Storage"] updated: 2026-09-17T09:17:01Z published: 2026-09-17T09:17:01Z 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/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/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/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/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 ```