功能介紹
查詢指定后端 云服務器 組的后端云服務器。支持過濾查詢和分頁查詢。如未特殊說明，匹配規(guī)則為精確匹配。
調試
您可以在API Explorer中直接運行調試該接口。
URI
GET /v2/{project_id}/elb/pools/{pool_id}/members
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
操作用戶的項目ID。 獲取方法詳見獲取項目ID。 |
|
pool_id |
是 |
String |
后端云服務器組id。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
marker |
否 |
String |
分頁查詢的起始的資源ID，表示上一頁最后一條查詢記錄的后端云服務器的ID。不指定時表示查詢第一頁。 必須與limit一起使用。 |
|
limit |
否 |
Integer |
分頁查詢每頁的后端云服務器個數(shù)。如果不設置，則默認不分頁查詢所有后端云服務器。 |
|
page_reverse |
否 |
Boolean |
分頁的順序，true表示從后往前分頁，false表示從前往后分頁，默認為false。 必須與limit一起使用。 |
|
id |
否 |
String |
后端云服務器的ID。 說明：
此處并非服務器的ID，而是ELB添加后端服務器之后自動生成的member ID。 |
|
tenant_id |
否 |
String |
后端云服務器所屬的項目ID。 支持的最大字符長度：255 獲取方法詳見獲取項目ID。 |
|
project_id |
否 |
String |
此參數(shù)和tenant_id參數(shù)含義一樣，均指后端云服務器所在的項目ID。 獲取方法詳見獲取項目ID。 |
|
name |
否 |
String |
后端云服務器的名稱。 支持的最大字符長度：255 說明：
此處并非服務器的名稱，而是ELB添加后端服務器之后生成的member名稱。 |
|
address |
否 |
String |
后端云服務器對應的IP地址。 支持的最大字符長度：64 |
|
protocol_port |
否 |
Integer |
后端云服務器后端端口的協(xié)議號。 |
|
subnet_id |
否 |
String |
后端云服務器所在的子網(wǎng)ID。 |
|
admin_state_up |
否 |
Boolean |
后端云服務器的管理狀態(tài)。 該字段為預留字段，暫未啟用。默認為true。 |
|
weight |
否 |
Integer |
后端云服務器的權重。 |
請求消息
無
響應消息
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
id |
String |
后端云服務器的 ID。 說明：
此處并非服務器的ID，而是ELB添加后端服務器之后自動生成的member ID。 |
|
tenant_id |
String |
后端云服務器所在的項目ID。 支持的最大字符長度：255 |
|
project_id |
String |
此參數(shù)和tenant_id參數(shù)含義一樣，均指后端云服務器所在的項目ID。 |
|
name |
String |
后端云服務器的名稱。 支持的最大字符長度：255 |
|
address |
String |
后端云服務器對應的IP地址，該IP必須在subnet_id字段指定子網(wǎng)的網(wǎng)段中，例如192.168.3.11。 只能對應主網(wǎng)卡的IP。 支持的最大字符長度：64 |
|
protocol_port |
Integer |
后端端口和協(xié)議號，取值范圍[1，65535]。 |
|
subnet_id |
String |
后端云服務器所在的子網(wǎng)ID。后端云服務器的IP地址在該子網(wǎng)的網(wǎng)段中。 不支持開啟了ipv6的子網(wǎng)。 |
|
admin_state_up |
Boolean |
后端云服務器的管理狀態(tài)。 該字段為預留字段，暫未啟用。取值范圍：true/false。
|
|
weight |
Integer |
后端云服務器的權重，取值范圍[0，100]。 權重為0的后端不再接受新的請求。默認為1。 |
|
operating_status |
String |
后端云服務器的健康狀態(tài)，取值：
|
請求示例
- 請求樣例1 全量查詢后端云服務器
GET https://{Endpoint}/v2/1a3e005cf9ce40308c900bcb08e5320c/elb/pools/5a9a3e9e-d1aa-448e-af37-a70171f2a332/members
- 請求樣例2 過濾查詢ip為10.0.0.8且端口為80的后端云服務器
GET https://{Endpoint}/v2/1a3e005cf9ce40308c900bcb08e5320c/elb/pools/
5a9a3e9e-d1aa-448e-af37-a70171f2a332/members?address=10.0.0.8&protocol_port=80
響應示例
- 響應樣例1
{ "members": [ { "address": "10.0.0.8", "admin_state_up": true, "id": "9a7aff27-fd41-4ec1-ba4c-3eb92c629313", "protocol_port": 80, "subnet_id": "013d3059-87a4-45a5-91e9-d721068ae0b2", "tenant_id": "1a3e005cf9ce40308c900bcb08e5320c", "project_id": "1a3e005cf9ce40308c900bcb08e5320c", "weight": 1, "operating_status": "ONLINE", "name": "member-name" } ] }
- 響應樣例2
{ "members": [ { "address": "10.0.0.8", "admin_state_up": true, "id": "9a7aff27-fd41-4ec1-ba4c-3eb92c629313", "protocol_port": 80, "subnet_id": "013d3059-87a4-45a5-91e9-d721068ae0b2", "tenant_id": "1a3e005cf9ce40308c900bcb08e5320c", "project_id": "1a3e005cf9ce40308c900bcb08e5320c", "weight": 1, "operating_status": "ONLINE", "name": "member-name" } ] }
返回碼
請參見狀態(tài)碼。
