網(wǎng)絡實例(VPC、VBR、IPsec連接)被連接至轉發(fā)路由器后,如果要實現(xiàn)不同地域網(wǎng)絡實例的互通,需要在網(wǎng)絡實例連接的轉發(fā)路由器下創(chuàng)建跨地域連接,您可以調用CreateTransitRouterPeerAttachment接口為企業(yè)版轉發(fā)路由器實例創(chuàng)建跨地域連接。
接口說明
-
企業(yè)版轉發(fā)路由器支持以下兩種帶寬分配方式:
-
從帶寬包分配:
使用此種分配方式,您需要先購買帶寬包,從帶寬包中為跨地域連接分配帶寬。購買帶寬包具體操作,請參見 CreateCenBandwidthPackage 。
-
按流量付費:
使用此種分配方式,您需要為跨地域連接設置限速帶寬,系統(tǒng)會按照跨地域連接實際使用的流量計費。具體計費信息,請參見跨地域流量。
-
-
CreateTransitRouterPeerAttachment 接口屬于異步接口,即系統(tǒng)會先返回一個跨地域連接 ID,但該跨地域連接并未創(chuàng)建完成,系統(tǒng)后臺的創(chuàng)建任務仍在進行。您可以調用 ListTransitRouterPeerAttachments 接口查詢跨地域連接的狀態(tài)。
- 當跨地域連接處于 Attaching 狀態(tài)時,表示跨地域連接正在創(chuàng)建中,在該狀態(tài)下,您只能對跨地域連接執(zhí)行查詢操作,不能執(zhí)行其他操作。
- 當跨地域連接處于 Attached 狀態(tài)時,表示跨地域連接創(chuàng)建完成。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產(chǎn)品自身定義的條件關鍵字。
- 關聯(lián)操作:是指成功執(zhí)行操作所需要的其他權限。操作者必須同時具備關聯(lián)操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯(lián)操作 |
---|---|---|---|---|
cen:CreateTransitRouterPeerAttachment | create | *CenInstance acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId} *TransitRouter acs:cen:*:{#accountId}:centransitrouter/{#TransitRouterId} |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ClientToken | string | 否 | 客戶端 Token,用于保證請求的冪等性。 從您的客戶端生成一個參數(shù)值,確保不同請求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定,則系統(tǒng)自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
| 02fb3da4-130e-11e9-8e44-001**** |
CenId | string | 否 | 云企業(yè)網(wǎng)實例 ID。 | cen-j3jzhw1zpau2km**** |
TransitRouterId | string | 否 | 本端企業(yè)版轉發(fā)路由器實例 ID。 | tr-bp1su1ytdxtataupl**** |
RegionId | string | 否 | 本端企業(yè)版轉發(fā)路由器實例所屬地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
TransitRouterAttachmentName | string | 否 | 跨地域連接的名稱。 名稱可以為空或長度為 1~128 個字符,不能以 http://或 https://開頭。 | testname |
TransitRouterAttachmentDescription | string | 否 | 跨地域連接的描述信息。 描述可以為空或長度為 1~256 個字符,不能以 http://或 https://開頭。 | testdesc |
PeerTransitRouterId | string | 是 | 對端轉發(fā)路由器實例 ID。 | tr-m5eq27g6bndum7e88**** |
PeerTransitRouterRegionId | string | 否 | 對端轉發(fā)路由器實例所屬地域 ID。 | cn-qingdao |
AutoPublishRouteEnabled | boolean | 否 | 是否使企業(yè)版轉發(fā)路由器自動發(fā)布跨地域連接的路由到對端地域。
| false |
Bandwidth | integer | 否 | 跨地域連接的帶寬值。單位:Mbps。
| 2 |
CenBandwidthPackageId | string | 否 | 跨地域連接要綁定的帶寬包 ID。 說明
當 BandwidthType 取值為 DataTransfer 時,無需配置該項。
| cenbwp-3xrxupouolw5ou**** |
DryRun | boolean | 否 | 是否對此次請求執(zhí)行預檢,包括權限、實例狀態(tài)校驗等。取值:
| false |
BandwidthType | string | 否 | 跨地域連接的帶寬分配方式。取值:
| BandwidthPackage |
Tag | array<object> | 否 | 標簽信息。 一次最多支持輸入 20 個標簽信息。 | |
object | 否 | |||
Key | string | 否 | 資源的標簽鍵。 一旦傳入該值,則不允許為空字符串。最多支持 64 個字符,不能以 一次最多支持輸入 20 個標簽的標簽鍵。 | tag_A1 |
Value | string | 否 | 資源的標簽值。 標簽值可以為空或輸入不超過 128 個字符的字符串,不能以 每一個標簽鍵對應一個標簽值,一次最多支持輸入 20 個標簽鍵對應的標簽值。 | value_A1 |
DefaultLinkType | string | 否 | 默認鏈路類型。 可選值為 Platinum(鉑金),Gold(金),默認為 Gold(金)。 且僅在帶寬分配方式是按流量計費時,才可以配置為 Platinum(鉑金)。 | Gold |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"TransitRouterAttachmentId": "tr-attach-nwkiqfvw22qesz****",
"RequestId": "59422BF5-BAAD-4CFD-9019-9557BD3ACFA3"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | OperationUnsupported.TransitRouterRegionId | The specified TransitRouterRegion does not support the operation. | 中轉地域不支持此操作。 |
400 | NoPermission.AliyunServiceRolePolicyForCEN | You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. | 您沒有權限創(chuàng)建服務關聯(lián)角色,角色名:AliyunServiceRolePolicyForCEN,服務名:cen.aliyuncs.com。請確保已授予當前用戶ram:CreateServiceLinkedRole權限。 |
400 | InvalidTransitRouterId.NotFound | TransitRouterId is not found. | 轉發(fā)路由實例ID不存在。 |
400 | IllegalParam.PeerTransitRouterId | PeerTransitRouterId is illegal. | 跨地域連接時,對端的轉發(fā)路由器ID非法。 |
400 | OperationUnsupported.TransitRouterId | TransitRouterId is unsupported. | 轉發(fā)路由器類型是基礎版時不支持。 |
400 | MissingParam.Bandwidth | The parameter Bandwidth is mandatory. | 帶寬值參數(shù)是必需的。 |
400 | IllegalParam.Bandwidth | Bandwidth is illegal. | 帶寬包ID不合法。 |
400 | Forbbiden.TransitRouterServiceNotOpen | The user has not open transit router service. | 轉發(fā)路由器服務未打開,請打開后重試。 |
400 | OperationUnsupported.TransitRouterType | The specified TransitRouterType does not support the operation. | 當前TransitRouter類型不支持該操作。 |
400 | OperationUnsupported.BandwidthType | The specified BandwidthType does not support the operation. | 當前BandwidthType不支持該操作。 |
400 | InvalidCenId.NotFound | CenId is not found. | CEN實例不存在。 |
400 | IllegalParam.BandwidthType | BandwidthType is illegal. | 帶寬包類型不合法。 |
400 | MissingParam.CenIdOrRegionId | Either CenId or RegionId must be specified. | CenId或者RegionId是必選參數(shù)。 |
400 | OperationUnsupported.BandwidthHS | This bandwidth limit can only be set in China-AsiaPacific-HS | - |
400 | OperationUnsupported.CenFullLevel | CEN full level does not support TransitRouter | Full類型CEN不支持創(chuàng)建企業(yè)版轉發(fā)路由器。 |
400 | OperationUnsupported.CloudDataTransferService | CCN region not support cloud data transfer service. | CCN地域中不支持cloud data transfer服務。 |
400 | InvalidPeerTransitRouterId.NotFound | The specified PeerTransitRouterId is not found. | 參數(shù)中指定的PeerTransitRouterId不存在。 |
400 | IllegalParam.RegionId | RegionId is illegal. | 參數(shù)中指定的Region不合法。 |
400 | IllegalParam.PeerRegionId | PeerRegionId is illegal. | 參數(shù)中指定的PeerRegionId不合法。 |
400 | IllegalParam.TransitRouterRegionId | TransitRouterRegionId is illegal. | TransitRouterRegionId不合法。 |
400 | InvalidOperation.CenInstanceStatus | The CEN instance is not in a valid state for the operation. | - |
400 | IncorrectStatus.TransitRouter | The status of TransitRouter is incorrect. | 當前TransitRouter的狀態(tài)不支持該操作,請稍后重試。 |
400 | InvalidOperation.BwpNotAssociated | Operation is invalid because a bandwidth package corresponding to the geographic span is not associated. | 與地域對應的帶寬包未關聯(lián),無法操作。 |
400 | InvalidOperation.BwpBusinessStatus | The CBN bandwidth package is not in a valid business state for the operation. | 帶寬包不處于穩(wěn)態(tài),無法操作。 |
400 | IllegalParam.CenBandwidthPackageId | Parameter CenBandwidthPackageId is illegal. | 參數(shù)中指定的CenBandwidthPackageId不合法。 |
400 | InvalidOperation.BwpBandwidthExceeded | Operation is invalid because the total bandwidth limit has exceeded that of the bandwidth package. | 設置帶寬值已超出帶寬包帶寬 |
400 | ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold | DataTransfer only support Platinum and Gold. | 帶寬分配方式為按流量計費時,默認鏈路類型僅支持鉑金(Platinum)和金(Gold)。 |
400 | ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold | Cen bandwidthPackage only support Gold. | 帶寬分配方式為帶寬包時,默認鏈路類型僅支持金(Gold) |
400 | ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold | CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version. | 當跨地域連接的兩端轉發(fā)路由器不全是企業(yè)版且?guī)挿峙浞绞綖榘戳髁坑嬞M時,默認鏈路類型僅支持金(Gold)。 |
400 | OperationNotAllowed.DefaultLinkTypeOnlySupportGold | Operation is not allowed because this user can only set default link type to Gold. | 本用戶只能設置默認鏈路類型為金。 |
400 | OperationInvalid.UserCanNotBuyCrossBorderBwp | According to the laws and regulations of the operator and mainland China, you are currently not eligible to purchase or renew a cross-border bandwidth package. Please contact online customer service or your business manager for consultation. | 根據(jù)運營商及中國大陸法律法規(guī)的要求,您當前暫不符合購買/續(xù)費跨境帶寬包條件,請聯(lián)系在線客服或您的商務經(jīng)理咨詢處理。 |
400 | OperationInvalid.IdentityRegistrationStatusNotSupport | Real name registration of enterprises required. | 因您在“地域”或“對端地域”選擇了“中國內(nèi)地”的地域,您需要是企業(yè)用戶且已完成企業(yè)實名登記,才能繼續(xù)購買。關于如何做企業(yè)實名登記,請查看<a href=" https://www.alibabacloud.com/help/doc-detail/52595.htm">實名認證文檔 |
400 | InvalidOperation.OnlyOneRegionSupportIpv6 | Peer Attachment is only allowed when both regions support IPv6 or do not support IPv6 at all. | 只有當兩端地域均支持或均不支持IPv6時才可以創(chuàng)建跨地域連接。 |
400 | InvalidOperation | Operation is invalid. | 非法操作。 |
400 | Forbidden.ResourceOwnerTransitRouterServiceExpired | The transit router service of the account to which the resource belongs has been suspended due to arrears. Please notify the other party to renew the service and try again. | 資源所屬賬號的轉發(fā)路由器服務已欠費停服,請通知對方續(xù)費后重試。 |
400 | Forbidden.TransitRouterServiceExpired | The transit router service is out of service. | 轉發(fā)路由器服務已欠費停服,請續(xù)費后重試。 |
400 | OperationUnsupported.RegionId | The specified RegionId does not support the operation. | 當前地域不支持該操作。 |
400 | InvalidParameter | Invalid parameter. | 參數(shù)不合法。 |
400 | Unauthorized | The AccessKeyId is unauthorized. | 賬號無權限操作。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-10-28 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2024-06-11 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2024-05-17 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2023-12-20 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2023-12-13 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2023-12-06 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-11-03 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2023-10-18 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-10-18 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-01-04 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2022-12-22 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |