---
title: "getCloudPostgresqlBucketList"
slug: "cli-vpostgresql-getcloudpostgresqlbucketlist"
tags: ["Object Storage", "Cloud DB for PostgreSQL"]
updated: 2026-06-25T09:10:29Z
published: 2026-06-25T09:10:29Z
canonical: "cli-fin.ncloud-docs.com/cli-vpostgresql-getcloudpostgresqlbucketlist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getCloudPostgresqlBucketList

Cloud DB for PostgreSQL 에서 사용할 수 있는 Object Storage 버킷 목록을 조회합니다.

## 명령어<a name="명령어"></a>

명령어 구문은 다음과 같습니다.

```
ncloud vpostgresql getCloudPostgresqlBucketList [regionCode] [getCloudPostgresqlBucketList] [output]
```

### 파라미터<a name="파라미터"></a>

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

| 파라미터                      | 타입   | 필수 여부 | 설명                                                         | 제약 사항 |
| ------------------------------- | ------ | --------- | ------------------------------------------------------------ | --------- |
| regionCode                      | String | N         | 리전 코드<br>- regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득<br>- default: getRegionList 조회 결과의 첫 번째 리전을 선택 | -         |
| cloudPostgresqlServerInstanceNo | String | Y         | Cloud DB for PostgreSQL 서버 인스턴스 번호<br>- cloudPostgresqlServerInstanceNo는 [getCloudPostgresqlInstanceList](/docs/cli-vpostgresql-getcloudpostgresqlinstancelist) 액션을 통해서 획득<br>- 입력 시 해당 인스턴스에서 접근 가능한 Object Storage 버킷 목록 조회 | -         |
| output                          | String | N         | 응답 결과의 포맷 타입<br>- options: xml \| json<br>- default: json | - |

## 응답<a name="응답"></a>

### 응답 데이터 타입<a name="응답데이터타입"></a>

- CloudPostgresqlBucketList 타입

| CloudPostgresqlBucketList extends CommonResponse             | 설명                              |
| ------------------------------------------------------------ | --------------------------------- |
| private Integer totalRows;                                   | 조회된 목록의 총 개수             |
| private List&lt;CloudPostgresqlBucket&gt; cloudPostgresqlBucketList = new ArrayList<>(); | Cloud DB for PostgreSQL 버킷 목록 |

- CloudPostgresqlBucket 타입

| CloudPostgresqlBucket      | 설명                         |
| -------------------------- | ---------------------------- |
| private String bucketName; | Cloud DB for PostgreSQL 버킷 |

## 예시<a name="예시"></a>

호출과 응답 예시를 설명합니다.

### 호출 예시<a name="호출예시"></a>

호출 예시는 다음과 같습니다.

```
ncloud vpostgresql getCloudPostgresqlBucketList --regionCode FKR --cloudPostgresqlServerInstanceNo ****891
```

### 응답 예시<a name="응답예시"></a>

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

응답 결과 포맷 타입(output)이 json 일 때
```json
{
  "getCloudPostgresqlBucketListResponse": {
    "requestId": "40cb968e-72ef-42d3-adc3-e392e8f7cc99",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 2,
    "cloudPostgresqlBucketList": [
      {
        "bucketName": "bucket***"
      },
      {
        "bucketName": "bucket***"
      }
    ]
  }
}
```

응답 결과 포맷 타입(output)이 xml 일 때
```xml
<getCloudPostgresqlBucketListResponse>
    <requestId>40cb968e-72ef-42d3-adc3-e392e8f7cc99</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>2</totalRows>
    <cloudPostgresqlBucketList>
        <cloudPostgresqlBucket>
            <bucketName>bucket***</bucketName>
        </cloudPostgresqlBucket>
        <cloudPostgresqlBucket>
            <bucketName>bucket***</bucketName>
        </cloudPostgresqlBucket>
    </cloudPostgresqlBucketList>
</getCloudPostgresqlBucketListResponse>
```