---
title: "getCloudCacheBackupList"
slug: "cli-vcache-getcloudcachebackuplist"
tags: ["Backup", "Cloud DB for Cache"]
updated: 2026-06-25T09:10:27Z
published: 2026-06-25T09:10:27Z
canonical: "cli-fin.ncloud-docs.com/cli-vcache-getcloudcachebackuplist"
---

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

# getCloudCacheBackupList

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

Cloud DB for Cache 백업 리스트를 조회합니다.

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

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

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

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

| 파라미터명      | 필수 여부 | 타입     | 제약 사항 | 설명                                                                                                                                                                                      |
|------------|-------|--------|-------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode | No    | String |       | - 리전 코드<br/>Cloud DB for Cache 백업 리스트가 조회될 리전(Region) 결정 가능<br/>regionCode는 [getRegionList](/docs/cli-server-getregionlist) 액션을 통해 획득 가능<br/>Default : getRegionList 조회 결과의 첫 번째 리전을 선택 |
| output     | No    | String |       | - 응답 결과의 포맷 타입<br/>Options: xml \| json<br/>Default: json                                                                                                                               |

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

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

- CloudCacheBackupList 타입

| CloudCacheBackupList extends CommonResponse                                      |
|----------------------------------------------------------------------------------|
| private Integer totalRows;                                                       |
| private List&lt;CloudCacheBackup&gt; cloudCacheInstanceList = new ArrayList<>(); |

| CloudCacheBackup                           |
|--------------------------------------------|
| private String cloudCacheInstanceNo;       |
| private String cloudCacheServiceName;      |
| private Integer backupFileRetentionPeriod; |
| private String backupTime;                 |
| private Long backupSize;                   |
| private Date lastBackupDate;               |
| private CommonCode backupType;             |
| private Integer shardCount;                |

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

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

```
ncloud vcache getCloudCacheBackupList --regionCode FKR 
```

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

```xml

<getCloudCacheBackupListResponse>
    <requestId>94edea29-9c1e-44f5-9e9c-120f22688ca1</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudCacheBackupList>
        <cloudCacheBackup>
            <cloudCacheInstanceNo>****890</cloudCacheInstanceNo>
            <cloudCacheServiceName>test-****</cloudCacheServiceName>
            <backupFileRetentionPeriod>1</backupFileRetentionPeriod>
            <backupTime>00:30</backupTime>
            <backupSize>302</backupSize>
            <lastBackupDate>2021-05-25T00:00:00+0900</lastBackupDate>
            <backupType>
                <code>SIMPLE</code>
                <codeName>CLOUD CACHE(VPC) Cluster Backup Type</codeName>
            </backupType>
            <shardCount>1</shardCount>
        </cloudCacheBackup>
    </cloudCacheBackupList>
</getCloudCacheBackupListResponse>
```

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


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

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

| 파라미터명      | 필수 여부 | 타입     | 제약 사항 | 설명                                                                                                                                                                                                     |
|------------|-------|--------|-------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode | No    | String |       | - 리전 코드<br>Cloud DB for Cache 백업 리스트가 조회될 리전(Region) 결정 가능<br>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능<br>Default : getRegionList 조회 결과의 첫 번째 리전을 선택 |
| output     | No    | String |       | - 응답 결과의 포맷 타입<br>Options: xml \| json<br>Default: json                                                                                                                                              |

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

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

- CloudRedisBackupList 타입

| CloudRedisBackupList extends CommonResponse                                      |
|----------------------------------------------------------------------------------|
| private Integer totalRows;                                                       |
| private List&lt;CloudRedisBackup&gt; cloudRedisInstanceList = new ArrayList<>(); |

| CloudRedisBackup                           |
|--------------------------------------------|
| private String cloudRedisInstanceNo;       |
| private String cloudRedisServiceName;      |
| private Integer backupFileRetentionPeriod; |
| private String backupTime;                 |
| private Long backupSize;                   |
| private Date lastBackupDate;               |
| private CommonCode backupType;             |
| private Integer shardCount;                |

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

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

```
ncloud vredis getCloudRedisBackupList --regionCode FKR 
```

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

<getCloudRedisBackupListResponse>
    <requestId>94edea29-9c1e-44f5-9e9c-120f22688ca1</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudRedisBackupList>
        <cloudRedisBackup>
            <cloudRedisInstanceNo>****890</cloudRedisInstanceNo>
            <cloudRedisServiceName>test-****</cloudRedisServiceName>
            <backupFileRetentionPeriod>1</backupFileRetentionPeriod>
            <backupTime>00:30</backupTime>
            <backupSize>302</backupSize>
            <lastBackupDate>2021-05-25T00:00:00+0900</lastBackupDate>
            <backupType>
                <code>CLUSTER</code>
                <codeName>CLOUD REDIS(VPC) Cluster Backup Type</codeName>
            </backupType>
            <shardCount>3</shardCount>
        </cloudRedisBackup>
    </cloudRedisBackupList>
</getCloudRedisBackupListResponse>
```