put-public-access-block

Prev Next

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

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

참고

Sub Account 사용자가 이 명령어를 실행하려면 Change/PutBucketPublicAccessBlock 액션 권한이 있어야 합니다.

참고

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

  • 설정을 등록한 적 없는 버킷은 네 항목이 모두 true인 상태입니다. 따라서 새로 생성한 버킷에는 공개 정책을 등록할 수 없습니다.
  • Ncloud Storage는 ACL을 지원하지 않으므로 BlockPublicAcls와 IgnorePublicAcls는 항상 true입니다. false는 입력할 수 없습니다.
  • BlockPublicPolicy와 RestrictPublicBuckets는 입력하지 않으면 기존 값이 유지되지 않고 false로 저장됩니다(부분 갱신이 아닌 전체 교체).
  • BlockPublicPolicy는 정책을 등록하는 시점에만 검사합니다. 공개 정책이 이미 등록된 버킷에도 true로 변경할 수 있습니다.

구문

put-public-access-block 구문은 다음과 같습니다.

aws s3api put-public-access-block \
    --bucket <bucket> \
    --public-access-block-configuration <public-access-block-configuration> \
    [--content-md5 <content-md5>] \
    [--checksum-algorithm <checksum-algorithm>] \
    --endpoint-url <endpoint-url>

옵션

put-public-access-block 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

put-public-access-block의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--bucket String Required 버킷 이름
--public-access-block-configuration String Required 공개 액세스 차단 설정
  • JSON 형식으로 입력하며, 아래 항목 중 하나 이상 입력
    • BlockPublicPolicy (Optional): 공개 정책 등록 차단 여부. true | false. 미입력 시 false로 저장
    • RestrictPublicBuckets (Optional): 공개 버킷 사용 제한 여부. true | false. 미입력 시 false로 저장
    • BlockPublicAcls (Optional): ACL을 통한 공개 차단 여부. true (유효값). 미입력 시 true로 저장
    • IgnorePublicAcls (Optional): 공개 ACL 무시 여부. true (유효값). 미입력 시 true로 저장

선택 옵션

put-public-access-block의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션 타입 필수 여부 설명
--content-md5 String Optional 요청 데이터의 Base64 인코딩된 128비트 MD5 해시값
  • 요청 데이터의 무결성 검증에 사용
  • 미입력 시 자동 계산
--checksum-algorithm String Optional 요청 데이터 검증에 사용할 체크섬 알고리즘
  • CRC32 | CRC32C | SHA1 | SHA256 | CRC64NVME

공통 옵션

aws 명령에서 공통으로 사용하는 옵션에 대한 정보는 Ncloud Storage 옵션을 참조해 주십시오.

예시

공개 액세스 차단 설정 요청이 성공하면 설정이 적용되며 결과는 출력되지 않습니다.

명령

공개 정책을 등록할 수 있도록 BlockPublicPolicy와 RestrictPublicBuckets를 해제하는 명령 예시는 다음과 같습니다.

aws s3api put-public-access-block --bucket my-test-bucket \
    --public-access-block-configuration '{"BlockPublicAcls":true,"IgnorePublicAcls":true,"BlockPublicPolicy":false,"RestrictPublicBuckets":false}' \
    --endpoint-url=https://kr.ncloudstorage.com

연관 명령어

연관 명령어는 다음과 같습니다.