--- title: "rebootCloudCacheServerInstance" slug: "database-vcache-rebootcloudcacheserverinstance" tags: ["Cloud DB for Cache"] updated: 2026-10-22T10:47:15Z published: 2026-10-22T10:47:15Z canonical: "api-gov.ncloud-docs.com/database-vcache-rebootcloudcacheserverinstance" --- > ## Documentation Index > Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # rebootCloudCacheServerInstance VPC 환경에서 이용 가능합니다. Cloud DB for Cache 서버 인스턴스를 재시작합니다. 참고 Cloud DB for Cache API는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다. - rebootCloudCacheServerInstance API: Valkey, Redis DBMS 이용 가능 - rebootCloudRedisServerInstance API: Redis DBMS 이용 가능 ## rebootCloudCacheServerInstance API rebootCloudCacheServerInstance API의 요청, 응답 형식을 설명합니다. ### 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET \| POST | /vcache/v2/rebootCloudCacheServerInstance | #### 요청 헤더 Cloud DB for Cache (VPC) API에서 공통으로 사용하는 헤더에 대한 정보는 [Cloud DB for Cache (VPC) 요청 헤더](/docs/database-vcache#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. #### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `regionCode` | String | Optional | 재시작할 Cloud DB for Cache 서버 인스턴스의 리전 코드 - [getRegionList](/docs/compute-vserver-server-common-getregionlist) 참조 - `getRegionList` 조회 결과의 첫 번째 리전(기본값) | | `cloudCacheServerInstanceNo` | String | Required | Cloud DB for Cache 서버 인스턴스 번호 - 재시작으로 인해 데이터 손실이 발생할 수 있으며, 고가용성 기능을 사용하지 않은 단독 서버(StandAlone)의 경우 모든 데이터가 삭제됨 - 고가용성(HA) 지원 Cluster 상품에서 Master를 재시작할 경우 페일오버(failover) 후 진행하므로 재시작 후 역할(Role)이 변경됨 - [getCloudCacheInstanceList](/docs/database-vcache-getcloudcacheinstancelist) 참조 | | `responseFormatType` | String | Optional | 응답 결과의 형식 - `xml` (기본값) \| `json` | #### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://ncloud.apigw.gov-ntruss.com/vcache/v2/rebootCloudCacheServerInstance ?regionCode=KR &cloudCacheServerInstanceNo=***821' --header 'x-ncp-apigw-timestamp: {Timestamp}' --header 'x-ncp-iam-access-key: {Access Key}' --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ### 응답 응답 형식을 설명합니다. #### 응답 바디 응답 바디는 [CloudCacheInstanceList](/docs/common-vapidatatype-cloudcacheinstancelist)를 참조해 주십시오. #### 응답 상태 코드 네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Ncloud API 응답 상태 코드](/docs/api-call-lgc-errorhandling)를 참조해 주십시오. #### 응답 예시 응답 예시는 다음과 같습니다. ``` f88759fb-fced-43fa-8d2d-ae415250adb6 0 success 1 2192*** dsd*** shuttingDown CREAT CLOUD DATABASE(VPC) Created State NULL CLOUD DATABASE(VPC) Null OP SW.VRDS.OS.LNX64.ROCKY.0810.VALKY.B050 CACHE 4.0.14 BSD Berkeley Software Distribution 6379 false false 01:00 1 AUTO dsaj**** CLUSTER CLOUD CACHE(VPC) Cluster Role 2022-02-21T14:58:44+0900 14704 3 0 4** ffsd*** G2 2192*** dsajc***-001-001-rm1 M Master shuttingDown RUN CLOUD DATABASE(VPC) Server Running State STOP CLOUD DATABASE(VPC) Server Stop OP SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 KR 16** 55** cachec-****.vpc-cdb.ntruss.com 4 1610612736 2147483648 2022-02-21T15:11:52+0900 2022-02-21T14:58:44+0900 0-5460 2192*** dsajc***-002-001-rm2 M Master running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 KR 16** 55** cachec-****.vpc-cdb.ntruss.com 4 1610612736 2147483648 2022-02-21T15:11:52+0900 2022-02-21T14:58:44+0900 5461-10922 2192*** dsaj***-003-001-rm3 M Master running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 KR 16** 55** cachec-****.vpc-cdb.ntruss.com 4 1610612736 2147483648 2022-02-21T15:11:52+0900 2022-02-21T14:58:44+0900 10923-16383 ``` ## rebootCloudRedisServerInstance API rebootCloudRedisServerInstance API의 요청, 응답 형식을 설명합니다. ### 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET \| POST | /vredis/v2/rebootCloudRedisServerInstance | #### 요청 헤더 Cloud DB for Cache (VPC) API에서 공통으로 사용하는 헤더에 대한 정보는 [Cloud DB for Cache (VPC) 요청 헤더](/docs/database-vcache#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. #### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `regionCode` | String | Optional | 재시작할 Cloud DB for Cache 서버 인스턴스의 리전 코드 - [getRegionList](/docs/compute-vserver-server-common-getregionlist) 참조 - `getRegionList` 조회 결과의 첫 번째 리전(기본값) | | `cloudRedisServerInstanceNo` | String | Required | Cloud DB for Cache 서버 인스턴스 번호 - 재시작으로 인해 데이터 손실이 발생할 수 있으며, 고가용성 기능을 사용하지 않은 단독 서버(StandAlone)의 경우 모든 데이터가 삭제됨 - 고가용성(HA) 지원 Cluster 상품에서 Master를 재시작할 경우 페일오버(failover) 후 진행하므로 재시작 후 역할(Role)이 변경됨 - [getCloudCacheInstanceList](/docs/database-vcache-getcloudcacheinstancelist) 참조 | | `responseFormatType` | String | Optional | 응답 결과의 형식 - `xml` (기본값) \| `json` | #### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://ncloud.apigw.gov-ntruss.com/vredis/v2/rebootCloudRedisServerInstance ?regionCode=KR &cloudRedisServerInstanceNo=****613' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ### 응답 응답 형식을 설명합니다. #### 응답 바디 응답 바디는 [CloudRedisInstanceList](/docs/common-vapidatatype-cloudredisinstancelist)를 참조해 주십시오. #### 응답 상태 코드 네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Ncloud API 응답 상태 코드](/docs/api-call-lgc-errorhandling)를 참조해 주십시오. #### 응답 예시 응답 예시는 다음과 같습니다. - `responseFormatType=json` 일 때 ``` { "rebootCloudRedisServerInstanceResponse": { "totalRows": 1, "cloudRedisInstanceList": [ { "cloudRedisInstanceNo": "****511", "cloudRedisServiceName": "test-****", "cloudRedisInstanceStatusName": "shuttingDown", "cloudRedisInstanceStatus": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Created State" }, "cloudRedisInstanceOperation": { "code": "NULL", "codeName": "CLOUD DATABASE(VPC) Null OP" }, "cloudRedisImageProductCode": "SW.VDBAS.VRDS.LNX64.CNTOS.0708.REDIS.7015.B050", "engineVersion": "REDIS 7.0.15", "licence": { "code": "BSD", "codeName": "Berkeley Software Distribution" }, "cloudRedisPort": 6379, "isHa": true, "isBackup": true, "backupTime": "00:15", "backupFileRetentionPeriod": 7, "backupSchedule": "AUTO", "cloudRedisServerPrefix": "test-****", "generationCode": "G2", "role": { "code": "CLUSTER", "codeName": "CLOUD REDIS(VPC) Cluster Role" }, "createDate": "2024-07-01T16:59:21+0900", "accessControlGroupNoList": [ "**50" ], "masterNodeCount": 3, "slaveNodeCount": 3, "configGroupNo": "***9", "configGroupName": "test-***-config", "cloudRedisServerInstanceList": [ { "cloudRedisServerInstanceNo": "****613", "cloudRedisServerName": "test-****-001-001-ehs", "cloudRedisServerRole": { "code": "M", "codeName": "Master" }, "cloudRedisServerInstanceStatusName": "running", "cloudRedisServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) Server Running State" }, "cloudRedisServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) Server Null OP" }, "cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002", "regionCode": "KR", "vpcNo": "****83", "subnetNo": "****91", "privateDomain": "redisc-*****.vpc-cdb.ntruss.com", "cpuCount": 4, "memorySize": 1610612736, "osMemorySize": 2147483648, "uptime": "2024-07-01T17:03:43+0900", "createDate": "2024-07-01T16:59:21+0900", "slotName": "0-5460" }, { "cloudRedisServerInstanceNo": "****616", "cloudRedisServerName": "test-****-002-001-eht", "cloudRedisServerRole": { "code": "M", "codeName": "Master" }, "cloudRedisServerInstanceStatusName": "running", "cloudRedisServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) Server Running State" }, "cloudRedisServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) Server Null OP" }, "cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002", "regionCode": "KR", "vpcNo": "****83", "subnetNo": "****91", "privateDomain": "redisc-*****.vpc-cdb.ntruss.com", "cpuCount": 4, "memorySize": 1610612736, "osMemorySize": 2147483648, "uptime": "2024-07-01T17:04:10+0900", "createDate": "2024-07-01T16:59:21+0900", "slotName": "5461-10922" }, { "cloudRedisServerInstanceNo": "****619", "cloudRedisServerName": "test-****-003-001-ehu", "cloudRedisServerRole": { "code": "M", "codeName": "Master" }, "cloudRedisServerInstanceStatusName": "running", "cloudRedisServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) Server Running State" }, "cloudRedisServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) Server Null OP" }, "cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002", "regionCode": "KR", "vpcNo": "****83", "subnetNo": "****91", "privateDomain": "redisc-*****.vpc-cdb.ntruss.com", "cpuCount": 4, "memorySize": 1610612736, "osMemorySize": 2147483648, "uptime": "2024-07-01T17:04:06+0900", "createDate": "2024-07-01T16:59:21+0900", "slotName": "10923-16383" }, { "cloudRedisServerInstanceNo": "****622", "cloudRedisServerName": "test-****-001-002-ehv", "cloudRedisServerRole": { "code": "S", "codeName": "Slave" }, "cloudRedisServerInstanceStatusName": "shuttingDown", "cloudRedisServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) Server Running State" }, "cloudRedisServerInstanceOperation": { "code": "STOP", "codeName": "CLOUD DATABASE(VPC) Server Stop OP" }, "cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002", "regionCode": "KR", "vpcNo": "****83", "subnetNo": "****91", "privateDomain": "redisc-*****.vpc-cdb.ntruss.com", "cpuCount": 4, "memorySize": 1610612736, "osMemorySize": 2147483648, "uptime": "2024-07-02T10:24:34+0900", "createDate": "2024-07-01T16:59:21+0900", "slotName": "0-5460" }, { "cloudRedisServerInstanceNo": "****625", "cloudRedisServerName": "test-****-002-002-ehw", "cloudRedisServerRole": { "code": "S", "codeName": "Slave" }, "cloudRedisServerInstanceStatusName": "running", "cloudRedisServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) Server Running State" }, "cloudRedisServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) Server Null OP" }, "cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002", "regionCode": "KR", "vpcNo": "****83", "subnetNo": "****91", "privateDomain": "redisc-*****.vpc-cdb.ntruss.com", "cpuCount": 4, "memorySize": 1610612736, "osMemorySize": 2147483648, "uptime": "2024-07-01T17:03:42+0900", "createDate": "2024-07-01T16:59:21+0900", "slotName": "5461-10922" }, { "cloudRedisServerInstanceNo": "****628", "cloudRedisServerName": "test-****-003-002-ehx", "cloudRedisServerRole": { "code": "S", "codeName": "Slave" }, "cloudRedisServerInstanceStatusName": "running", "cloudRedisServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) Server Running State" }, "cloudRedisServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) Server Null OP" }, "cloudRedisProductCode": "SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002", "regionCode": "KR", "vpcNo": "****83", "subnetNo": "****91", "privateDomain": "redisc-*****.vpc-cdb.ntruss.com", "cpuCount": 4, "memorySize": 1610612736, "osMemorySize": 2147483648, "uptime": "2024-07-01T17:03:47+0900", "createDate": "2024-07-01T16:59:21+0900", "slotName": "10923-16383" } ] } ], "requestId": "6ca6bd39-****-****-****-39e0060a5055", "returnCode": "0", "returnMessage": "success" } } ``` - `responseFormatType=xml` (기본값) 일 때 ``` 6ca6bd39-****-****-****-39e0060a5055 0 success 1 ****511 test-**** shuttingDown CREAT CLOUD DATABASE(VPC) Created State NULL CLOUD DATABASE(VPC) Null OP SW.VDBAS.VRDS.LNX64.CNTOS.0708.REDIS.7015.B050 REDIS 7.0.15 BSD Berkeley Software Distribution 6379 true true 00:15 7 AUTO test-**** G2 CLUSTER CLOUD REDIS(VPC) Cluster Role 2024-07-01T16:59:21+0900 **50 3 3 ***9 test-***-config ****613 test-****-001-001-ehs M Master shuttingDown RUN CLOUD DATABASE(VPC) Server Running State STOP CLOUD DATABASE(VPC) Server Stop OP SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 KR ****83 ****92 redisc-*****.vpc-cdb.ntruss.com 4 1610612736 2147483648 2024-07-01T17:03:43+0900 2024-07-01T16:59:21+0900 0-5460 ****616 test-****-002-001-eht M Master running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 KR ****83 ****92 redisc-*****.vpc-cdb.ntruss.com 4 1610612736 2147483648 2024-07-01T17:04:10+0900 2024-07-01T16:59:21+0900 5461-10922 ****619 test-****-003-001-ehu M Master running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 KR ****83 ****92 redisc-*****.vpc-cdb.ntruss.com 4 1610612736 2147483648 2024-07-01T17:04:06+0900 2024-07-01T16:59:21+0900 10923-16383 ****622 test-****-001-002-ehv S Slave running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 KR ****83 ****92 redisc-*****.vpc-cdb.ntruss.com 4 1610612736 2147483648 2024-07-01T17:03:43+0900 2024-07-01T16:59:21+0900 0-5460 ****625 test-****-002-002-ehw S Slave running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 KR ****83 ****92 redisc-*****.vpc-cdb.ntruss.com 4 1610612736 2147483648 2024-07-01T17:03:42+0900 2024-07-01T16:59:21+0900 5461-10922 ****628 test-****-003-002-ehx S Slave running RUN CLOUD DATABASE(VPC) Server Running State NOOP CLOUD DATABASE(VPC) Server Null OP SVR.VRDS.STAND.C004.M001.NET.SSD.B050.G002 KR ****83 ****92 redisc-*****.vpc-cdb.ntruss.com 4 1610612736 2147483648 2024-07-01T17:03:47+0900 2024-07-01T16:59:21+0900 10923-16383 ```