Upgrades host specifications.
Operation description
After a host is created in a dedicated cluster, you can modify the specifications of the host based on your business requirements. The host specifications include the CPU and memory resources. For more information, see Upgrade host specifications.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID. | cn-hangzhou |
DedicatedHostId | string | Yes | The host ID. You can log on to the ApsaraDB for MyBase console and go to the Hosts page to view the host ID. | ch-bp1fgj3kt7fsb**** |
TargetClassCode | string | Yes | The instance type to which you want the host to be upgraded. For more information, see Host specification details. | rds.c6.x4large |
SwitchTime | string | No | The time when you want to upgrade the specifications of the host. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
This parameter must be specified only when SwitchTimeMode is set to 2.
| 2021-07-13T07:14:22Z |
SwitchTimeMode | string | No | The execution mode that is used to upgrade host specifications. Valid values:
If you set this parameter to 2, you must specify SwitchTime.
| 2 |
Response parameters
Examples
Sample success responses
JSON
format
{
"DedicatedHostId": "ch-bp1fgj3kt7fsb****",
"RequestId": "D6E068C3-25BC-455A-85FE-45F0B22ESD12",
"TaskId": "10254125"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidAction | The specified action is not valid. | The specified action is not valid. |
For a list of error codes, visit the Service error codes.