為企業(yè)版轉(zhuǎn)發(fā)路由器路由表綁定前綴列表。
接口說明
為企業(yè)版轉(zhuǎn)發(fā)路由器路由表綁定前綴列表前，請(qǐng)確保滿足以下條件：
- 您已了解前綴列表的使用限制、路由兼容性說明等信息，請(qǐng)參見前綴列表。
- 您已經(jīng)創(chuàng)建了前綴列表。具體操作，請(qǐng)參見 CreateVpcPrefixList 。
- 如果企業(yè)版轉(zhuǎn)發(fā)路由器路由表需要綁定跨賬號(hào)的前綴列表，請(qǐng)確保待綁定的前綴列表已被共享給企業(yè)版轉(zhuǎn)發(fā)路由器路由表所屬的阿里云賬號(hào)（主賬號(hào)）。關(guān)于如何共享前綴列表資源，請(qǐng)參見資源共享概述和API 參考（資源共享）。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| cen:CreateTransitRouterPrefixListAssociation | create |
|
| 無 |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ClientToken | string | 否 | 客戶端 Token，用于保證請(qǐng)求的冪等性。 從您的客戶端生成一個(gè)參數(shù)值，確保不同請(qǐng)求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統(tǒng)自動(dòng)使用 API 請(qǐng)求的 RequestId 作為 ClientToken 標(biāo)識(shí)。每次 API 請(qǐng)求的 RequestId 不一樣。
| 123e4567-e89b-12d3-a456-4266**** |
| RegionId | string | 是 | 轉(zhuǎn)發(fā)路由器實(shí)例所屬的地域 ID。 您可以通過調(diào)用 DescribeChildInstanceRegions 接口獲取地域 ID。 | cn-hangzhou |
| TransitRouterId | string | 是 | 轉(zhuǎn)發(fā)路由器實(shí)例 ID。 | tr-6ehx7q2jze8ch5ji0**** |
| NextHopType | string | 否 | 下一跳類型。取值：
| VPC |
| PrefixListId | string | 是 | 前綴列表 ID。 | pl-6ehtn5kqxgeyy08fi**** |
| TransitRouterTableId | string | 是 | 轉(zhuǎn)發(fā)路由器路由表 ID。 | vtb-6ehgc262hr170qgyc**** |
| NextHop | string | 是 | 下一跳連接 ID。 如果要使前綴列表下的網(wǎng)段均為黑洞路由，本參數(shù)需輸入 BlackHole。 | tr-attach-flbq507rg2ckrj**** |
| OwnerUid | long | 否 | 前綴列表所屬的阿里云賬號(hào)（主賬號(hào)）ID。 | 1210123456123456 |
| DryRun | boolean | 否 | 是否只預(yù)檢此次請(qǐng)求。取值：
說明
本參數(shù)當(dāng)前不生效。
| false |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 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. | 您沒有權(quán)限創(chuàng)建服務(wù)關(guān)聯(lián)角色，角色名：AliyunServiceRolePolicyForCEN，服務(wù)名：cen.aliyuncs.com。請(qǐng)確保已授予當(dāng)前用戶ram:CreateServiceLinkedRole權(quán)限。 |
| 400 | ResourceNotSupport.CCN | CCN not support prefix list. | CCN不支持prefix list。 |
| 400 | ResourceNotFound.PrefixlistCidrs | Can not find any cidr of specified prefix list. | prefix list不存在cidr。 |
| 400 | ResourceNotFound.Nexthop | The specified nexthop instance is not exsit. | 參數(shù)中指定的nexthop不存在。 |
| 400 | ResourceExisted.PrefixlistAssociation | The prefix list has been already associated with this route table. | prefix list已與路由表綁定。 |
| 400 | ResourceNotFound.PrefixlistAssociation | The prefix list is not associated with this route table. | prefix list未與路由表綁定。 |
| 400 | ResourceConflict.Route | Some of the prefixes of the prefix list are conflicted with exsited routes. | prefix list與已有路由存在沖突。 |
| 400 | MultipleFound.PrefixlistAssociation | multiple same prefix association record found. | 系統(tǒng)異常，系統(tǒng)中存在多個(gè)相同的記錄。 |
| 400 | QuotaReached.Route | The quota of the route table is not enough for the request prefix list. | 路由數(shù)量已達(dá)到上限。 |
| 400 | InvalidStatus.PrefixlistAssociation | The prefix list association is not in a valid state for the operation. | 當(dāng)前PrefixlistAssociation狀態(tài)不支持該操作，請(qǐng)稍后重試。 |
| 400 | NotSupport.TrType | The basic tr type is not support for this operation. | 基礎(chǔ)版轉(zhuǎn)發(fā)路由器不支持該操作。 |
| 400 | InvalidValue.PrefixlistCidr | Invalid cidr exist in the specified prefixlist. | prefixlist中存在不合法的cidr。 |
| 400 | ResourceNotSupport.Nexthop | The specified nexthop instance type is not support for the operation. | 參數(shù)中指定的nexthop不支持該操作。 |
| 400 | ResourceMismatch.Nexthop | The specified nexthop and nexthop type mismatched. | 參數(shù)中指定的nexthop或nexthopType有誤。 |
| 400 | ResourceNotFound.PrefixList | The specified prefixlist does not found. | 參數(shù)中指定的prefixlist不存在。 |
| 400 | OperationDenied.SystemPrefixList | SystemPrefixList can not be operated. | SystemPrefixList不允許操作。 |
| 400 | OperationFailed.OperateShareResource | Operate share prefixlist failed. | 共享prefixlist失敗。 |
| 400 | InvalidStatus.Prefixlist | Prefixlist is not in a operate status. | 當(dāng)前Prefixlist狀態(tài)不支持該操作。 |
| 400 | RegionNotSupport.Prefixlist | Prefixlist association are not supported in this region. | 當(dāng)前地域不支持該功能。 |
| 400 | OperationFailed.TransitRouterNotExist | Operation failed because transit router not exist. | 轉(zhuǎn)發(fā)路由器不存在。 |
| 400 | IncorrectStatus.RouteTable | RouteTable status is invalid. | 當(dāng)前操作涉及的路由表狀態(tài)不是穩(wěn)態(tài)，無法操作。 |
| 400 | IllegalParam.TransitRouterTableId | The specified Route Table ID is invalid. | 路由表ID不合法。 |
| 400 | InvalidParameter | Invalid parameter. | 參數(shù)不合法。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | 賬號(hào)無權(quán)限操作。 |
| 404 | InvalidRouteTableId.NotFound | The specified RouteTableId is not found. | RouteTableId不存在。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-11-22 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2022-08-25 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |