全部產品
Search
文件中心

Cloud Enterprise Network:CreateCenChildInstanceRouteEntryToAttachment - 為企業版轉寄路由器串連的網路執行個體添加路由條目

更新時間:Jul 30, 2025

在企業版轉寄路由器中,您可以調用CreateCenChildInstanceRouteEntryToAttachment介面為網路執行個體添加路由條目,目標網段的下一跳指向當前地區的轉寄路由器。

介面說明

  • 僅支援為企業版轉寄路由器串連的Virtual Private Cloud(Virtual Private Cloud)執行個體和邊界路由器 VBR(Virtual Border Router)執行個體添加路由條目。

  • 路由條目的下一跳預設為轉寄路由器串連(即網路執行個體串連)且不支援修改。

  • CreateCenChildInstanceRouteEntryToAttachment 介面屬於非同步介面,即系統會先返回一個 RequestId,但該路由條目並未建立完成,系統背景建立任務仍在進行。您可以調用專用網路的 DescribeRouteEntryList 介面查詢路由條目的狀態。
    • 當路由條目處於 Pending 狀態時,表示路由條目正在建立中。在該狀態下,您只能對路由條目執行查詢操作,不能執行其他動作。

    • 當路由條目處於 Available 狀態時,表示路由條目建立完成。

調試

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

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cen:CreateCenChildInstanceRouteEntryToAttachment

create

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

請求參數

名稱

類型

必填

描述

樣本值

ClientToken

string

用戶端 Token,用於保證請求的等冪性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。

02fb3da4-130e-11e9-8e44-001****

DryRun

boolean

是否對此次請求執行預檢,包括許可權、執行個體狀態校正等。取值:

  • false(預設值):發送正常請求,通過檢查後直接為網路執行個體添加路由條目。

  • true:發送檢查請求,只進行校正,不會為網路執行個體添加路由條目。檢查項包括是否填寫了必需參數、請求格式等。如果檢查不通過,則返回對應錯誤。如果檢查通過,則返回錯誤碼DryRunOperation

說明

當前參數暫不生效。

false

CenId

string

雲企業網執行個體 ID。

cen-bp1n6cbxcszp55vxo****

TransitRouterAttachmentId

string

網路執行個體串連 ID。

tr-attach-r1qhupkc19iadz****

RouteTableId

string

網路執行個體的路由表 ID。

vrt-bp1msipdczo9lejup****

DestinationCidrBlock

string

路由條目的目標網段。

10.0.0.0/24

返回參數

名稱

類型

描述

樣本值

object

返回結果。

RequestId

string

請求 ID。

A95A100B-3F3A-56F4-A5DE-19DB7E994807

樣本

正常返回樣本

JSON格式

{
  "RequestId": "A95A100B-3F3A-56F4-A5DE-19DB7E994807"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 Forbidden.VpcAsInternetGateway It’s forbidden that using Vpc as internet gateway for your private IDC.
400 InvalidCIDRBlock.Duplicate Specified CIDR block is already exists. 指定的Cidr已經存在。
400 InvalidCidrBlock.Malformed Specified CIDR block is not valid. 參數中指定的cidrBlock不合法。
400 OperationFailed.RouteConflict Route conflict exists in routing table. 路由表中存在路由衝突。
400 InvalidOperation.UnsupportnexthopType The specified next hop type is not supported by this operation. 操作不支援該nexthopType。
400 IncorrectStatus.VpcRouteEntry The resource is not in a valid state for the attachment operation. 當前VpcRouteEntry的狀態不支援該操作,請稍後重試。
400 OperationDenied.RouteTableTypeNotPermitted The operation is not allowed because of RouteTableTypeNotPermitted. 路由表類型不支援該操作。
400 InvalidParameter Invalid parameter. 參數不合法。
400 Unauthorized The AccessKeyId is unauthorized. 帳號無許可權操作。
400 SystemBusy The system is busy. Please try again later. 當前系統繁忙,請稍後重試。
400 OperationUnsupported.DestinationCidrBlockOverlapWithVSwitch The destination network segment specified in the route entry overlaps with the vSwitch network segment.
404 InvalidAttachmentId.NotFound The specified AttachmentId is not found. AttachmentId不存在。

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

變更歷史

更多資訊,參考變更詳情