---
title: "getCloudMysqlEventHistoryList"
slug: "cli-vmysql-getcloudmysqleventhistorylist"
updated: 2026-04-23T09:04:55Z
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.

# getCloudMysqlEventHistoryList

Cloud DB for MySQL 인스턴스의 이벤트 내역 목록을 조회합니다.

## 명령어<a name="명령어"></a>

명령어 구문은 다음과 같습니다.

```
ncloud vmysql getCloudMysqlEventHistoryList [regionCode] [cloudMysqlServerName] [startDate] [endDate] [pageNo] [pageSize] [output]
```

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

파라미터에 대한 설명은 다음과 같습니다.

| 파라미터 | 타입 | 필수 여부 | 설명 | 제약 사항  |
| ----- | ----- |-------| ----- |--------|
| regionCode | String | N     | Cloud DB for MySQL 인스턴스가 존재하는 리전 코드 <li> [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능 </li> <li>default: [getRegionList](/docs/cli-vserver-server-common-getregionlist) 조회 결과의 첫 번째 리전을 선택 </li>| -      |
| cloudMysqlServerName | String | Y     | Cloud DB for MySQL 서버 이름 <li> [getCloudMysqlInstanceList](/docs/cli-vmysql-getcloudmysqlinstancelist) 액션을 통해서 획득 가능 </li> | -      |
| startDate | String | Y     | 조회 시작 일자<ul><li>조회 시작 일자 형식 : yyyy-MM-dd HH:mm:ss</li><li><예시> `2024-01-01 00:00:00`</li></ul> | -      |
| endDate | String | Y     | 조회 종료 일자<ul><li>조회 종료 일자 형식 : yyyy-MM-dd HH:mm:ss</li><li><예시> `2024-12-31 23:59:59`</li></ul> | -      |
| pageNo | Integer | N     | 페이징 처리된 결과의 페이지 번호<ul><li>`pageNo`, `pageSize`를 이용하여 페이징 처리</li><li>0 (기본값)</li></ul> | min: 0 |
| pageSize | Integer | N     | 한 페이지에 보여줄 결과 개수<ul><li>`pageNo`, `pageSize`를 이용하여 페이징 처리</li><li>20 (기본값)</li></ul> | min: 1 |
| output | String | N     | 응답 결과의 포맷 타입 <li>options: xml \| json </li> <li> default: json </li> | -      | 

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

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

명령어 호출에 대한 응답 데이터 타입은 다음과 같습니다.

* CloudMysqlEventHistoryList 타입

| CloudMysqlEventHistoryList extends CommonResponse                                          |  설명 |
|--------------------------------------------------------------------------------------------|-----|
| private Integer totalRows;                                                                 |   조회된 목록의 총 개수  |
| private List&lt;CloudMysqlEventHistory&gt; cloudMysqlEventHistoryList = new ArrayList<>(); |     |

* CloudMysqlEventHistory 타입

| CloudMysqlEventHistory | 설명  |
| ---------- |-----|
| private String cloudMysqlInstanceNo; | Cloud DB for MySQL 인스턴스 번호    |
| private String cloudMysqlServerInstanceNo; | Cloud DB for MySQL 서버 인스턴스 번호    |
| private String cloudMysqlServerName; | Cloud DB for MySQL 서버 이름    |
| private String eventTime; | 이벤트 발생 시간    |
| private String eventType; | 이벤트 타입    |
| private String eventName; | 이벤트 이름    |
| private String eventContent; | 이벤트 내용    |
| private String clientIp; | 접속 IP    |

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

호출과 응답 예시를 설명합니다.

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

호출 예시는 다음과 같습니다.

```
ncloud vmysql getCloudMysqlEventHistoryList --regionCode FKR --cloudMysqlServerName abcd --startDate '2024-08-13 17:00:00' --endDate '2024-08-13 17:00:00' --pageNo 0 --pageSize 10
```

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

응답 예시는 다음과 같습니다.

응답 결과 포맷 타입(output)이 json 일 때
```json
{
  "getCloudMysqlEventHistoryListResponse": {
    "totalRows": 2,
    "cloudMysqlEventHistoryList": [
      {
        "cloudMysqlInstanceNo": "****890",
        "cloudMysqlServerInstanceNo": "****891",
        "cloudMysqlServerName": "abcd-001-****",
        "eventTime": "2024-08-13 17:10:00",
        "eventType": "DB Server",
        "eventName": "DB",
        "eventContent": "DB start",
        "clientIp": "10.x.x.x"
      },
      {
        "cloudMysqlInstanceNo": "****890",
        "cloudMysqlServerInstanceNo": "****891",
        "cloudMysqlServerName": "abcd-001-****",
        "eventTime": "2024-08-13 17:20:00",
        "eventType": "DB Server",
        "eventName": "DB",
        "eventContent": "Change Spec MySQL Completed",
        "clientIp": "10.x.x.x"
      }
    ],
    "requestId": "36cc2f85-****-****-****-5d2511df4e45",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

응답 결과 포맷 타입(output)이 xml 일 때
```xml
<?xml version="1.0" encoding="UTF-8"?>
<cloudMysqlEventHistoryList>
    <requestId>36cc2f85-****-****-****-5d2511df4e45</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>2</totalRows>
    <cloudMysqlEventHistoryList>
        <CloudMysqlEventHistory>
            <cloudMysqlInstanceNo>****890</cloudMysqlInstanceNo>
            <cloudMysqlServerInstanceNo>****891</cloudMysqlServerInstanceNo>
            <cloudMysqlServerName>abcd-001-****</cloudMysqlServerName>
            <eventTime>2024-08-13 17:10:00</eventTime>
            <eventType>DB Server</eventType>
            <eventName>DB</eventName>
            <eventContent>DB start</eventContent>
            <clientIp>10.x.x.x</clientIp>
        </CloudMysqlEventHistory>
        <CloudMysqlEventHistory>
            <cloudMysqlInstanceNo>****890</cloudMysqlInstanceNo>
            <cloudMysqlServerInstanceNo>****891</cloudMysqlServerInstanceNo>
            <cloudMysqlServerName>abcd-001-****</cloudMysqlServerName>
            <eventTime>2024-08-13 17:10:00</eventTime>
            <eventType>DB Server</eventType>
            <eventName>DB</eventName>
            <eventContent>Change Spec MySQL Completed</eventContent>
            <clientIp>10.x.x.x</clientIp>
        </CloudMysqlEventHistory>
    </cloudMysqlEventHistoryList>
</cloudMysqlEventHistoryList>
```