華為云計(jì)算 云知識 查詢連接列表ListAttachments
查詢連接列表ListAttachments

 

功能介紹

查詢 企業(yè)路由器 實(shí)例下的連接列表。

接口約束

  • 支持過濾查詢,過濾條件有state,resource_type,resource_id過濾條件可以重復(fù)和組合;

  • 支持分頁查詢,limit和marker組合實(shí)現(xiàn)分頁查詢;

  • 支持單字段排序,排序字段有[id,name,description,created_at,updated_at],不支持多字段排序。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動認(rèn)證鑒權(quán)。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

GET /v3/{project_id}/enterprise-router/{er_id}/attachments

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID

er_id

String

企業(yè)路由器實(shí)例ID

表2 Query參數(shù)

參數(shù)

是否必選

參數(shù)類型

limit

Integer

marker

String

state

Array

resource_type

Array

resource_id

Array

sort_key

Array

sort_dir

Array

請求參數(shù)

響應(yīng)參數(shù)

狀態(tài)碼: 200

表3 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

attachments

Array of AttachmentDetails objects

連接列表

page_info

PageInfo object

分頁查詢的信息

request_id

String

請求ID

表4 AttachmentDetails

參數(shù)

參數(shù)類型

id

String

name

String

description

String

state

String

created_at

String

updated_at

String

tags

Array of Tag objects

project_id

String

er_id

String

resource_id

String

resource_type

String

resource_project_id

String

associated

Boolean

route_table_id

String

表5 Tag

參數(shù)

參數(shù)類型

描述

key

String

標(biāo)簽鍵,最大長度36個(gè)unicode字符,格式為大小寫字母,數(shù)字,中劃線“-”,下劃線“_”,中文。

最小長度:0

最大長度:128

value

String

標(biāo)簽值,最大長度43個(gè)unicode字符,格式為大小寫字母,數(shù)字,中劃線“-”,下劃線“_”,點(diǎn)“.”,中文。

最小長度:0

最大長度:128

表6 PageInfo

參數(shù)

參數(shù)類型

描述

next_marker

String

下一個(gè)marker標(biāo)識,為空時(shí)表示最后一頁

current_count

Integer

當(dāng)前列表中資源數(shù)量

請求示例

查詢連接列表

GET https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/
enterprise-router/4ab54142-7c92-48ad-8288-77727a231052/attachments

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "attachments" : [ {
    "id" : "6f83b848-8331-4271-ac0c-ef94b7686402",
    "name" : "vpc-001",
    "description" : "vpc attachment",
    "resource_id" : "b715e131-3371-4e17-a2de-4f669e24439a",
    "resource_type" : "vpc",
    "project_id" : "0605767a9980d5762fbcc00b3537e757",
    "state" : "available",
    "created_at" : "2020-03-11T15:13:31Z",
    "updated_at" : "2020-03-11T15:13:31Z"
  }, {
    "id" : "6f83b848-8331-4271-ac0c-ef94b7686403",
    "name" : "vpc-002",
    "description" : "for test",
    "resource_id" : "4b8567f6-358f-4a7f-8cd3-3cbb82c0b25f",
    "resource_type" : "vpc",
    "project_id" : "0605767a9980d5762fbcc00b3537e757",
    "state" : "available",
    "created_at" : "2020-03-11T15:13:31Z",
    "updated_at" : "2020-03-11T15:13:31Z"
  } ],
  "page_info" : {
    "next_marker" : "1",
    "current_count" : 2
  },
  "request_id" : "b715e131-3371-4e17-a2de-4f669e24439a"
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯(cuò)誤碼

請參見錯(cuò)誤碼