PutObjectACL
    • PDF

    PutObjectACL

    • PDF

    기사 요약

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

    오브젝트에 적용할 ACL(접근 제어 목록)을 생성합니다.
    버킷에 저장된 특정 오브젝트에 대하여 접근 권한을 제어할 수 있습니다. 접근 권한은 계정별 또는 생성된 기본 ACL에 따라 부여할 수 있습니다.

    참고

    Object Storage 서비스에서 부여할 수 있는 권한의 종류 및 기본 ACL에 대한 설명은 Object Storage 개요를 참조해 주십시오.

    요청

    요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

    메서드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 공통 헤더를 참조해 주십시오.

    필드타입필수 여부설명
    x-amz-aclStringRequired부여할 권한 유형
    • private (기본값) | public-read | authenticated-read
      • private: 소유자에게 FULL_CONTROL 권한 부여
      • public-read: 소유자에게 FULL_CONTROL 권한 부여, 모든 사용자에게 READ 권한 부여
      • authenticated-read: 소유자에게 FULL_CONTROL 권한 부여, 인증된 사용자에게 READ 권한 부여

    요청 경로 파라미터

    파라미터에 대한 설명은 다음과 같습니다.

    필드타입필수 여부설명
    bucket-nameStringRequired오브젝트가 저장된 버킷 이름
    object-nameStringRequiredACL을 적용할 오브젝트

    요청 쿼리 파라미터

    파라미터에 대한 설명은 다음과 같습니다.

    필드타입필수 여부설명
    aclStringRequired오브젝트에 기본 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
    
    <?xml version="1.0" encoding="UTF-8"?>
    <AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
      <Owner>
        <ID>{owner-user-id}</ID>
        <DisplayName>{owner-user-id}</DisplayName>
      </Owner>
      <AccessControlList>
        <Grant>
          <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
            <ID>{first-grantee-user-id}</ID>
            <DisplayName>{first-grantee-user-id}</DisplayName>
          </Grantee>
          <Permission>READ_ACP</Permission>
        </Grant>
        <Grant>
          <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
            <ID>{second-grantee-user-id}</ID>
            <DisplayName>{second-grantee-user-id}</DisplayName>
          </Grantee>
          <Permission>FULL_CONTROL</Permission>
        </Grant>
      </AccessControlList>
    </AccessControlPolicy>
    

    응답

    응답 형식을 설명합니다.

    응답 헤더

    Object Storage API에서 공통으로 사용하는 응답 헤더에 대한 자세한 내용은 Object Storage 공통 응답 헤더를 참조해 주십시오.

    응답 상태 코드

    Object Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Object Storage 응답 상태 코드를 참조해 주십시오.

    응답 예시

    응답 예시는 다음과 같습니다.

    기본 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
    

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.