createCloudMssqlInstance
- 인쇄
- PDF
createCloudMssqlInstance
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
개요
Cloud DB for MSSQL 인스턴스를 생성합니다.
요청
요청 파라미터
| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
|---|---|---|---|---|
| regionCode | No | String | - 리전 코드 Cloud DB for MSSQL 인스턴스가 생성될 리전(Region)을 결정 가능 regionCode는 getRegionList 액션을 통해서 획득 Default: getRegionList 조회 결과의 첫 번째 리전을 선택 | |
| vpcNo | Yes | String | - VPC 번호 Cloud DB for MSSQL 인스턴스가 생성될 VPC 결정 vpcNo는 getCloudMssqlTargetVpcList 액션을 통해서 획득 | |
| subnetNo | Yes | String | - Subnet 번호 생성할 Cloud MSSQL 인스턴스의 Subnet 결정 subnetNo는 getCloudMssqlTargetSubnetList 액션을 통해서 획득 Public 도메인은 Public Subnet에 생성된 DB 서버에서만 이용 신청 가능 Cloud DB for MSSQL 인스턴스 생성 이후에 Subnet 이전 불가 | |
| mirrorSubnetNo | Conditional | String | - Mirror 서버의 Subnet 번호 멀티존 여부(isMultiZone)가 false이면 입력 받지 않으며 멀티존 여부(isMultiZone)가 true이면 반드시 입력 mirrorSubnetNo는 Principal 서버의 Subnet과 Zone이 달라야 하며 같은 Public이거나 Private이어야만 함 mirrorSubnetNo는 getCloudMssqlTargetSubnetList 액션을 통해서 획득 | |
| cloudMssqlServiceName | Yes | String | 영어, 숫자, -의 특수문자, 한글만 입력 가능 Min: 3 Max: 15 | - Cloud MSSQL 서비스 이름 |
| configGroupNo | No | String | - Cloud MSSQL Config Group 번호 사전에 만들어 놓은 Config Group을 서버 생성할 때 적용 별도의 Config Group이 없을 경우 기본 제공되는 것 선택 getCloudMssqlConfigGroupList를 통해 조회 가능 Default: 0 | |
| cloudMssqlImageProductCode | No | String | - Cloud MSSQL 이미지 상품 코드 cloudMssqlImageProductCode는 getCloudMssqlImageProductList 액션의 productCode로 획득 입력하지 않을 경우 Default값으로 생성 | |
| cloudMssqlProductCode | No | String | - Cloud MSSQL 상품 코드 생성할 Cloud DB for MSSQL 인스턴스의 서버 스펙 결정 cloudMssqlProductCode는 getCloudMssqlProductList 액션의 productCode로 획득 Default: 최소 사양으로 선택. 최소 사양의 기준은 1. 메모리 2. CPU | |
| dataStorageTypeCode | No | String | - 데이터 스토리지 타입 코드 설치 이후에 데이터 스토리지 타입 변경 불가 Options: SSD or HDD Default: SSD | |
| isHa | Yes | Boolean | - 고가용성 여부 고가용성 선택 시 Standby Master 서버를 포함한 2대의 서버로 생성되며 추가 요금이 발생 Default: true | |
| isMultiZone | Conditional | Boolean | - 멀티존 여부 고가용성 여부(isHa)가 true일 경우, 멀티존 여부 선택 가능 멀티존 선택 시Principal 서버와 Mirror 서버를 서로 다른 Zone에 생성하여 더욱 높은 가용성 제공 고가용성 여부(isHa)가 true일 경우 반드시 입력 Default: false | |
| backupFileRetentionPeriod | No | Integer | Min: 1 Max: 30 | - 백업 파일 보관 기간 백업은 매일 수행, 백업 파일은 별도의 백업 스토리지에 저장. 요금은 사용하는 공간만큼 과금 Default: 1(1일) |
| backupTime | Conditional | String | HHMM 형식. 15 분 단위만 입력 가능 | - 백업 시간 백업이 수행되는 시간 설정. 자동 백업 여부(isAutomaticBackup)가 false이면 반드시 입력 예제 - 01:15 |
| isAutomaticBackup | No | Boolean | - 백업 시간 자동 여부 자동으로 백업 시간 설정 여부 선택. 자동 백업 여부(isAutomaticBackup)가 true이면 backupTime이 입력되어도 무시되고 자동 설정됨 | |
| cloudMssqlUserName | Yes | String | 영어, 숫자, _의 특수문자만 허용하며 영어로 시작해야 함 Min: 4 Max: 16 | - 접근 유저명 DB 관리자 용도로 사용할 유저명 입력 |
| cloudMssqlUserPassword | Yes | String | 8자 이상, 영어/특수문자/숫자 3개 항목에 대해 1자 이상 포함 ` & \ " ' / 스페이스는 패스워드로 사용 불가 Min: 8 Max: 20 | - 접근 패스워드 DB 관리자 용도로 사용할 유저의 패스워드 입력 |
| cloudMssqlPort | No | Integer | 1433 or Min: 10000, Max: 20000 | - Cloud MSSQL 포트 MSSQL 접근을 위한 TCP 포트 번호 입력 Default: 1433 |
| characterSetName | No | String | - DB 문자셋 DB 문자셋은 한글과 영어 collation 중에서 선택 가능 getCloudMssqlCharacterSetList API를 통해 조회 가능 Default: Korean_Wansung_CI_AS | |
| output | No | String | - 응답 결과의 포맷 타입 Options: xml | json Default: xml |
응답
응답 데이터 타입
- CloudMssqlInstanceList 타입
| CloudMssqlInstanceList extends CommonResponse |
|---|
| private Integer totalRows; |
| private List<CloudMssqlInstance> cloudMssqlInstanceList = new ArrayList<>(); |
| CloudMssqlInstance |
|---|
| 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 AccessControlGroupNoList accessControlGroupNoList; |
| CloudMssqlServerInstance |
|---|
| private String cloudMssqlServerInstanceNo; |
| private String cloudMssqlServerName; |
| private CommonCode cloudMssqlServerRole; |
| private String cloudMssqlServerInstanceStatusName; |
| private CommonCode cloudMssqlServerInstanceStatus; |
| private CommonCode cloudMssqlServerInstanceOperation; |
| private String regionCode; |
| private String zoneCode; |
| private String vpcNo; |
| private String subnetNo; |
| private Long dataStorageSize; |
| private Integer cpuCount; |
| private Long memorySize; |
| private Boolean isPublicSubnet; |
| private String cloudMssqlProductCode; |
| private String privateDomain; |
| private String publicDomain; |
| private Date createDate; |
| private Date uptime; |
| private CommonCode dataStorageType; |
| private Long usedDataStorageSize; |
| AccessControlGroupNoList |
|---|
| private List<String> accessControlGroupNoList = new ArrayList<>(); |
예시
요청 예시
ncloud vmssql createCloudMssqlInstance --regionCode FKR --vpcNo ****83 --subnetNo ****91 --mirrorSubnetNo ****92 --cloudMssqlServiceName test-**** --configGroupNo **9 --cloudMssqlImageProductCode SW.VMSSL.OS.WND64.WINNT.SVR2016.MSSQL.15020005.SE.B100 --cloudMssqlProductCode SVR.VMSSL.STAND.C002.M008.NET.HDD.B100.G002 --dataStorageTypeCode SSD --isHa true --isMultiZone true --backupFileRetentionPeriod 10 --backupTime 00:15 --isAutomaticBackup true --cloudMssqlUserName test**** --cloudMssqlUserPassword ******** --cloudMssqlPort 1433 --characterSetName Korean_Wansung_CI_AS
응답 예시
<createCloudMssqlInstanceResponse>
<requestId>c04bfdd1-e27e-4006-9bc3-bc37840ce1dd</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<cloudMssqlInstanceList>
<cloudMssqlInstance>
<cloudMssqlInstanceNo>****890</cloudMssqlInstanceNo>
<cloudMssqlServiceName>test-****</cloudMssqlServiceName>
<cloudMssqlInstanceStatusName>creating</cloudMssqlInstanceStatusName>
<cloudMssqlInstanceStatus>
<code>INIT</code>
<codeName>CLOUD DATABASE(VPC) Init State</codeName>
</cloudMssqlInstanceStatus>
<cloudMssqlInstanceOperation>
<code>CREAT</code>
<codeName>CLOUD DATABASE(VPC) Creat OP</codeName>
</cloudMssqlInstanceOperation>
<cloudMssqlImageProductCode>SW.VMSSL.OS.WND64.WINNT.SVR2016.MSSQL.15020005.SE.B100</cloudMssqlImageProductCode>
<isHa>true</isHa>
<isMultiZone>true</isMultiZone>
<license>
<code>GPL</code>
<codeName>General Public License</codeName>
</license>
<cloudMssqlPort>1433</cloudMssqlPort>
<backupFileRetentionPeriod>10</backupFileRetentionPeriod>
<backupTime>00:15</backupTime>
<configGroupNo>**9</configGroupNo>
<configGroupName>test-****-config</configGroupName>
<engineVersion>MSSQL 15.0.2000.5 Standard Edition</engineVersion>
<createDate>2021-04-12T19:30:38+0900</createDate>
<cloudMssqlServerInstanceList>
<cloudMssqlServerInstance>
<cloudMssqlServerName>test-****-001-e04</cloudMssqlServerName>
<cloudMssqlServerRole>
<code>M</code>
<codeName>Principal</codeName>
</cloudMssqlServerRole>
<cloudMssqlServerInstanceStatusName>creating</cloudMssqlServerInstanceStatusName>
<cloudMssqlServerInstanceStatus>
<code>PEND</code>
<codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
</cloudMssqlServerInstanceStatus>
<cloudMssqlServerInstanceOperation>
<code>CREAT</code>
<codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
</cloudMssqlServerInstanceOperation>
<regionCode>FKR</regionCode>
<zoneCode>FKR-1</zoneCode>
<vpcNo>****83</vpcNo>
<subnetNo>****91</subnetNo>
<dataStorageSize>10737418240</dataStorageSize>
<cpuCount>2</cpuCount>
<memorySize>8589934592</memorySize>
<isPublicSubnet>true</isPublicSubnet>
<cloudMssqlProductCode>SVR.VMSSL.STAND.C002.M008.NET.HDD.B100.G002</cloudMssqlProductCode>
<createDate>2021-05-27T19:00:00+0900</createDate>
<dataStorageType>
<code>SSD</code>
<codeName>SSD</codeName>
</dataStorageType>
</cloudMssqlServerInstance><cloudMssqlServerInstance>
<cloudMssqlServerName>test-****-001-e05</cloudMssqlServerName>
<cloudMssqlServerRole>
<code>H</code>
<codeName>Mirror</codeName>
</cloudMssqlServerRole>
<cloudMssqlServerInstanceStatusName>creating</cloudMssqlServerInstanceStatusName>
<cloudMssqlServerInstanceStatus>
<code>PEND</code>
<codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
</cloudMssqlServerInstanceStatus>
<cloudMssqlServerInstanceOperation>
<code>CREAT</code>
<codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
</cloudMssqlServerInstanceOperation>
<regionCode>FKR</regionCode>
<zoneCode>FKR-2</zoneCode>
<vpcNo>****83</vpcNo>
<subnetNo>****92</subnetNo>
<dataStorageSize>10737418240</dataStorageSize>
<cpuCount>2</cpuCount>
<memorySize>8589934592</memorySize>
<isPublicSubnet>true</isPublicSubnet>
<cloudMssqlProductCode>SVR.VMSSL.STAND.C002.M008.NET.HDD.B100.G002</cloudMssqlProductCode>
<createDate>2021-05-27T19:00:00+0900</createDate>
<dataStorageType>
<code>SSD</code>
<codeName>SSD</codeName>
</dataStorageType>
</cloudMssqlServerInstance>
</cloudMssqlServerInstanceList>
</cloudMssqlInstance>
</cloudMssqlInstanceList>
</createCloudMssqlInstanceResponse>
이 문서가 도움이 되었습니까?