---
title: "getZoneList"
slug: "cli-server-getzonelist"
updated: 2026-04-23T08:56:58Z
published: 2026-04-23T08:58:53Z
canonical: "cli.ncloud-docs.com/cli-server-getzonelist"
---

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

# getZoneList

## 개요<a name="개요"></a>

존(Zone)리스트조회

## 설명 <a name="설명"></a>

네이버 클라우드 플랫폼에서 제공하는 존(Zone)은 DS(Distribution Switch) 기준으로 나누어 집니다.
서버 인스턴스(VM)를 생성할 때 특정한 존(Zone)에 생성할 수 있습니다.
따라서 네이버 클라우드 플랫폼에서 제공하는 존(Zone) 정보를 조회할 수 있어야 합니다.

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

| 파라미터 명    | 필수 여부 | 타입     | 제약사항   | 설명 |
| -------- | ----- | ------ | ---- | ---- |
| regionNo | No  | String |      | 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능 |

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

- ZoneList 타입

| ZoneList extends CommonResponse          |
| ---------------------------------------- |
| private List<Zone> zoneList = new ArrayList<Zone>(); |

| Zone                                     |
| ---------------------------------------- |
| private String zoneNo;                   |
| private String zoneName;                 |
| private String zoneCode;                 |
| private String zoneDescription;          |
| private String regionNo                  |

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

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

```
ncloud server getZoneList
```

### 응답 <a name="응답"></a>
 
```json
{
  "getZoneListResponse": {
    "requestId": "2de68ee1-c1f6-47c3-910c-293ea916a282",
    "returnCode": "0",
    "returnMessage": "success",
    "zoneList": [
      {
        "zoneNo": "2",
        "zoneName": "KR-1",
        "zoneCode": "KR-1",
        "zoneDescription": "KR-1 zone",
        "regionNo": "1"
      },
      {
        "zoneNo": "3",
        "zoneName": "KR-2",
        "zoneCode": "KR-2",
        "zoneDescription": "KR-2 zone",
        "regionNo": "1"
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8"?>
<getZoneListResponse>
  <requestId>3caa8075-b192-4dbf-b3be-2756465e76a8</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <zoneList>
    <zone>
      <zoneNo>3</zoneNo>
      <zoneName>KR-2</zoneName>
      <zoneCode>KR-2</zoneCode>
      <zoneDescription>평촌 zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
    <zone>
      <zoneNo>2</zoneNo>
      <zoneName>KR-1</zoneName>
      <zoneCode>KR-1</zoneCode>
      <zoneDescription>가산 zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
  </zoneList>
</getZoneListResponse>
```