Help Center/ Distributed Cache Service/ API Reference (Kuala Lumpur Region)/ Lifecycle Management APIs/ Scaling Up a DCS Instance
Updated on 2022-08-06 GMT+08:00
View PDF
Share

Scaling Up a DCS Instance

Function

This API is used to scale up a DCS Redis or Memcached instance in the Running state.

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 the "DCS Instance Specifications" section in Distributed Cache Service User Guide.

spec_code

String

Yes

DCS instance specification code.

This parameter is optional for DCS Redis 3.0 instances.

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

Example request

  • Request URL: 
    POST https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/extend
  • Example: 
    {
    "spec_code":"redis.single.au1.large.4",
    "new_capacity":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

Scale-up task submitted successfully.