PutBucketOwnershipControls

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

Ncloud Storage 버킷의 객체 소유권(Object Ownership) 설정을 변경합니다.

참고

객체 소유권 설정에 대해 다음 내용을 참고해 주십시오.

Ncloud Storage는 ACL(Access Control List)을 지원하지 않으므로 객체 소유권은 항상 BucketOwnerEnforced이며, 버킷에 업로드한 모든 객체는 버킷 소유자의 소유가 됩니다. BucketOwnerEnforced만 입력할 수 있습니다.
객체 소유권 설정 삭제는 지원하지 않습니다.

요청

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

메서드	URI
PUT	-

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

참고

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 요청 헤더를 참조해 주십시오.

필드	필수 여부	설명
`Content-MD5`	Optional	요청 바디의 Base64 인코딩된 128비트 MD5 해시값 요청 바디 무결성 검증에 사용
`x-amz-checksum-*`	Optional	체크섬 해시 값 키의 `*`에 사용한 알고리즘 입력 지원 알고리즘: `crc32` \| `crc32c` \| `sha1` \| `sha256` \| `crc64nvme`

요청 쿼리 파라미터

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

필드	타입	필수 여부	설명
`ownershipControls`	String	Required	객체 소유권 설정 변경 요청 값 없이 키만 입력

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`OwnershipControls`	-	Required	객체 소유권 설정의 루트 요소
`OwnershipControls.Rule`	Object	Required	객체 소유권 규칙
`OwnershipControls.Rule.ObjectOwnership`	String	Required	객체 소유권 `BucketOwnerEnforced` (유효값) ACL을 사용하지 않고, 버킷 소유자가 모든 객체를 소유 그 외 값 입력 시 `NotSupported` 반환

요청 예시

요청 예시는 다음과 같습니다.

PUT /?ownershipControls HTTP/1.1
Host: bucket.kr.ncloudstorage.com

<OwnershipControls xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Rule>
        <ObjectOwnership>BucketOwnerEnforced</ObjectOwnership>
    </Rule>
</OwnershipControls>

응답

응답 형식을 설명합니다.

응답 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 응답 헤더를 참조해 주십시오.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

참고

Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud Storage 응답 상태 코드를 참조해 주십시오.

에러 코드	HTTP 상태 코드	설명
`MalformedXML`	400	요청 바디 XML이 스키마에 맞지 않음
`NotSupported`	501	`ObjectOwnership`이 `BucketOwnerEnforced`가 아님

응답 예시

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

HTTP/1.1 200 OK