---
title: "put-object-acl"
slug: "cli-objectstorage-api-level-put-object-acl"
updated: 2026-10-19T10:05:30Z
published: 2026-10-20T03:00:23Z
canonical: "cli.ncloud-docs.com/cli-objectstorage-api-level-put-object-acl"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# put-object-acl

Classic/VPC 환경에서 이용 가능합니다.

객체에 적용할 접근 제어 목록(ACL)을 설정합니다.

## 구문

`put-object-acl` 구문은 다음과 같습니다.

```
aws s3api put-object-acl \
    --bucket <bucket> \
    --key <key> \
    [--acl <acl>] \
    [--grant-read <grant-read>] \
    [--grant-write <grant-write>] \
    [--grant-full-control <grant-full-control>] \
    [--version-id <version-id>] \
    [--access-control-policy <access-control-policy>] \
    --endpoint-url <endpoint-url>
```

## 옵션

`put-object-acl` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`put-object-acl`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--bucket` | String | Required | 버킷 이름 |
| `--key` | String | Required | 객체 이름 |

### 선택 옵션

`put-object-acl`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--acl` | String | Optional | 적용할 사전 정의 ACL - `private` \| `public-read` \| `public-read-write` \| `authenticated-read` |
| `--grant-read` | String | Optional | 읽기 권한을 부여할 대상 |
| `--grant-write` | String | Optional | 쓰기 권한을 부여할 대상 |
| `--grant-full-control` | String | Optional | 모든 권한을 부여할 대상 |
| `--version-id` | String | Optional | 객체의 버전 ID |
| `--access-control-policy` | String | Optional | 권한 부여 목록과 소유자를 직접 지정하는 ACL 정책 - JSON 형식으로 입력 |

### 공통 옵션

`aws` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Object Storage 옵션](/docs/guide-objectstorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

ACL 설정 요청이 성공하면 설정이 적용되며 결과는 출력되지 않습니다.

### 명령

객체를 공개로 설정하는 명령 예시는 다음과 같습니다.

```
aws s3api put-object-acl --bucket my-test-bucket \
    --key img/image.png \
    --acl public-read \
    --endpoint-url=https://kr.object.ncloudstorage.com
```

객체를 비공개로 설정하는 명령 예시는 다음과 같습니다.

```
aws s3api put-object-acl --bucket my-test-bucket \
    --key img/image.png \
    --acl private \
    --endpoint-url=https://kr.object.ncloudstorage.com
```