Scaling Up a DCS Instance¶

Function¶

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

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. For details on how to obtain the value of this parameter, see Obtaining a Project ID.
instance_id	String	Yes	Instance ID.

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.
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 later 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 parameters

None

Example response

None

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.

last updated: 2025-10-17 09:39 UTC - commit: 2c04f58b6d57c90c5c1aff403ada40517abc1ce9