---
title: "GetBucketPolicy"
slug: "ncloudstorage-getbucketpolicy"
updated: 2026-09-18T05:45:36Z
published: 2026-10-14T09:00:20Z
canonical: "api.ncloud-docs.com/ncloudstorage-getbucketpolicy"
---

> ## 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.

# GetBucketPolicy

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

Ncloud Storage 버킷에 설정된 버킷 정책(Bucket Policy)을 조회합니다.

참고

버킷 정책 조회에 대해 다음 내용을 참고해 주십시오.

- 버킷을 생성한 계정만 조회할 수 있고 다른 계정에는 위임할 수 없습니다. Sub Account 사용자는 `View/GetBucketPolicy` 액션의 IAM 권한이 있으면 조회할 수 있습니다.
- 정책 문서는 정규화하여 저장하므로 등록할 때 입력한 문서와 표기가 다를 수 있습니다. 공백과 줄바꿈이 제거되고, 값이 1개인 목록은 배열 없이 표시됩니다(`Statement` 제외).

## 요청

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

| 메서드 | URI |
| --- | --- |
| GET | - |

### 요청 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 [Ncloud Storage 요청 헤더](/docs/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 쿼리 파라미터

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `policy` | String | Required | 버킷 정책 조회 요청 - 값 없이 키만 입력 |

### 요청 예시

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

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

## 응답

응답 형식을 설명합니다.

### 응답 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 [Ncloud Storage 응답 헤더](/docs/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 응답 바디

응답 바디는 JSON 형식의 정책 문서입니다. 응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `Version` | String | - | 정책 문법 버전 - `2012-10-17` \| `2008-10-17` - 등록 시 입력하지 않은 경우 `2008-10-17`로 표시 |
| `Id` | String | - | 정책 문서 식별자 - 등록한 경우 표시 |
| `Statement` | List | - | 정책 구문 목록 - 구문이 1개인 경우에도 배열로 표시 |
| `Statement.Sid` | String | - | 구문 식별자 - 등록한 경우 표시 |
| `Statement.Effect` | String | - | 구문 적용 방식 - `Allow` \| `Deny` - 등록 시 입력한 대소문자와 관계없이 `Allow`, `Deny`로 표시 |
| `Statement.Principal` | String \| Object | - | 구문을 적용할 주체 - `NotPrincipal`을 등록한 구문에는 표시되지 않음 |
| `Statement.NotPrincipal` | Object | - | 구문 적용에서 제외할 주체 - 등록한 경우 표시 |
| `Statement.Action` | String \| List | - | 구문을 적용할 작업 - `NotAction`을 등록한 구문에는 표시되지 않음 |
| `Statement.NotAction` | String \| List | - | 구문 적용에서 제외할 작업 - 등록한 경우 표시 |
| `Statement.Resource` | String \| List | - | 구문을 적용할 대상 - `NotResource`를 등록한 구문에는 표시되지 않음 |
| `Statement.NotResource` | String \| List | - | 구문 적용에서 제외할 대상 - 등록한 경우 표시 |
| `Statement.Condition` | Object | - | 구문을 적용할 조건 - 등록한 경우 표시 - 조건 값은 문자열로 표시 |

### 응답 상태 코드

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

참고

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 상태 코드 | 설명 |
| --- | --- | --- |
| `NoSuchBucketPolicy` | 404 | 버킷에 정책이 존재하지 않음 |
| `AccessDenied` | 403 | 버킷을 생성한 계정이 아닌 계정의 요청 |
| `MethodNotAllowed` | 405 | 버킷을 생성한 계정이 아닌 계정의 요청이며, 버킷 정책이 그 계정에 `View/GetBucketPolicy`를 허용함 |

### 응답 예시

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

```
HTTP/1.1 200 OK
Content-Type: application/json

{"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/*"}]}
```