---
title: "getCloudCacheTargetSubnetList"
slug: "cli-vcache-getcloudcachetargetsubnetlist"
tags: ["Cloud DB for Cache"]
updated: 2026-05-21T09:02:05Z
published: 2026-05-21T09:11:35Z
canonical: "cli-gov.ncloud-docs.com/cli-vcache-getcloudcachetargetsubnetlist"
---

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

# getCloudCacheTargetSubnetList

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

Cloud DB for Cache를 생성할 때 이용 가능한 Subnet 목록을 조회합니다.

참고

Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.

- getCloudCacheTargetSubnetList CLI: Valkey, Redis DBMS 이용 가능
- getCloudRedisTargetSubnetList CLI: Redis DBMS 이용 가능

## getCloudCacheTargetSubnetList CLI

getCloudCacheTargetSubnetList CLI의 요청, 응답 형식을 설명합니다.

### 요청

#### 요청 파라미터

요청 파라미터는 다음과 같습니다.

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

### 응답

#### 응답 바디

응답 바디는 다음과 같습니다.

| TargetSubnetList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<TargetSubnet> 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; |

### 예시

#### 호출 예시

```
./ncloud vcache getCloudCacheTargetSubnetList --regionCode KR --vpcNo 39** --cloudCacheImageProductCode SW.VRDS.OS.LNX64.ROCKY.08.VALKY.B050.G003
```

#### 응답 예시

```

<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

getCloudRedisTargetSubnetList CLI의 요청, 응답 형식을 설명합니다.

### 요청

#### 요청 파라미터

요청 파라미터는 다음과 같습니다.

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

### 응답

#### 응답 바디

응답 바디는 다음과 같습니다.

| TargetSubnetList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<TargetSubnet> 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; |

### 예시

#### 호출 예시

```
./ncloud vcache getCloudCacheTargetSubnetList --regionCode KR --vpcNo 39** --cloudCacheImageProductCode SW.VRDS.OS.LNX64.ROCKY.08.VALKY.B050.G003
```

#### 응답 예시

```

<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>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>
</getCloudRedisTargetSubnetListResponse>
```