调用ModifyRouterInterfaceAttribute接口修改路由器接口的配置。

调试

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

请求参数

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

要执行的操作。

取值：ModifyRouterInterfaceAttribute。

RegionId String 是 cn-shanghai

路由器接口所在的地域ID。

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

RouterInterfaceId String 是 ri-2zeo3xzyf38r4urz****

路由器接口ID。

Name String 否 TEST

路由器接口的名称。

长度为2～128个字符，必须以字母或中文开头，可包含数字、下划线（_）和短划线（-）。但不能以http:// 或https://开头。

Description String 否 路由器接口

路由器接口的描述信息。

长度为2～256个字符，必须以字母或中文开头，但不能以http:// 或https://开头。

OppositeInterfaceId String 否 ri-2zeo3xzyf38r4urz****

对端路由器接口ID。

OppositeRouterId String 否 vrt-bp1jcg5cmxjbl9xgc****

对端路由器ID。

OppositeRouterType String 否 VBR

要连接的对端路由器接口所属的路由器类型。

  • VRouter
  • VBR（默认值）
OppositeInterfaceOwnerId Long 否 16880000000000000

对端路由器接口所有者的账号ID。

HealthCheckSourceIp String 否 116.62.XX.XX

健康检查源IP地址，必须是本端VPC内的一个未被使用的IP。

说明 物理专线接入场景下可指定该参数。
HealthCheckTargetIp String 否 116.62.XX.XX

健康检查目的IP地址。

说明 指定 HealthCheckSourceIp后，该参数为必选。
HcThreshold Integer 否 12

健康检查阈值。
HcRate Integer 否 2

健康检查速率。
DeleteHealthCheckIp Boolean 否 false

是否删除该路由器接口上配置的健康检查IP。

  • true：删除健康检查IP。
  • false（默认值）：不删除健康检查IP。

返回数据

名称 类型 示例值 描述
RequestId String 4EC47282-1B74-4534-BD0E-403F3EE64CAF

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyRouterInterfaceAttribute
&RegionId=cn-shanghai
&RouterInterfaceId=ri-2zeo3xzyf38r4urz****
&<公共请求参数>

正常返回示例

XML格式 

<ModifyRouterInterfaceAttributeResponse>
      <RequestId>4EC47282-1B74-4534-BD0E-403F3EE64CAF</RequestId>
</ModifyRouterInterfaceAttributeResponse>

JSON格式 

{
    "ModifyRouterInterfaceAttributeResponse": {
        "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
    }
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. 指定的RegionId不存在。
404 InvalidRouterInterfaceId.NotFound The specified RouterInterfaceId does not exist in our records. 指定的路由器接口不存在，请您检查填写的路由器接口是否正确。
400 InvalidName.Malformd The attribute name is illeagl. 该名称格式不合法。
400 InvalidOppositeRouterType.ValueNotSupported The specified OppositeRouterType is not valid. 参数OppositeRouterType的值不合法。
400 InvalidDescription.Malformed The Description is illeagl. 指定的资源描述格式不合法。长度为2～256个字符，不能以http://和https://开头。
400 Forbbiden The Router instance owener error 该路由器不属于您的账号。
400 LinkRole.NotSupport This linkrole is not supported 这个链接不支持。
400 InvalidParam.ModifyRouterInterface Modify routerinterface param invalide 编辑路由器接口参数不合法。

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