调用DeleteRouteEntries接口批量删除自定义路由条目。

使用说明

调用本接口删除路由条目时，请注意：

  • 只有处于Available状态的路由条目可以被删除。
  • 路由表所在的VPC正在进行创建或删除交换机或路由条目时，无法删除路由条目。
  • DeleteRouteEntries接口属于异步接口，即系统会返回一个请求ID，但该路由条目尚未删除成功，系统后台的删除任务仍在进行。您可以调用DescribeRouteEntryList查询路由条目的删除状态：
    • 当路由条目处于Deleting状态时，表示路由条目正在删除中。
    • 当查询不到指定的路由条目时，表示路由条目删除成功。
  • DeleteRouteEntries接口不支持在同一个VPC中并发批量删除路由表中的路由条目。

调试

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

请求参数

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

系统规定参数。取值：DeleteRouteEntries。
RegionId String 是 cn-hangzhou

路由表所属地域的ID。

您可以通过调用DescribeRegions接口获取地域ID。
RouteEntries.N.RouteTableId String 是 vtb-2ze3jgygk9bmsj23s****

要删除的路由条目所在的路由表的ID。最多支持输入50个路由表ID。
RouteEntries.N.RouteEntryId String 否 rte-bp1mnnr2al0naomnpv****

要删除的路由条目ID。最多支持输入50个路由条目ID。

说明 当RouteEntryId参数未输入时，DstCidrBlock和NextHop参数必填。
RouteEntries.N.DstCidrBlock String 否 47.100.XX.XX/24

要删除的路由条目的目标网段，支持IPv4和IPv6网段。最多支持输入50个目标网段。

说明 当RouteEntryId参数未输入时，DstCidrBlock和NextHop参数必填。
RouteEntries.N.NextHop String 否 i-j6c2fp57q8rr4jlu****

要删除的下一跳实例的ID。最多支持输入50个实例ID。

说明 当RouteEntryId参数未输入时，DstCidrBlock和NextHop参数必填。

返回数据

名称 类型 示例值 描述
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。
SuccessCount Integer 2

删除成功的路由条目数。
FailedCount Integer 2

删除失败的路由条目数。
FailedRouteEntries Array of FailedRouteEntries

删除失败的路由条目信息。
RouteEntryId String rte-bp1mnnr2al0naomnpv****

删除失败的路由条目ID。
DstCidrBlock String 47.100.XX.XX/24

删除失败的路由条目的目标网段，支持IPv4和IPv6网段。
NextHop String i-j6c2fp57q8rr4jlu****

删除失败的下一跳实例ID。
FailedCode String VPC_ROUTER_ENTRY_NOT_EXIST

失败的错误码。
FailedMessage String vRouterEntry not exists

失败的具体报错信息。

示例

请求示例

http(s)://[Endpoint]/?Action=DeleteRouteEntries
&RegionId=cn-hangzhou
&RouteEntries=[{"RouteTableId":"vtb-2ze3jgygk9bmsj23s****","RouteEntryId":"rte-bp1mnnr2al0naomnpv****","DstCidrBlock":"47.100.XX.XX/24","NextHop":"i-j6c2fp57q8rr4jlu****"}]
&公共请求参数

正常返回示例

XML格式

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

<DeleteRouteEntriesResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
    <SuccessCount>2</SuccessCount>
    <FailedCount>2</FailedCount>
    <FailedRouteEntries>
        <RouteEntryId>rte-bp1mnnr2al0naomnpv****</RouteEntryId>
        <DstCidrBlock>47.100.XX.XX/24</DstCidrBlock>
        <NextHop>i-j6c2fp57q8rr4jlu****</NextHop>
        <FailedCode>VPC_ROUTER_ENTRY_NOT_EXIST</FailedCode>
        <FailedMessage>vRouterEntry not exists</FailedMessage>
    </FailedRouteEntries>
</DeleteRouteEntriesResponse>

JSON格式

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

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "SuccessCount" : 2,
  "FailedCount" : 2,
  "FailedRouteEntries" : [ {
    "RouteEntryId" : "rte-bp1mnnr2al0naomnpv****",
    "DstCidrBlock" : "47.100.XX.XX/24",
    "NextHop" : "i-j6c2fp57q8rr4jlu****",
    "FailedCode" : "VPC_ROUTER_ENTRY_NOT_EXIST",
    "FailedMessage" : "vRouterEntry not exists"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 DryRunOperation Request validation has been passed with DryRun flag set. DryRun校验通过。

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