通過ListCustomRoutingPortMappings查詢自訂路由類型監聽的連接埠映射表-Global Acceleration-阿里雲

調用ListCustomRoutingPortMappings介面查詢產生的連接埠映射表（自訂路由類型監聽）。

介面說明

配置自訂路由類型監聽及終端節點群組後，Global Acceleration執行個體能夠根據配置的監聽連接埠範圍、目標終端節點群組協議和連接埠範圍，以及終端節點（交換器 vSwitch）的 IP 位址資訊，產生連接埠映射表。自訂路由類型監聽可根據該連接埠映射表確定性地將流量路由到交換器中特定 IP 位址和連接埠。本介面用於查詢產生的連接埠映射表。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ga:ListCustomRoutingPortMappings

list

*CustomRoutingPortMapping

acs:ga:*:{#accountId}:ga/{#gaId}

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	Global Acceleration執行個體所在的地區 ID，僅取值cn-hangzhou。	cn-hangzhou
PageNumber	integer	否	列表的頁碼，預設值：1。	1
PageSize	integer	否	分頁查詢時每頁的條目數。最大值：50。預設值：10。	10
AcceleratorId	string	是	待查詢連接埠映射表的Global Acceleration執行個體 ID。	ga-bp1odcab8tmno0hdq****
ListenerId	string	否	待查詢連接埠映射表的監聽 ID。	lsr-bp1bpn0kn908w4nbw****
EndpointGroupId	string	否	待查詢連接埠映射表的終端節點群組 ID。	epg-bp16jdc00bhe97sr5****

返回參數

名稱	類型	描述	樣本值
	object	返回資訊列表。
RequestId	string	請求 ID。	04F0F334-1335-436C-A1D7-6C044FE73368
TotalCount	integer	列表條目數。	1
PageSize	integer	分頁查詢時每頁的條目數。	10
PageNumber	integer	列表的頁碼。	1
PortMappings	array<object>	連接埠映射表資訊。
	object	連接埠映射表資訊。
AcceleratorId	string	連接埠映射表所屬Global Acceleration執行個體 ID。	ga-bp1odcab8tmno0hdq****
ListenerId	string	連接埠映射表所屬自訂路由類型監聽 ID。	lsr-bp1bpn0kn908w4nbw****
EndpointGroupId	string	終端節點群組 ID。	epg-bp14sz7ftcwwjgrdm****
EndpointId	string	終端節點 ID。	ep-bp14sz7ftcwwjgrdm****
EndpointGroupRegion	string	終端節點群組所屬地區 ID。	us-west-1
Vswitch	string	終端節點交換器（vSwitch）執行個體名稱。	vsw-test01
AcceleratorPort	integer	加速連接埠。	3000
Protocols	array	後端服務合約類型。 TCP：TCP 協議。 UDP：UDP 協議。
	string	後端服務合約類型。 TCP：TCP 協議。 UDP：UDP 協議。	TCP
DestinationTrafficState	string	後端執行個體流量通行策略。 allow：允許後端執行個體接收流量。 deny：不允許後端執行個體接收流量。	allow
DestinationSocketAddress	object	後端執行個體服務 IP 位址與連接埠資訊。
IpAddress	string	後端執行個體服務 IP 位址。	10.0.XX.XX
Port	integer	後端執行個體服務連接埠。	443

樣本

正常返回樣本

JSON格式

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "TotalCount": 1,
  "PageSize": 10,
  "PageNumber": 1,
  "PortMappings": [
    {
      "AcceleratorId": "ga-bp1odcab8tmno0hdq****",
      "ListenerId": "lsr-bp1bpn0kn908w4nbw****",
      "EndpointGroupId": "epg-bp14sz7ftcwwjgrdm****",
      "EndpointId": "ep-bp14sz7ftcwwjgrdm****",
      "EndpointGroupRegion": "us-west-1",
      "Vswitch": "vsw-test01",
      "AcceleratorPort": 3000,
      "Protocols": [
        "TCP"
      ],
      "DestinationTrafficState": "allow",
      "DestinationSocketAddress": {
        "IpAddress": "10.0.XX.XX",
        "Port": 443
      }
    }
  ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	NoPermission	No permissions.	無許可權

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

變更歷史

更多資訊，參考變更詳情。