--- title: "PutPublicAccessBlock" slug: "ncloudstorage-putpublicaccessblock" updated: 2026-09-18T05:57:58Z published: 2026-10-14T09:00:20Z canonical: "api.ncloud-docs.com/ncloudstorage-putpublicaccessblock" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # PutPublicAccessBlock Classic/VPC 환경에서 이용 가능합니다. Ncloud Storage 버킷에 공개 액세스 차단(Public Access Block) 설정을 등록하거나 기존 설정을 덮어씁니다. 공개 액세스 차단은 버킷 정책으로 버킷이 공개되는 것을 막는 설정입니다. 참고 공개 액세스 차단에 대해 다음 내용을 참고해 주십시오. - 설정을 등록한 적 없는 버킷은 네 항목이 모두 `true`인 상태입니다. 따라서 새로 생성한 버킷에는 공개 정책을 등록할 수 없습니다. - `BlockPublicPolicy`와 `RestrictPublicBuckets`는 입력하지 않으면 기존 값이 유지되지 않고 `false`로 저장됩니다(부분 갱신이 아닌 전체 교체). ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | PUT | - | ### 요청 헤더 요청 헤더에 대한 설명은 다음과 같습니다. 참고 Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 [Ncloud Storage 요청 헤더](/docs/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. | 필드 | 필수 여부 | 설명 | | --- | --- | --- | | `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 true true false false ``` ## 응답 응답 형식을 설명합니다. ### 응답 헤더 Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 [Ncloud Storage 응답 헤더](/docs/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 응답 상태 코드 응답 상태 코드에 대한 설명은 다음과 같습니다. 참고 Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Ncloud Storage 응답 상태 코드](/docs/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. | 에러 코드 | HTTP 상태 코드 | 설명 | | --- | --- | --- | | `MalformedXML` | 400 | 요청 바디 XML이 스키마에 맞지 않음 - XML 구문 오류 - 같은 요소를 두 번 입력 - `BlockPublicAcls`·`IgnorePublicAcls` 값이 `true`·`false`가 아님 | | `InvalidRequest` | 400 | 하위 요소를 하나도 입력하지 않음 | | `NotSupported` | 501 | `BlockPublicAcls` 또는 `IgnorePublicAcls`에 `false`를 입력함 | ### 응답 예시 응답 예시는 다음과 같습니다. ``` HTTP/1.1 200 OK ```