PutBucketPolicy

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

Ncloud Storage 버킷에 버킷 정책(Bucket Policy)을 등록하거나 기존 정책을 덮어씁니다. 버킷 정책은 버킷과 버킷 내 객체에 대해 누가 어떤 작업을 할 수 있는지 정의하는 JSON 문서입니다.

요청

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

요청 헤더

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

요청 쿼리 파라미터

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

요청 바디

요청 바디는 JSON 형식의 정책 문서입니다. 문서 구조는 Amazon S3 버킷 정책과 같지만 주체·작업·대상은 Ncloud Storage 표기를 사용하므로, Amazon S3 정책 문서를 그대로 사용할 수 없습니다. 요청 바디에 대한 설명은 다음과 같습니다.

Principal 유효값

Principal과 NotPrincipal에는 모든 주체를 뜻하는 "*" 또는 주체의 NRN(Ncloud Resource Name)을 입력합니다. NRN은 직접 조합하지 않고 콘솔에서 확인하여 복사해 주십시오.

Action 유효값

Action과 NotAction에 입력할 수 있는 액션은 Ncloud Storage 권한 관리를 참조해 주십시오. 대소문자를 구분하지 않으며, 와일드카드(*, ?)를 사용할 수 있습니다.

Resource 유효값

Resource와 NotResource에는 요청을 보낸 버킷의 NRN(Ncloud Resource Name)을 입력합니다. NRN은 직접 조합하지 않고 콘솔에서 확인하여 복사해 주십시오.

Condition 유효값

Condition에 입력할 수 있는 조건 연산자는 다음과 같습니다. 연산자 이름은 대소문자를 구분합니다.

Condition에 입력할 수 있는 조건 키는 다음과 같습니다.

요청 예시

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

조건 없이 허용하는 경우

인증 정보 없이 버킷 내 모든 객체를 읽을 수 있도록 허용하는 요청 예시는 다음과 같습니다.

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PublicRead",
      "Effect": "Allow",
      "Principal": "*",
      "Action": "View/GetObject",
      "Resource": "nrn:PUB:NcloudStorage:KR:12345678:Bucket/2e2b461e-303f-4928-9e81-302d1aea9629/*"
    }
  ]
}

조건을 지정하는 경우

특정 Sub Account와 Role에 대해 지정한 IP 대역에서만 객체 조회를 허용하는 요청 예시는 다음과 같습니다.

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowFromOfficeOnly",
      "Effect": "Allow",
      "Principal": {
        "NCP": [
          "nrn:PUB:IAM::12345678:SubAccount/8f14e45f-ceea-467a-9cbd-3a1b0f5c9e21",
          "nrn:PUB:IAM::12345678:Role/1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"
        ]
      },
      "Action": [
        "View/GetObject",
        "View/ListBucket"
      ],
      "Resource": [
        "nrn:PUB:NcloudStorage:KR:12345678:Bucket/2e2b461e-303f-4928-9e81-302d1aea9629",
        "nrn:PUB:NcloudStorage:KR:12345678:Bucket/2e2b461e-303f-4928-9e81-302d1aea9629/*"
      ],
      "Condition": {
        "IpAddress": {
          "aws:SourceIp": ["10.0.0.0/24", "192.168.0.1"]
        }
      }
    }
  ]
}

응답

응답 형식을 설명합니다.

응답 헤더

응답 헤더에 대한 설명은 다음과 같습니다.

응답 상태 코드

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

응답 예시

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

HTTP/1.1 204 No Content