PutPublicAccessBlock

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

Ncloud Storage 버킷에 공개 액세스 차단(Public Access Block) 설정을 등록하거나 기존 설정을 덮어씁니다. 공개 액세스 차단은 버킷 정책으로 버킷이 공개되는 것을 막는 설정입니다.

참고

공개 액세스 차단에 대해 다음 내용을 참고해 주십시오.

설정을 등록한 적 없는 버킷은 네 항목이 모두 true인 상태입니다. 따라서 새로 생성한 버킷에는 공개 정책을 등록할 수 없습니다.
BlockPublicPolicy와 RestrictPublicBuckets는 입력하지 않으면 기존 값이 유지되지 않고 false로 저장됩니다(부분 갱신이 아닌 전체 교체).

요청

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

메서드	URI
PUT	-

요청 헤더

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

참고

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

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

요청 쿼리 파라미터

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

필드	타입	필수 여부	설명
`publicAccessBlock`	String	Required	공개 액세스 차단 설정 변경 요청 값 없이 키만 입력

요청 바디

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

필드	타입	필수 여부	설명
`PublicAccessBlockConfiguration`	-	Required	공개 액세스 차단 설정의 루트 요소 하위 요소 중 하나 이상 입력
`PublicAccessBlockConfiguration.BlockPublicPolicy`	Boolean	Optional	공개 정책 등록 차단 여부 `true` \| `false` `true`: 공개 정책 등록 요청을 거부 `false`: 공개 정책 등록 허용 미입력 시 `false`로 저장
`PublicAccessBlockConfiguration.RestrictPublicBuckets`	Boolean	Optional	공개 버킷 사용 제한 여부 `true` \| `false` `true`: 공개 정책이 있는 버킷에 대해 익명 요청과 다른 계정의 요청을 거부 `false`: 공개 정책대로 허용 미입력 시 `false`로 저장
`PublicAccessBlockConfiguration.BlockPublicAcls`	Boolean	Optional	ACL을 통한 공개 차단 여부 `true` (유효값) 미입력 시 `true`로 저장
`PublicAccessBlockConfiguration.IgnorePublicAcls`	Boolean	Optional	공개 ACL 무시 여부 `true` (유효값) 미입력 시 `true`로 저장

참고

요청 바디 관련하여 다음 내용을 참고해 주십시오.

Ncloud Storage는 ACL을 지원하지 않으므로 BlockPublicAcls와 IgnorePublicAcls는 항상 true입니다. false는 입력할 수 없습니다.
BlockPublicPolicy는 정책을 등록하는 시점에만 검사합니다. 공개 정책이 이미 등록된 버킷에도 true로 변경할 수 있습니다.

요청 예시

요청 예시는 다음과 같습니다. 아래 예제는 공개 정책을 등록할 수 있도록 BlockPublicPolicy와 RestrictPublicBuckets를 해제합니다.

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

<PublicAccessBlockConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <BlockPublicAcls>true</BlockPublicAcls>
    <IgnorePublicAcls>true</IgnorePublicAcls>
    <BlockPublicPolicy>false</BlockPublicPolicy>
    <RestrictPublicBuckets>false</RestrictPublicBuckets>
</PublicAccessBlockConfiguration>

응답

응답 형식을 설명합니다.

응답 헤더

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

응답 상태 코드

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

참고

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

에러 코드	HTTP 상태 코드	설명
`MalformedXML`	400	요청 바디 XML이 스키마에 맞지 않음 XML 구문 오류 같은 요소를 두 번 입력 `BlockPublicAcls`·`IgnorePublicAcls` 값이 `true`·`false`가 아님
`InvalidRequest`	400	하위 요소를 하나도 입력하지 않음
`NotSupported`	501	`BlockPublicAcls` 또는 `IgnorePublicAcls`에 `false`를 입력함

응답 예시

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

HTTP/1.1 200 OK