调用DescribeEndpointSwitchStatus接口查询修改数据库连接信息任务的状态。

在调用本接口前,您需要调用SwitchSynchronizationEndpoint接口修改数据库连接信息。

调试

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

请求参数

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

系统规定参数,取值:DescribeEndpointSwitchStatus

TaskId String 11****

任务ID,成功调用SwitchSynchronizationEndpoint接口后会返回该值。

RegionId String cn-hangzhou

地域ID,传入本参数来指定实例所在地域,详情请参见支持的地域列表

ClientToken String 0c593ea1-3bea-11e9-b96b-88e9fe63****

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。

AccountId String 12323344****

阿里云主账号ID,无需设置,该参数即将下线。

返回数据

名称 类型 示例值 描述
ErrCode String InternalError

调用出错时返回的错误码。

ErrMessage String The request processing has failed due to some unknown error.

调用错误时返回的错误信息。

ErrorMessage String 400

本参数已下线。

RequestId String 0DD6B201-604B-4CAB-B6A8-4B2953B5****

请求ID。

Status String Finished

任务执行状态,返回为:

  • NotStarted:未启动。
  • Initializing:初始化中。
  • Switching:切换中。
  • Failed:执行失败。
  • Finished:执行成功。
Success String true

请求是否成功。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=DescribeEndpointSwitchStatus
&TaskId=11****
&<公共请求参数>

正常返回示例

XML格式

<SwitchSynchronizationEndpointResponse>
      <RequestId>0DD6B201-604B-4CAB-B6A8-4B2953B5****</RequestId>
      <Status>Finished</Status>
      <Success>true</Success>
</SwitchSynchronizationEndpointResponse>

JSON格式

{
    "SwitchSynchronizationEndpointResponse": {
        "RequestId": "0DD6B201-604B-4CAB-B6A8-4B2953B5****",
        "Status": "Finished",
        "Success": true
    }
}

错误码

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