調用ListTransitRouterRouteTableAssociations接口查詢企業版轉發路由器路由表或網絡實例連接已創建的關聯轉發關系。
接口說明
調用 ListTransitRouterRouteTableAssociations 接口時，請求參數 TransitRouterRouteTableId 和 TransitRouterAttachmentId 需至少輸入一個：
- 如果僅指定了 TransitRouterRouteTableId 參數的值，則表示您要查詢與企業版轉發路由器路由表創建關聯轉發關系的網絡實例連接的信息。
- 如果僅指定了 TransitRouterAttachmentId 參數的值，則表示您要查詢與網絡實例連接創建關聯轉發關系的企業版轉發路由器路由表的信息。
- 如果同時指定了 TransitRouterRouteTableId 和 TransitRouterAttachmentId 參數的值，則表示您要查詢網絡實例連接與企業版轉發路由器路由表之間的關聯轉發關系。
- 如果網絡實例連接和企業版轉發路由器路由表之間存在關聯轉發關系，則系統正常返回關聯轉發關系的信息。
- 如果網絡實例連接和企業版轉發路由器路由表之間不存在關聯轉發關系，則 TransitRouterAssociations 數組返回為空值。
在調用 ListTransitRouterRouteTableAssociations 接口過程時請確保輸入的參數值無誤。 如果您輸入的參數有誤調用接口后仍然會返回 RequestId 信息，但不會企業版轉發路由器路由表或網絡實例連接已創建的關聯轉發關系。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| cen:ListTransitRouterRouteTableAssociations | get |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| MaxResults | integer | 否 | 分批次查詢時每次顯示的條目數。默認值：50。 | 50 |
| NextToken | string | 否 | 是否擁有下一次查詢的令牌（Token）。取值：
| a415**** |
| TransitRouterRouteTableId | string | 否 | 企業版轉發路由器路由表 ID。 | vtb-bp1dudbh2d5na6b50**** |
| TransitRouterAttachmentId | string | 否 | 網絡實例連接 ID。 | tr-attach-nls9fzkfat8934**** |
| TransitRouterAttachmentResourceId | string | 否 | 下一跳資源 ID。 | vpc-bp1h8vbrbcgohcju5**** |
| TransitRouterAttachmentResourceType | string | 否 | 下一跳資源類型。
| VPC |
| Status | string | 否 | 關聯轉發的狀態。
| Active |
返回參數
示例
正常返回示例
JSON格式
{
"NextToken": "a415****",
"RequestId": "F6B1D9AB-176D-4399-801D-8BC576F4EB0D",
"TotalCount": 1,
"MaxResults": 50,
"TransitRouterAssociations": [
{
"TransitRouterAttachmentId": "tr-attach-nls9fzkfat8934****",
"Status": "Associating",
"ResourceType": "VPC",
"ResourceId": "vpc-bp1h8vbrbcgohcju5****",
"TransitRouterRouteTableId": "vtb-bp1dudbh2d5na6b50****"
}
]
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | IllegalParam.NextToken | The parameter NextToken is invalid. | 指定的NextToken無效。請檢查參數約束，并在修改后重試。 |
| 400 | IllegalParam.MaxResults | The specified MaxResults is illegal. | MaxResults非法。 |
| 400 | InvalidParameter | Invalid parameter. | 參數不合法。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | 賬號無權限操作。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-08-04 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-01-06 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
| 2022-10-27 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |