全部产品
Search
文档中心

专有网络 VPC:ModifyRouteEntry - 修改自定义路由条目的名称和描述

更新时间:Mar 04, 2024

调用ModifyRouteEntry修改自定义路由条目的名称和描述。

接口说明

ModifyRouteEntry 接口不支持并发修改同一个自定义路由条目的名称和描述。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vpc:ModifyRouteEntryWrite
  • RouteTable
    acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}

请求参数

名称类型必填描述示例值
RegionIdstring

路由条目所在的地域 ID。

您可以通过调用 DescribeRegions 接口获取地域 ID。

cn-hangzhou
RouteEntryNamestring

路由条目的名称。

名称长度为 1~128 个字符,不能以http://https://开头。

EntryName
RouteEntryIdstring

自定义路由条目 ID。

rte-acfvgfsghfdd****
Descriptionstring

路由条目的描述。

描述长度为 1~256 个字符,不能以http://https://开头。

EntryDescription
NewNextHopTypestring

新路由条目下一跳类型。取值如下:

  • NetworkInterface:弹性网卡。
  • NatGateway:NAT 网关。
NetworkInterface
NewNextHopIdstring

新路由条目下一跳实例 ID。

eni-bp17y37ytsenqyim****

返回参数

名称类型描述示例值
object

返回信息。

RequestIdstring

请求 ID。

861E6630-AEC0-4B2D-B214-6CB5E44B7F04

示例

正常返回示例

JSON格式

{
  "RequestId": "861E6630-AEC0-4B2D-B214-6CB5E44B7F04"
}

错误码

HTTP status code错误码错误信息描述
400InvalidRouteEntryId.NotFoundSpecified RouteEntryId does not exist.指定的路由条目未找到
400InvalidRouteEntryName.MalformedSpecified RouteEntry name is not valid.无法修改,因为指定的路由条目名称无效
400MissingParam.RouteEntryId%s-
400IllegalParam.RouteEntryName%s-
400InvalidRouteEntryId.NotFound%s-
400InvalidRouteEntryId.NotFoundThe specified routeEntry does not exist.指定的路由条目不存在。
400OperationDenied.ModifyManagedRouteEntryThe operation is not allowed because of route entry is managed.无法修改被托管的路由。
400OperationDenied.RouteTableTypeNotPermittedThe operation is not allowed because the type of route table is not permitted.指定路由表类型不允许创建路由条目
400MissingParam.NewNextHopIdThe parameter NewNextHopId is mandatory.修改路由条目下一跳缺失待修改路由条目下一跳实例ID信息。
400IllegealParam.NextHopTypeThe parameter NewNextHopType is illegal.路由条目下一跳类型非法。
400UnsupportedFeature.NormalTypeNatGatewayNormal nat gateways do not support modifying the next hop of the route.指向普通类型NAT网关的路由条目不支持修改下一跳。
400UnsupportedFeature.NextHopTypeThe route type does not support modifying the next hop of the route.当前路由条目不支持修改下一跳信息。
400InvalidRouteTable.NotFoundThe specified routetable does not exist.路由表实例不存在。
400InvalidNetworkInterface.NotFoundThe specified network interface does not exist.指定的网卡类型下一跳实例ID不存在。
400OperationDenied.NextHopExistThe operation is not allowed because the nexthop already exists.需要修改的目标路由条目下一跳已存在。
400MissingParam.NewNextHopTypeThe parameter NewNextHopType is mandatory.修改路由条目下一跳缺失待修改路由条目下一跳实例类型信息。
400UnsupportedFeature.ModifyRouteEntryNextHopThe current region does not support the function of modifying the route next hop.当前地域不支持修改路由下一跳功能。
403ForbbidenUser not authorized to operate on the specified resource.用户没有权限操作指定的资源。
404ResourceNotFound.NatGatewayThe specific NAT gateway is not found.指定的 NAT 网关不存在。

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

变更历史

变更时间变更内容概要操作
2023-12-25OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:403
    新增错误码:404
2023-09-15OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:403
2023-09-15OpenAPI 描述信息更新、OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:403
入参OpenAPI 入参发生变更
    新增入参:NewNextHopType
    新增入参:NewNextHopId
2023-05-08OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:403