调用StartDBInstance接口启动RDS MySQL实例或专属集群中的实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | StartDBInstance |
系统规定参数。取值:StartDBInstance。 |
RegionId | String | 否 | cn-hangzhou |
地域ID。可调用DescribeRegions查询。 |
DedicatedHostGroupId | String | 否 | dhg-39xxxxxx |
专属集群ID。可调用DescribeDedicatedHostGroups查询。 说明 仅支持专属集群实例。
|
DBInstanceId | String | 是 | rm-bpxxxxx |
实例ID。可调用DescribeDBInstances查询。 |
TargetDedicatedHostIdForMaster | String | 否 | dh-bpxxxxx |
主节点的目标主机ID。 说明
|
TargetDedicatedHostIdForSlave | String | 否 | dh-bpxxxxx |
备节点的目标主机ID。 说明
|
TargetDedicatedHostIdForLog | String | 否 | dh-bpxxxxx |
日志节点的目标主机ID。 说明
|
EffectiveTime | String | 否 | Immediate |
生效时间,取值:
默认值:MaintainTime。 说明 仅支持专属集群实例。
|
SpecifiedTime | String | 否 | 2019-10-21T10:00:00Z |
指定切换的时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 说明
|
TargetDBInstanceClass | String | 否 | rds.ebmhfc6.20xlarge |
目标实例的规格。 说明 仅支持专属集群实例。
|
EngineVersion | String | 否 | 5.7 |
数据库版本。 说明 仅支持专属集群实例。
|
DBInstanceTransType | Integer | 否 | 0 |
实例的迁移方式。取值:
说明 仅支持专属集群实例。
|
Storage | Integer | 否 | 1000 |
自定义存储空间,取值:5~2000。单位:GB。不传该参数表示存储空间保持不变。 说明 仅支持专属集群实例。
|
VSwitchId | String | 否 | vsw-xxxxxx |
交换机ID。 说明 仅支持专属集群实例。
|
ZoneId | String | 否 | cn-hangzhou-a |
可用区ID。 说明 仅支持专属集群实例。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | A417FB41-A3D9-464E-AD0A-C7FE05C72E98 |
请求ID。 |
TaskId | Integer | 238028563 |
任务ID。 |
MigrationId | Integer | 740 |
迁移任务ID。 说明 仅专属集群实例返回。
|
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=StartDBInstance
&DBInstanceId=rm-bpxxxxx
&DedicatedHostGroupId=dhg-39xxxxxx
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<StartDBInstanceResponse>
<MigrationId>740</MigrationId>
<RequestId>A417FB41-A3D9-464E-AD0A-C7FE05C72E98</RequestId>
<TaskId>238028563</TaskId>
</StartDBInstanceResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"MigrationId" : 740,
"RequestId" : "A417FB41-A3D9-464E-AD0A-C7FE05C72E98",
"TaskId" : 238028563
}
错误码
访问错误中心查看更多错误码。