ListGatewayRouteTableEntries

更新時間:
Copy as MD

呼叫 ListGatewayRouteTableEntries 介面查詢閘道路由表列表資訊。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:ListGatewayRouteTableEntries

list

*RouteTable

acs:vpc:{#regionId}:{#accountId}:routetable/{#routetableId}

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

要查詢閘道路由表列表資訊的地域 ID。

您可以透過呼叫 DescribeRegions 介面取得地域 ID。

ap-southeast-6

MaxResults

integer

分批次查詢時每次顯示的條目數。取值範圍:1~100,預設值為 10

10

NextToken

string

是否擁有下一次查詢的權杖(Token)。取值:

  • 第一次查詢和沒有下一次查詢時,均無需填寫。

  • 如果有下一次查詢,取值為上一次 API 呼叫傳回的 NextToken 值。

FFmyTO70tTpLG6I3FmYAXGKPd****

GatewayRouteTableId

string

要查詢的閘道路由表 ID。

vtb-5ts0ohchwkp3dydt2****

DestinationCidrBlock

string

要查詢的閘道路由表中路由條目的目標網段。

192.168.0.5

RegionId

string

要查詢閘道路由表列表資訊的地域 ID。

您可以透過呼叫 DescribeRegions 介面取得地域 ID。

ap-southeast-6

返回參數

名稱

類型

描述

樣本值

object

閘道路由表列表資訊。

NextToken

string

是否擁有下一次查詢的權杖(Token)。取值:

  • 如果 NextToken 為空表示沒有下一次查詢。

  • 如果 NextToken 有傳回值,該取值表示下一次查詢開始的權杖。

FFmyTO70tTpLG6I3FmYAXGKPd****

RequestId

string

請求 ID。

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

TotalCount

string

列表條目數。

1

GatewayRouteEntryModels

array<object>

閘道路由表中路由條目的詳細資訊。

array<object>

閘道路由表中路由條目的詳細資訊。

Status

string

路由條目的狀態。

  • Pending:設定中。

  • Available:可用。

  • Modifying:修改中。

Available

NextHopId

string

下一跳執行個體 ID。

i-bp11gcl0sm85t9bi****

Description

string

路由條目的名稱。

test

NextHopType

string

下一跳的類型。取值:

  • EcsInstance:ECS 執行個體。

  • NetworkInterface:彈性網路卡。

  • Local:本地。

EcsInstance

DestinationCidrBlock

string

路由條目的目標網段。

192.168.0.5

Name

string

路由條目的名稱。

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

name

NextHops

array<object>

下一跳資訊。

object

NextHopId

string

下一跳執行個體 ID。

vpn-bp10zyaph5cc8b7c7****

NextHopType

string

下一跳類型。取值:

  • Instance(預設值):ECS 執行個體。

  • HaVip:高可用虛擬 IP。

  • VpnGateway:VPN 閘道。

  • NatGateway:NAT 閘道。

  • NetworkInterface:輔助彈性網路卡。

  • RouterInterface:路由器介面。

  • IPv6Gateway:IPv6 閘道。

  • Attachment:轉發路由器。

Instance

Weight

string

路由條目的權重。

100

Enabled

string

路由是否可用。取值:

  • 0:不可用。

  • 1:可用。

1

樣本

正常返回樣本

JSON格式

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "TotalCount": "1",
  "GatewayRouteEntryModels": [
    {
      "Status": "Available",
      "NextHopId": "i-bp11gcl0sm85t9bi****",
      "Description": "test",
      "NextHopType": "EcsInstance",
      "DestinationCidrBlock": "192.168.0.5",
      "Name": "name",
      "NextHops": [
        {
          "NextHopId": "vpn-bp10zyaph5cc8b7c7****",
          "NextHopType": "Instance",
          "Weight": "100",
          "Enabled": "1"
        }
      ]
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 ResourceNotFound.GatewayRouteTable The specified resource GatewayRouteTable is not found.
400 IllegalParam.NextToken The param of nextToken is illegal

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

變更歷史

更多資訊,參考變更詳情