Help Center> Distributed Cache Service> API Reference> Lifecycle Management APIs> Scaling Up a DCS Instance
View PDF

Scaling Up a DCS Instance

Function

This API is used to scale up a DCS Redis or Memcached instance in the Running state, or upgrade such an instance from the single-node type to the master/standby type.

URI

POST /v1.0/{project_id}/instances/{instance_id}/extend

Table 1 describes the parameters.
Table 1 Parameter description

Parameter

Type

Mandatory

Description

project_id

String

Yes

Project ID.

instance_id

String

Yes

Instance ID.

Request

Request parameters

Table 2 describes the request parameters.
Table 2 Parameter description

Parameter

Type

Mandatory

Description

new_capacity

Integer

Yes

New specification (memory space) of the DCS instance. The new specification to which the DCS instance will be scaled up must be greater than the current specification. Unit: GB.

The value must be supported specifications. For details, see the Total Memory (GB) column in DCS Instance Specifications.

spec_code

String

Yes

Code of the new specifications.

This parameter is optional for DCS Redis 3.0 instances.

This parameter is mandatory for DCS Redis 4.0 and Redis 5.0 instances.

For details about the specification codes, see the Specification Code (spec_code in the API) column in DCS Instance Specifications.

Example request

POST https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/extend
{
    "new_capacity": 4,
    "spec_code": "redis.single.au1.large.4"
}

Response

Response parameters

None

Example response

None

Status Code

Table 3 describes the status code of successful operations. For details about other status codes, see Table 1.

Table 3 Status code

Status Code

Description

204

DCS instance scaled up successfully.