全部產品
Search
文件中心

Express Connect:ModifyRouterInterfaceAttribute - 修改路由器介面的配置

更新時間:Apr 27, 2026

調用ModifyRouterInterfaceAttribute介面修改路由器介面的配置。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

路由器介面所在的地區 ID。

您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-shanghai

RouterInterfaceId

string

路由器介面 ID。

ri-2zeo3xzyf38r4urz****

Name

string

路由器介面的名稱。

長度為 2~128 個字元,必須以字母或中文開頭,可包含數字、底線(_)和短劃線(-)。

TEST

Description

string

路由器介面的描述資訊。

長度為 2~256 個字元,必須以字母或中文開頭,但不能以http:// https://開頭。

路由器介面

OppositeInterfaceId

string

對端路由器介面 ID。

ri-2zeo3xzyf38r4urz****

OppositeRouterId

string

對端路由器 ID。

vrt-bp1jcg5cmxjbl9xgc****

OppositeRouterType

string

要串連的對端路由器介面所屬的路由器類型。取值:

  • VRouter:路由器。

  • VBR(預設值):邊界路由器。

VBR

OppositeInterfaceOwnerId

integer

對端路由器介面的帳號 ID。

28768383240243****

HealthCheckSourceIp

string

健全狀態檢查源 IP 位址,必須是本端 VPC 內的一個未被使用的 IP 位址。

說明

物理專線接入情境下可指定該參數。

116.62.XX.XX

HealthCheckTargetIp

string

健全狀態檢查目的 IP 位址。

說明

指定 HealthCheckSourceIp 後,該參數為必選。

116.62.XX.XX

HcThreshold

integer

健全狀態檢查閾值。單位:個。推薦值為 8。表示指定健全狀態檢查時發送探測報文的個數。

8

HcRate

integer

健全狀態檢查速率。單位:毫秒。推薦值為 2000。表示指定健全狀態檢查時發送連續探測報文的時間間隔。

本樣本 HcThreshold 設定為 8HcRate 設定為 2000,即在健全狀態檢查時每 2000 毫秒從 HealthCheckSourceIp(健全狀態檢查源 IP 位址)向 HealthCheckTargetIp(健全狀態檢查目的 IP 位址)發送一次探測報文,如果連續 8 次探測報文都無響應,則健全狀態檢查失敗。

2000

DeleteHealthCheckIp

boolean

是否刪除該路由器介面上配置的健全狀態檢查 IP。取值:

  • true:刪除健全狀態檢查 IP。

  • false(預設值):不刪除健全狀態檢查 IP。

false

返回參數

名稱

類型

描述

樣本值

object

請求 ID。

RequestId

string

請求 ID。

4EC47282-1B74-4534-BD0E-403F3EE64CAF

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 Forbidden.FinancialLocked This RouterInterface is financiel locked because of bills outstanding.
400 InvalidName.Malformed The attribute name is illegal. 該名稱格式不合法。
400 InvalidOppositeRouterType.ValueNotSupported The specified OppositeRouterType is not valid. 參數OppositeRouterType的值不合法。
400 InvalidDescription.Malformed The Description is illegal. 指定的資源描述格式不合法。長度為2-256個字元,不能以http://和https://開頭。
400 Forbbiden The Router instance owner error
400 LinkRole.NotSupport This linkrole is not supported
400 Forbbiden.ModifyIdAndType Opposite is VBR, cannot modify the ID and type
400 InvalidParam.ModifyRouterInterface Modify routerinterface param invalid 編輯路由器介面參數不合法。
400 INSTANCE_IN_PROCESSIONG Instance is in processing,please wait and try again
400 IllegalParam.HcThreshold %s
400 IllegalParam.HcRate %s
400 InvalidHealthCheckIP.Malformd Healthcheck sourceip or targetip is not valid.
400 IllegalParam.HcSourceIp The specified healthCheck Ip is not valid. 健全狀態檢查IP不合法。
400 OperationFailed.OperationLocked Operation failed because OperationLocked. 操作失敗因為執行個體已經被營運鎖定。
400 IncorrectStatus.RouterInterface This openeration would not be allowed because status of this RouterInterface is not correct. 當前執行個體的狀態無法進行刪除,請等待狀態變更後再次進行操作。
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
404 InvalidRouterInterfaceId.NotFound The specified RouterInterfaceId does not exist in our records.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情