调用ModifyDedicatedHostClass接口升配主机的规格。

在创建专属集群MyBase主机后，如果当前主机规格配置无法满足您的业务需求，您可随时变更主机的规格，包括主机的CPU、内存等，更多信息请参见升配主机规格。

说明 主机升配会导致主机重启（主机上运行数据库实例也随之重启），关于重启主机对数据库实例产生影响，详情请参见重启主机。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyDedicatedHostClass

系统规定参数。取值：ModifyDedicatedHostClass。

RegionId String 是 cn-hangzhou

地域ID。

DedicatedHostId String 是 ch-bp1fgj3kt7fsb****

主机ID。您可以登录云数据库专属集群控制台，在主机列表查看并获取主机ID。

TargetClassCode String 是 rds.c6.x4large

主机升配的规格编码，详情请参见主机规格详情。

SwitchTime String 否 2021-07-13T07:14:22Z

指定主机规格的升配时间，格式为yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

说明 仅当SwitchTimeMode为2时，需要传入SwitchTime参数。
SwitchTimeMode String 否 2

选择升配的执行模式，取值：

  • 0（默认）：立刻执行升配。
  • 2：在指定时间执行升配。
说明 若本参数的值为2，则必须同时传入SwitchTime参数。

返回数据

名称 类型 示例值 描述
DedicatedHostId String ch-bp1fgj3kt7fsb****

主机ID。
RequestId String D6E068C3-25BC-455A-85FE-45F0B22ESD12

请求ID。
TaskId String 10254125

任务ID。

示例

请求示例

http(s)://cddc.aliyuncs.com/?Action=ModifyDedicatedHostClass
&DedicatedHostId=ch-bp1fgj3kt7fsb****
&SwitchTime=2020-10-16T16:30:19Z
&RegionId=cn-hangzhou
&TargetClassCode=rds.c6.x4large
&SwitchTimeMode=2
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDedicatedHostClassReponse>
<DedicatedHostId>ch-bp1fgj3kt7fsb****</DedicatedHostId>
<TaskId>10254125</TaskId>
<RequestId>D6E068C3-25BC-455A-85FE-45F0B22ESD12</RequestId>
</ModifyDedicatedHostClassReponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DedicatedHostId" : "ch-bp1fgj3kt7fsb****",
  "TaskId" : "10254125",
  "RequestId" : "D6E068C3-25BC-455A-85FE-45F0B22ESD12"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidAction The specified action is not valid. 指定的操作无效

访问错误中心查看更多错误码。