Updated on 2026-06-29 GMT+08:00

Modify Instance Specifications

Function

Modifying the specifications of the IoTDA instance.

URI

POST /v5/iot/{project_id}/iotda-instances/{instance_id}/resize

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Parameter description : project ID. For details, see Obtaining a Project ID.

instance_id

Yes

String

Parameter description: instance ID.

Value: Enter up to 36 characters, including lowercase letters (a-f), digits, and hyphens (-).

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

flavor

Yes

Flavor object

Parameter description: specifications of an IoTDA instance.

delay

No

Boolean

Parameter description: whether to changing the billing information of a device instance in the delayed mode. To delay the change, you need to set the change time window of the instance first.

Options:

  • true: The change is delayed. The specification change task will be executed in the specified change time window.

  • false: The specification change task is executed immediately.

Table 3 Flavor

Parameter

Mandatory

Type

Description

type

Yes

String

Parameter description : specification name of the IoTDA instance to create. For details, see Specifications.

size

No

Integer

Parameter description : unit number of the standard IoTDA instances to create. For details, see Specifications.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

order_id

String

Parameter description: order ID.

Example Requests

  • Modify the specifications of the enterprise edition instance to 2000 TPS and 100,000 devices.

    POST https://{endpoint}/v5/iot/{project_id}/iotda-instances/{instance_id}/resize
    
    {
      "flavor" : {
        "type" : "iotda.enterprise.2000tps.10wonlinedevice"
      }
    }

Example Responses

Status code: 200

OK

{
  "order_id" : "CS22121614500ABCD"
}

Status Codes

Status Code

Description

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

Error Codes

See Error Codes.