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 옵션을 참조해 주십시오.

예시

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