调用ReplaceDedicatedHost接口替换RDS主机。
主机组功能以集群形式批量管理实例,一个地域创建多个主机组,一个主机组包含多个主机,一个主机包含多个实例。详情请参见主机组简介。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ReplaceDedicatedHost |
系统规定参数。取值:ReplaceDedicatedHost。 |
DedicatedHostId | String | 是 | i-bpxxxxxxx |
主机ID。 |
FailoverMode | String | 是 | MaintainTime |
替换主机方案。取值:
|
RegionId | String | 否 | cn-hangzhou |
地域ID。可以通过接口DescribeRegions查看地域ID。 |
AccessKeyId | String | 否 | LTAIfCxxxxxxxxxx |
阿里云颁发给用户的访问服务所用的密钥ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DedicatedHostId | String | i-bpxxxxxxx |
替换后的主机ID。 |
RequestId | String | 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC |
请求ID。 |
TaskId | Integer | 1007893 |
替换主机任务ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=ReplaceDedicatedHost
&DedicatedHostId=i-bpxxxxxxx
&FailoverMode=MaintainTime
&<公共请求参数>
正常返回示例
XML
格式
<ReplaceDedicatedHostResponse>
<DedicatedHostId>3306</DedicatedHostId>
<RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
<TaskId>1007893</TaskId>
</ReplaceDedicatedHostResponse>
JSON
格式
{
"DedicatedHostId":"3306",
"RequestId":"1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC",
"TaskId":"1007893"
}
错误码
访问错误中心查看更多错误码。