调用DeleteDBInstanceEndpoint接口删除实例的Endpoint。

背景信息

  • 仅支持MySQL集群版。
  • 删除实例中指定的Endpoint，同时会删除该Endpoint中包含的所有连接地址。

调试

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

请求参数

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

系统规定参数。

取值：DeleteDBInstanceEndpoint。

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

该参数用于保证请求的幂等性，防止重复提交请求。参数值由客户端生成，保证在不同请求间唯一。

该参数值由ASCII字符组成，最长不超过64个字符，不能包含非ASCII字符。
DBInstanceId String 是 rm-****

实例ID。可调用DescribeDBInstances查询。

DBInstanceEndpointId String 是 ep-****

实例的Endpoint ID。可调用DescribeDBInstanceEndpoints查询。

返回数据

名称 类型 示例值 描述
Data Object

返回数据列表。
DBInstanceName String rm-****

实例ID。
DBInstanceEndpointId String ep-****

实例的Endpoint ID。
RequestId String 224DB9F7-3100-4899-AB9C-C938BCCB43E7

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DeleteDBInstanceEndpoint
&ClientToken=0c593ea1-3bea-11e9-b96b-88****
&DBInstanceId=rm-****
&DBInstanceEndpointId=ep-****
&公共请求参数

正常返回示例

XML格式 

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

<DeleteDBInstanceEndpointResponse>
    <Data>
        <DBInstanceName>rm-****</DBInstanceName>
        <DBInstanceEndpointId>ep-****</DBInstanceEndpointId>
    </Data>
    <RequestId>224DB9F7-3100-4899-AB9C-C938BCCB43E7</RequestId>
</DeleteDBInstanceEndpointResponse>

JSON格式 

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

{
  "Data" : {
    "DBInstanceName" : "rm-****",
    "DBInstanceEndpointId" : "ep-****"
  },
  "RequestId" : "224DB9F7-3100-4899-AB9C-C938BCCB43E7"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidSourceCategory specified source category is invalid. 指定的源类别无效。
400 InvalidDBInstanceConnType.Format Specified DB instance conn type is not valid. 操作失败，当前数据库实例的连接类型不支持此操作。
400 EndpointType.NotSupport Current db type is not support specified endpoint type. 不支持传入的Endpoint的类型。
400 APICallingFailed Meta db calling failed. API调用异常。
403 IncorrectDBInstanceState Current DB instance state does not support this operation. 操作失败，该实例状态下不支持此操作。
404 InvalidDBInstanceName.NotFound Invalid DBInstanceId NotFound. 数据库实例ID不存在，请检查。
404 IncorrectDBInstanceLockMode Current DB instance lock mode does not support this operation. 操作失败，实例处于锁定状态。
404 Endpoint.NotFound Specified endpoint is not existed. 目标的endpoint不存在。
404 InvalidDBInstance.NotFound Specified instance does not exist or not support. 指定的实例不存在指定的实例被删除或者实例不支持当前操作。

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