功能介紹
查詢提交請求的租戶的所有對等連接。根據(jù)過濾條件進行過濾。分頁查詢請參考分頁查詢。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v2.0/vpc/peerings
樣例:
GET https://{Endpoint}/v2.0/vpc/peerings?id={id}&name={name}&status={status}&
tenant_id={tenant_id}&vpc_id={vpc_id}&limit={limit}&marker={marker}
名稱 |
是否必選 |
參數(shù)類型 |
說明 |
---|---|---|---|
id |
否 |
String |
按照peering_id過濾查詢 |
name |
否 |
String |
|
status |
否 |
String |
按照status進行過濾 |
tenant_id |
否 |
String |
按照tenant_id過濾查詢 |
vpc_id |
否 |
String |
按照vpc_id過濾查詢 |
marker |
否 |
String |
分頁查詢的起始資源ID,表示從指定資源的下一條記錄開始查詢。 marker需要和limit配合使用:
|
limit |
否 |
Integer |
分頁查詢每頁返回的記錄個數(shù),取值范圍為0~intmax(2^31-1),默認值2000。 limit需要和marker配合使用,詳細規(guī)則請見marker的參數(shù)說明。 默認值為2000。 |
請求參數(shù)
無
請求示例
GET https://{Endpoint}/v2.0/vpc/peerings
響應(yīng)參數(shù)
參數(shù)名稱 |
類型 |
說明 |
---|---|---|
peerings |
||
peerings_links |
只有在使用limit過濾,并且資源個數(shù)超過limit或者資源個數(shù)超過2000時(limit默認值),該參數(shù)的rel和href取值才會顯示為next和其對應(yīng)的link。 |
屬性 |
類型 |
說明 |
---|---|---|
id |
String |
對等連接id |
name |
String |
對等連接的名稱 |
status |
String |
狀態(tài)位:
|
request_vpc_info |
||
accept_vpc_info |
||
description |
String |
對等連接描述 |
created_at |
String |
資源創(chuàng)建時間,UTC時間 格式:yyyy-MM-ddTHH:mm:ss |
updated_at |
String |
資源更新時間,UTC時間 格式:yyyy-MM-ddTHH:mm:ss |
響應(yīng)示例
{ "peerings": [ { "request_vpc_info": { "vpc_id": "9daeac7c-a98f-430f-8e38-67f9c044e299", "tenant_id": "f65e9ebc-ed5d-418b-a931-9a723718ba4e" }, "accept_vpc_info": { "vpc_id": "f583c072-0bb8-4e19-afb2-afb7c1693be5", "tenant_id": "f65e9ebc-ed5d-418b-a931-9a723718ba4e" }, "name": "test", "description": "test", "id": "b147a74b-39bb-4c7a-aed5-19cac4c2df13", "status": "ACTIVE" } ] }
狀態(tài)碼
請參見狀態(tài)碼。
錯誤碼
請參考錯誤碼。