---
title: "CloudMssqlInstance"
slug: "common-vapidatatype-cloudmssqlinstance"
tags: ["VPC", "Cloud DB for MSSQL"]
updated: 2026-04-23T08:55:04Z
published: 2026-04-23T09:02:00Z
canonical: "api.ncloud-docs.com/common-vapidatatype-cloudmssqlinstance"
---

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

# CloudMssqlInstance

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

Cloud DB for MSSQL 인스턴스입니다.

## 구문<a name="구문"></a>
구문은 다음과 같습니다.

```Java
private String cloudMssqlInstanceNo;
private String cloudMssqlServiceName;
private String cloudMssqlInstanceStatusName;
private CommonCode cloudMssqlInstanceStatus;
private CommonCode cloudMssqlInstanceOperation;
private String cloudMssqlImageProductCode;
private Boolean isHa;
private Boolean isMultiZone;
private CommonCode license;
private Integer cloudMssqlPort;
private Integer backupFileRetentionPeriod;
private String backupTime;
private String configGroupNo;
private String configGroupName;
private String engineVersion;
private Date createDate;
private String dbCollation;
private List<CloudMssqlServerInstance> cloudMssqlServerInstanceList;
private List<String> accessControlGroupNoList;
```

## 필드<a name="필드"></a>
필드에 대한 설명은 다음과 같습니다.

| 필드                     | 타입                                                         | 필수 여부 | 설명                                                         |
| ---------------------------- | ------------------------------------------------------------ | --------- | ------------------------------------------------------------ |
| `cloudMssqlInstanceNo`         | String                                                       | Required         | Cloud DB for MSSQL 인스턴스 번호                             |
| `cloudMssqlServiceName`        | String                                                       | Required         | Cloud DB for MSSQL 서비스 이름                               |
| `cloudMssqlInstanceStatusName` | String                                                       | Required         | Cloud DB for MSSQL 인스턴스 상태명<ul><li>`creating` \| `deleted` \| `deleting` \| `downgrading` \| `pending` \| `recovering` \| `reinstalling` \| `restarting` \| `running` \| `settingup` \| `shuttingdown` \| `stopped` \| `upgrading`</li></ul> |
| `cloudMssqlInstanceStatus`     | [CommonCode](/docs/common-vapidatatype-commoncode)           | Required         | Cloud DB for MSSQL 인스턴스 상태<ul><li>`INIT` \| `CREAT` \| `DEL`<ul><li>`INIT`: Initiated</li><li>`CREAT`: Created</li><li>`DEL`: Deleted</li></ul> |
| `cloudMssqlInstanceOperation`  | [CommonCode](/docs/common-vapidatatype-commoncode)           | Required         | Cloud DB for MSSQL 인스턴스 운영 상태<ul><li>`CREAT` \| `DEL` \| `FO` \| `NULL` \| `SETUP` \| `UPGD` \| `DWGD` \| `BKP`\| `FW`<ul><li>`CREAT`: Create</li><li>`DEL`: Delete</li><li>`FO`: Failover</li><li>`NULL`: No Operation</li><li>`SETUP`: Setup</li><li>`UPGD`: Upgrade</li><li>`DWGD`: Downgrade</li><li>`BKP`: Backup</li><li> `FW`: Failover Waiting</li></ul> |
| `cloudMssqlImageProductCode`   | String                                                       | Optional         | Cloud DB for MSSQL 이미지 상품 코드                          |
| `isHa`                         | Boolean                                                      | Required         | 고가용성 여부<ul><li>`true` \| `false`</li></ul>                                                |
| `isMultiZone`                  | Boolean                                                      | Required         | 멀티존 여부<ul><li>`true` \| `false`</li></ul>                                                  |
| `license`                      | [CommonCode](/docs/common-vapidatatype-commoncode)           | Optional         | Cloud DB for MSSQL 라이선스                                  |
| `cloudMssqlPort`               | Integer                                                      | Optional         | Cloud DB for MSSQL 포트                                      |
| `backupFileRetentionPeriod`    | Integer                                                      | Optional         | 백업 파일 보관 기간                                          |
| `backupTime`                   | String                                                       | Optional         | 백업 시간                                                    |
| `configGroupNo`                | String                                                       | Optional         | Cloud DB for MSSQL Config 그룹 번호                         |
| `configGroupName`              | String                                                       | Optional         | Cloud DB for MSSQL Config 그룹 이름                         |
| `engineVersion`                | String                                                       | Optional         | Cloud DB for MSSQL 엔진 버전                                 |
| `createDate`                   | Date                                                         | Optional         | 생성 일시                                                     |
| `dbCollation`                  | String                                                       | Optional         | Cloud DB for MSSQL 문자셋                                    |
| `cloudMssqlServerInstanceList` | List&lt;[CloudMssqlServerInstance](/docs/common-vapidatatype-cloudmssqlserverinstance)&gt; | Required         | Cloud DB for MSSQL 서버 인스턴스 목록                        |
| `accessControlGroupNoList`     | [AccessControlGroupNoList](/docs/common-vapidatatype-accesscontrolgroupnolist) | Optional         | ACG 번호 목록                                                |