Cloud DB for Cache 인스턴스를 생성합니다.
Cloud DB for Cache CLI는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.
- createCloudCacheInstance CLI: Valkey, Redis DBMS 이용 가능
- createCloudRedisInstance CLI: Redis DBMS 이용 가능
createCloudCacheInstance CLI
createCloudCacheInstance CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.
구문
createCloudCacheInstance 구문은 다음과 같습니다.
./ncloud vcache createCloudCacheInstance \
--vpcNo <vpc-no> \
--subnetNo <subnet-no> \
--cloudCacheServiceName <service-name> \
--cloudCacheServerNamePrefix <server-name-prefix> \
--configGroupNo <config-group-no> \
--cloudCacheModeCode <SIMPLE|CLUSTER> \
[--cloudCacheImageProductCode <image-product-code>] \
[--cloudCacheProductCode <product-code>] \
[--engineVersionCode <engine-version-code>] \
[--shardCount <shard-count>] \
[--shardCopyCount <shard-copy-count>] \
[--isHa <true|false>] \
[--isBackup <true|false>] \
[--isAutomaticBackup <true|false>] \
[--backupTime <hh:mm>] \
[--backupFileRetentionPeriod <retention-days>] \
[--cloudCachePort <port>] \
[--cloudCacheDbmsCode <Redis|Valkey>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
createCloudCacheInstance 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
createCloudCacheInstance의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--vpcNo |
String | Required | Cloud DB for Cache 인스턴스를 생성할 VPC 번호 |
--subnetNo |
String | Required | Cloud DB for Cache 인스턴스의 Subnet 번호
|
--cloudCacheServiceName |
String | Required | Cloud DB for Cache 서비스 이름
|
--cloudCacheServerNamePrefix |
String | Required | Cloud DB for Cache 서버 이름 접두사
|
--configGroupNo |
String | Required | Config Group 번호
|
--cloudCacheModeCode |
String | Required | Cloud DB for Cache 모드
|
--backupTime |
String | Conditional | 백업 시점 설정 (HH:MM)
|
선택 옵션
createCloudCacheInstance의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--cloudCacheImageProductCode |
String | Optional | Cloud DB for Cache 이미지 상품 코드
|
--cloudCacheProductCode |
String | Optional | Cloud DB for Cache 상품 코드
|
--engineVersionCode |
String | Optional | DB 엔진 버전
|
--shardCount |
Integer | Optional | DB 모드가 Cluster인 경우 Master Node의 생성 개수
|
--shardCopyCount |
Integer | Optional | DB 모드가 Cluster인 경우 Master Node 복제본인 Slave Node의 생성 개수
|
--isHa |
Boolean | Optional | 고가용성 여부
|
--isBackup |
Boolean | Optional | DB Server의 백업 설정 여부
|
--isAutomaticBackup |
Boolean | Optional | 백업 시점 자동 설정 여부
|
--backupFileRetentionPeriod |
Integer | Optional | 백업 파일 보관 기간 (일)
|
--cloudCachePort |
Integer | Optional | Cloud DB for Cache 인스턴스에 접근하기 위한 TCP 포트 번호
|
--cloudCacheDbmsCode |
String | Optional | Cloud DB for Cache 인스턴스의 DBMS 코드
|
공통 옵션
vcache 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for Cache 옵션을 참조해 주십시오.
예시
Cloud DB for Cache 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vcache createCloudCacheInstance \
--vpcNo 12345678 \
--subnetNo 23456789 \
--cloudCacheServiceName test-cache-01 \
--cloudCacheServerNamePrefix testcache \
--configGroupNo 11099 \
--cloudCacheModeCode CLUSTER \
--cloudCacheImageProductCode SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050 \
--cloudCacheProductCode SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 \
--shardCount 3 \
--shardCopyCount 1 \
--isBackup true \
--isAutomaticBackup true \
--backupFileRetentionPeriod 1 \
--cloudCachePort 13306 \
--cloudCacheDbmsCode Valkey \
--regionCode FKR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"createCloudCacheInstanceResponse": {
"totalRows": 1,
"cloudCacheInstanceList": [
{
"cloudCacheInstanceNo": "34567890",
"cloudCacheServiceName": "test-cache-01",
"cloudCacheInstanceStatusName": "creating",
"cloudCacheInstanceStatus": {
"code": "INIT",
"codeName": "CLOUD DATABASE(VPC) Init 상태"
},
"cloudCacheInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) Creat OP"
},
"cloudCacheImageProductCode": "SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050",
"engineVersion": "VALKEY 7.2.11",
"license": {
"code": "BSD",
"codeName": "라이센스코드-CLOUD DATABASE(VPC)"
},
"cloudCachePort": 13306,
"isHa": true,
"cloudCacheServerPrefix": "testcache",
"generationCode": "G2",
"role": {
"code": "CLUSTER",
"codeName": "Cluster Role-CLOUD Cache(VPC)"
},
"createDate": "2026-06-22T14:02:02+0900",
"accessControlGroupNoList": [],
"masterNodeCount": 3,
"slaveNodeCount": 3,
"configGroupNo": "12345",
"configGroupName": "test-cfg-01",
"cloudCacheServerInstanceList": [
{
"cloudCacheServerName": "testcache-001-001-3oo5",
"cloudCacheServerRole": {
"code": "M",
"codeName": "Master"
},
"cloudCacheServerInstanceStatusName": "creating",
"cloudCacheServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudCacheServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-22T14:02:02+0900"
},
{
"cloudCacheServerName": "testcache-002-001-3oo6",
"cloudCacheServerRole": {
"code": "M",
"codeName": "Master"
},
"cloudCacheServerInstanceStatusName": "creating",
"cloudCacheServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudCacheServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-22T14:02:02+0900"
},
{
"cloudCacheServerName": "testcache-003-001-3oo7",
"cloudCacheServerRole": {
"code": "M",
"codeName": "Master"
},
"cloudCacheServerInstanceStatusName": "creating",
"cloudCacheServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudCacheServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-22T14:02:02+0900"
},
{
"cloudCacheServerName": "testcache-001-002-3oo8",
"cloudCacheServerRole": {
"code": "S",
"codeName": "Slave"
},
"cloudCacheServerInstanceStatusName": "creating",
"cloudCacheServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudCacheServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-22T14:02:02+0900"
},
{
"cloudCacheServerName": "testcache-002-002-3oo9",
"cloudCacheServerRole": {
"code": "S",
"codeName": "Slave"
},
"cloudCacheServerInstanceStatusName": "creating",
"cloudCacheServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudCacheServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-22T14:02:02+0900"
},
{
"cloudCacheServerName": "testcache-003-002-3ooa",
"cloudCacheServerRole": {
"code": "S",
"codeName": "Slave"
},
"cloudCacheServerInstanceStatusName": "creating",
"cloudCacheServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudCacheServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudCacheProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-22T14:02:02+0900"
}
]
}
],
"requestId": "1ccaa62a-c921-423e-a3c0-4a4cf92aafa0",
"returnCode": "0",
"returnMessage": "success"
}
}
createCloudRedisInstance CLI
createCloudRedisInstance CLI의 명령 구문과 옵션, 명령 및 출력 예시를 설명합니다.
구문
createCloudRedisInstance 구문은 다음과 같습니다.
./ncloud vredis createCloudRedisInstance \
--vpcNo <vpc-no> \
--subnetNo <subnet-no> \
--cloudRedisServiceName <service-name> \
--cloudRedisServerNamePrefix <server-name-prefix> \
--configGroupNo <config-group-no> \
--cloudRedisModeCode <SIMPLE|CLUSTER> \
[--cloudRedisImageProductCode <image-product-code>] \
[--cloudRedisProductCode <product-code>] \
[--engineVersionCode <engine-version-code>] \
[--shardCount <shard-count>] \
[--shardCopyCount <shard-copy-count>] \
[--isHa <true|false>] \
[--isBackup <true|false>] \
[--isAutomaticBackup <true|false>] \
[--backupTime <hh:mm>] \
[--backupFileRetentionPeriod <retention-days>] \
[--cloudRedisPort <port>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
createCloudRedisInstance 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
createCloudRedisInstance의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--vpcNo |
String | Required | Cloud DB for Cache 인스턴스를 생성할 VPC 번호 |
--subnetNo |
String | Required | Cloud DB for Cache 인스턴스의 Subnet 번호
|
--cloudRedisServiceName |
String | Required | Cloud DB for Cache 서비스 이름
|
--cloudRedisServerNamePrefix |
String | Required | Cloud DB for Cache 서버 이름 접두사
|
--configGroupNo |
String | Required | Config Group 번호
|
--cloudRedisModeCode |
String | Required | Cloud DB for Cache 모드
|
--backupTime |
String | Conditional | 백업 시점 설정 (HH:MM)
|
선택 옵션
createCloudRedisInstance의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--cloudRedisImageProductCode |
String | Optional | Cloud DB for Cache 이미지 상품 코드
|
--cloudRedisProductCode |
String | Optional | Cloud DB for Cache 상품 코드
|
--engineVersionCode |
String | Optional | DB 엔진 버전
|
--shardCount |
Integer | Optional | DB 모드가 Cluster인 경우 Master Node의 생성 개수
|
--shardCopyCount |
Integer | Optional | DB 모드가 Cluster인 경우 Master Node 복제본인 Slave Node의 생성 개수
|
--isHa |
Boolean | Optional | 고가용성 여부
|
--isBackup |
Boolean | Optional | DB Server의 백업 설정 여부
|
--isAutomaticBackup |
Boolean | Optional | 백업 시점 자동 설정 여부
|
--backupFileRetentionPeriod |
Integer | Optional | 백업 파일 보관 기간 (일)
|
--cloudRedisPort |
Integer | Optional | Cloud DB for Cache 인스턴스에 접근하기 위한 TCP 포트 번호
|
공통 옵션
vredis 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud DB for Cache 옵션을 참조해 주십시오.
예시
Cloud DB for Cache 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vredis createCloudRedisInstance \
--vpcNo 12345678 \
--subnetNo 23456789 \
--cloudRedisServiceName test-redis-01 \
--cloudRedisServerNamePrefix testredis \
--configGroupNo 11099 \
--cloudRedisModeCode CLUSTER \
--cloudRedisImageProductCode SW.VRDS.OS.LNX64.ROCKY.0810.REDIS.B050 \
--cloudRedisProductCode SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001 \
--shardCount 3 \
--shardCopyCount 1 \
--isBackup true \
--isAutomaticBackup true \
--backupFileRetentionPeriod 1 \
--cloudRedisPort 13306 \
--regionCode FKR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"createCloudRedisInstanceResponse": {
"totalRows": 1,
"cloudRedisInstanceList": [
{
"cloudRedisInstanceNo": "34567890",
"cloudRedisServiceName": "test-redis-01",
"cloudRedisInstanceStatusName": "creating",
"cloudRedisInstanceStatus": {
"code": "INIT",
"codeName": "CLOUD DATABASE(VPC) Init 상태"
},
"cloudRedisInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) Creat OP"
},
"cloudRedisImageProductCode": "SW.VRDS.OS.LNX64.ROCKY.0810.REDIS.B050",
"engineVersion": "REDIS 7.2.11",
"license": {
"code": "BSD",
"codeName": "라이센스코드-CLOUD DATABASE(VPC)"
},
"cloudRedisPort": 13306,
"isHa": true,
"cloudRedisServerPrefix": "testredis",
"generationCode": "G2",
"role": {
"code": "CLUSTER",
"codeName": "Cluster Role-CLOUD Cache(VPC)"
},
"createDate": "2026-06-25T17:02:51+0900",
"accessControlGroupNoList": [],
"masterNodeCount": 3,
"slaveNodeCount": 3,
"configGroupNo": "11099",
"configGroupName": "test-cfg-01",
"cloudRedisServerInstanceList": [
{
"cloudRedisServerName": "testredis-001-001-3ox8",
"cloudRedisServerRole": {
"code": "M",
"codeName": "Master"
},
"cloudRedisServerInstanceStatusName": "creating",
"cloudRedisServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudRedisServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-25T17:02:51+0900"
},
{
"cloudRedisServerName": "testredis-002-001-3ox9",
"cloudRedisServerRole": {
"code": "M",
"codeName": "Master"
},
"cloudRedisServerInstanceStatusName": "creating",
"cloudRedisServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudRedisServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-25T17:02:51+0900"
},
{
"cloudRedisServerName": "testredis-003-001-3oxa",
"cloudRedisServerRole": {
"code": "M",
"codeName": "Master"
},
"cloudRedisServerInstanceStatusName": "creating",
"cloudRedisServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudRedisServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-25T17:02:51+0900"
},
{
"cloudRedisServerName": "testredis-001-002-3oxb",
"cloudRedisServerRole": {
"code": "S",
"codeName": "Slave"
},
"cloudRedisServerInstanceStatusName": "creating",
"cloudRedisServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudRedisServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-25T17:02:51+0900"
},
{
"cloudRedisServerName": "testredis-002-002-3oxc",
"cloudRedisServerRole": {
"code": "S",
"codeName": "Slave"
},
"cloudRedisServerInstanceStatusName": "creating",
"cloudRedisServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudRedisServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-25T17:02:51+0900"
},
{
"cloudRedisServerName": "testredis-003-002-3oxd",
"cloudRedisServerRole": {
"code": "S",
"codeName": "Slave"
},
"cloudRedisServerInstanceStatusName": "creating",
"cloudRedisServerInstanceStatus": {
"code": "PEND",
"codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
},
"cloudRedisServerInstanceOperation": {
"code": "CREAT",
"codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
},
"cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G001",
"regionCode": "FKR",
"vpcNo": "12345678",
"subnetNo": "23456789",
"cpuCount": 4,
"memorySize": 1610612736,
"osMemorySize": 2147483648,
"createDate": "2026-06-25T17:02:51+0900"
}
]
}
],
"requestId": "9e09c347-2d17-4a14-92ae-1841eb8d645d",
"returnCode": "0",
"returnMessage": "success"
}
}