---
title: "getCloudCacheTargetSubnetList"
slug: "cli-vcache-getcloudcachetargetsubnetlist"
tags: ["Cloud DB for Cache", "Subnet", "VPC"]
updated: 2026-04-23T09:04:56Z
published: 2026-04-23T09:07:31Z
---

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

# getCloudCacheTargetSubnetList

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

Subnet 리스트를 조회합니다.

:::(info) (참고)
Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.
* getCloudCacheTargetSubnetList CLI: Valkey, Redis DBMS 이용 가능
* getCloudRedisTargetSubnetList CLI: Redis DBMS 이용 가능
:::

## getCloudCacheTargetSubnetList CLI<a name="getCloudCacheTargetSubnetList CLI"></a> 
getCloudCacheTargetSubnetList CLI의 요청, 응답 형식을 설명합니다.

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

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

| 파라미터명 | 필수 여부 | 타입| 제약 사항 | 설명  |
|---|---|---|---|---|
| regionCode                 | No    | String  |       | - 리전 코드<br/>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br/>Default : getRegionList 조회 결과의 첫 번째 리전을 선택    |
| vpcNo                      | Yes   | String  |       | - 조회할 Vpc의 vpc 번호<br/>vpcNo는 [getCloudCacheTargetVpcList](/docs/cli-vcache-getcloudcachetargetvpclist) 액션을 통해서 획득 가능                                |
| cloudCacheImageProductCode | Yes   | String  |       | - Cloud Cache 이미지 상품 코드 <br/>cloudCacheImageProductCode는 [getCloudCacheImageProductList](/docs/cli-vcache-getcloudcacheimageproductlist) 액션을 통해서 획득 가능 |
| isPublic                   | No    | Boolean |       | - Public Subnet 조회 여부                                                                                                                                  |
| output                     | No    | String  |       | - 응답 결과의 포맷 타입<br/>Options: xml \| json<br/>Default: json                                                                                              |

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

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

- TargetSubnetList 타입

| TargetSubnetList extends CommonResponse                                |
|------------------------------------------------------------------------|
| private Integer totalRows;                                             |
| private List&lt;TargetSubnet&gt; TargetSubnetList = new ArrayList<>(); |

| TargetSubnet               | 
|----------------------------|
| private String subnetNo;   |
| private String subnetName; |
| private String vpcNo;      | 
| private String vpcName;    |
| private String zoneCode;   | 
| private String subnet;     | 
| private Boolean isPublic;  |
| private Date createdDate;  |
### 예시<a name="예시"></a>

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

```http
ncloud vcache getCloudCacheTargetSubnetList --regionCode=FKR --vpcNo=39** --cloudCacheImageProductCode=SW.VRDS.OS.LNX64.ROCKY.0810.CACHE.B050
```

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

```xml

<getCloudCacheTargetSubnetListResponse>
    <requestId>3d4f057b-fa19-4baa-9cbc-d49074665ae9</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <targetSubnetList>
        <targetSubnet>
            <subnetNo>57**</subnetNo>
            <subnetName>f**</subnetName>
            <vpcNo>39**</vpcNo>
            <vpcName>exercise2</vpcName>
            <zoneCode>KR-1</zoneCode>
            <subnet>10.2.1.0/24</subnet>
            <isPublic>false</isPublic>
            <createdDate>2022-03-24T18:00:00+0900</createdDate>
        </targetSubnet>
    </targetSubnetList>
</getCloudCacheTargetSubnetListResponse>
```

## getCloudRedisTargetSubnetList CLI<a name="getCloudRedisTargetSubnetList CLI"></a> 
getCloudRedisTargetSubnetList CLI의 요청, 응답 형식을 설명합니다.

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

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

| 파라미터명                      | 필수 여부 | 타입      | 제약 사항 | 설명                                                                                                                                                     |
|----------------------------|-------|---------|-------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode                 | No    | String  |       | - 리전 코드<br>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능<br>Default : getRegionList 조회 결과의 첫 번째 리전 선택     |
| vpcNo                      | Yes   | String  |       | - 조회할 Sunbet의 vpc 번호<br>vpcNo는 [getCloudCacheTargetVpcList](/docs/cli-vcache-getcloudcachetargetvpclist) 액션을 통해서 획득 가능.                               |
| cloudRedisImageProductCode | Yes   | String  |       | - Cloud Redis 이미지 상품 코드 <br>cloudRedisImageProductCode는 [getCloudCacheImageProductList](/docs/cli-vcache-getcloudcacheimageproductlist) 액션을 통해서 획득 가능 |
| isPublic                   | No    | Boolean |       | - Public Subnet 조회 여부                                                                                                                                  |
| output                     | No    | String  |       | - 응답 결과의 포맷 타입<br>Options: xml \| json<br>Default: json                                                                                              |

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

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

- TargetSubnetList 타입

| TargetSubnetList extends CommonResponse                                |
|------------------------------------------------------------------------|
| private Integer totalRows;                                             |
| private List&lt;TargetSubnet&gt; TargetSubnetList = new ArrayList<>(); |

| TargetSubnet               | 
|----------------------------|
| private String subnetNo;   |
| private String subnetName; |
| private String vpcNo;      | 
| private String vpcName;    |
| private String zoneCode;   | 
| private String subnet;     | 
| private Boolean isPublic;  |
| private Date createdDate;  |

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

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

```http
ncloud vredis getCloudRedisTargetSubnetList --regionCode FKR --vpcNo 39** --cloudRedisImageProductCode SW.VRDS.OS.LNX64.ROCKY.0810.REDIS.B050
```

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

```xml

<getCloudRedisTargetSubnetListResponse>
    <requestId>3d4f057b-fa19-4baa-9cbc-d49074665ae9</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <targetSubnetList>
        <targetSubnet>
            <subnetNo>57**</subnetNo>
            <subnetName>f**</subnetName>
            <vpcNo>39**</vpcNo>
            <vpcName>exer****</vpcName>
            <zoneCode>FKR-1</zoneCode>
            <subnet>10.2.1.0/24</subnet>
            <isPublic>false</isPublic>
            <createdDate>2022-03-24T18:00:00+0900</createdDate>
        </targetSubnet>
    </targetSubnetList>
</getCloudRedisTargetSubnetListResponse>
```