---
title: "getVpcList"
slug: "cli-vpc-vpcmanagement-getvpclist"
updated: 2026-04-23T08:57:12Z
published: 2026-04-23T08:58:59Z
canonical: "cli.ncloud-docs.com/cli-vpc-vpcmanagement-getvpclist"
---

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

# getVpcList

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

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

VPC 리스트를 조회합니다.

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

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

| 파라미터명                            | 필수 여부      | 타입                   | 제약 사항               | 설명                                         |
| ---------------------------------- | ------------ | --------------------- | --------------------- | ------------------------------------------- |
| regionCode                         | No           | String                |                       | - 리전 코드<br/>VPC 리스트가 조회될 리전(Region) 결정 가능<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br/>Default : getRegionList 조회 결과의 첫 번째 리전을 선택  |
| vpcStatusCode                      | No           | String                |                       | - VPC 상태 코드<br/>VPC 상태 코드로 필터링하여 검색 가능<br/>Options : INIT \| CREATING \| RUN \| TERMTING    |
| vpcName                            | No           | String                |                       | - VPC 이름<br/>VPC 이름으로 필터링하여 검색 가능  |
| vpcNoList.N                        | No           | List&lt;String&gt;    |                       | - VPC 번호 리스트<br/>VPC 번호로 필터링하여 검색 가능<br/>vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해 획득 가능<br/>ex) --vpcNoList 1234 2345 |
| responseFormatType                 | No           | String                |                       | - 응답 결과의 포맷 타입<br/>Options : xml \| json<br/>Default : xml |

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

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

| VpcList extends CommonResponse |
| ---------- |
| private Integer totalRows; |
| private List<Vpc> vpcList = new ArrayList<>(); |

| Vpc |
| ---------- |
| private String vpcNo; |
| private String vpcName; |
| private String ipv4CidrBlock; |
| private CommonCode vpcStatus; |
| private String regionCode; |
| private Date createDate; |


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

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

```
ncloud vpc getVpcList --regionCode KR --vpcStatusCode RUN --vpcName test-*** --vpcNoList ***04
```

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

```xml
<getVpcListResponse>
  <requestId>9b37ea3e-3ca9-462f-abad-6e23a35fcb76</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <vpcList>
    <vpc>
      <vpcNo>***04</vpcNo>
      <vpcName>test-***</vpcName>
      <ipv4CidrBlock>***.***.0.0/16</ipv4CidrBlock>
      <vpcStatus>
        <code>RUN</code>
        <codeName>run</codeName>
      </vpcStatus>
      <regionCode>KR</regionCode>
      <createDate>2020-07-16T22:23:50+0900</createDate>
    </vpc>
  </vpcList>
</getVpcListResponse>
```