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

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

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

调试

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

请求参数

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

系统规定参数,取值:ModifyDedicatedHostClass

DedicatedHostId String ch-bp1fgj3kt7fsb****

主机ID。可调用DescribeDedicatedHosts获取。

RegionId String cn-hangzhou

主机所在地域ID。可调用DescribeDedicatedHostAttribute获取。

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

指定主机规格的升配时间,格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明 仅当SwitchTimeMode为2时,需要传入SwitchTime参数。
TargetClassCode String rds.c6.x4large

目标主机升配的规格编码,详情请参见主机规格详情

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格式

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

JSON格式

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

错误码

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

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