{"base_path":null,"components":{"parameters":{"AuthToken":{"description":"用户Token。 获取Token,请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。","in":"header","name":"X-Auth-Token","required":true,"schema":{"maxLength":10240,"minLength":0,"type":"string"}},"ExtFields":{"description":"show response ext-fields","in":"query","name":"ext_fields","schema":{"items":{"type":"string"},"maxItems":5,"minItems":0,"type":"array"}},"Fields":{"description":"显示字段列表","in":"query","name":"fields","required":false,"schema":{"items":{"maxLength":100,"minLength":0,"type":"string"},"maxItems":5,"minItems":1,"type":"array"}},"Limit":{"description":"每页返回的个数。\n取值范围:1~2000。","example":10,"in":"query","name":"limit","schema":{"default":2000,"format":"int32","maximum":2000,"minimum":1,"type":"integer"}},"Marker":{"description":"上一页最后一条资源记录的ID,为空时为查询第一页。\n使用说明:必须与limit一起使用。","example":"7f7f738f-453c-40b1-be26-28e7b9e390c1","in":"query","name":"marker","schema":{"maxLength":36,"minLength":0,"type":"string"}},"Offset":{"description":"分页偏移量","in":"query","name":"offset","required":false,"schema":{"example":10,"format":"int32","maximum":1000,"minimum":1,"type":"integer"}},"PageReverse":{"description":"分页参数","in":"query","name":"page_reverse","required":false,"schema":{"type":"boolean"}},"PathByGlobalDcGatewayId":{"description":"全域接入网关ID","in":"path","name":"global_dc_gateway_id","required":true,"schema":{"description":"全域接入网关ID","pattern":"[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}","type":"string"}},"ProjectId":{"description":"租户项目ID","in":"path","name":"project_id","required":true,"schema":{"maxLength":36,"minLength":0,"pattern":"[a-fA-F0-9]{32}","type":"string"}},"QueryById":{"description":"根据资源ID过滤实例","explode":true,"in":"query","name":"id","schema":{"items":{"type":"string"},"maxItems":5,"minItems":1,"type":"array"},"style":"form"},"QueryByName":{"description":"根据名字过滤查询,可查询多个名字。","example":["resourceA"],"explode":false,"in":"query","name":"name","schema":{"items":{"maxLength":64,"minLength":1,"pattern":"^[\\u4e00-\\u9fa50-9a-zA-Z_.\\-]+$","type":"string"},"maxItems":5,"minItems":1,"type":"array"},"style":"form"},"SortDir":{"description":"返回结果按照升序(asc)或降序(desc)排列,默认为asc","in":"query","name":"sort_dir","required":false,"schema":{"items":{"enum":["asc","desc"],"type":"string"},"type":"array"}},"SortKey":{"description":"排序字段。","example":["id"],"in":"query","name":"sort_key","required":false,"schema":{"default":"id","maxLength":36,"minLength":0,"type":"string"}}},"schemas":{"BandWidthInfo":{"description":"带宽信息","properties":{"bandwidth_size":{"description":"带宽值","format":"int32","maximum":268435455,"minimum":0,"type":"integer"},"gcb_id":{"description":"购买全域互连带宽包ID","maxLength":36,"minLength":0,"type":"string"}},"type":"object"},"ListPeerLinksResponseBody":{"description":"查询direct-connect-location列表的返回体","properties":{"page_info":{"$ref":"#/components/schemas/PageInfo"},"peer_links":{"description":"专线关联连接列表。","items":{"$ref":"#/components/schemas/PeerLinkEntry"},"maxItems":2000,"minItems":0,"type":"array"},"request_id":{"description":"请求ID。","example":"4ad3ef5a-5598-49ba-ab91-7c488cfe5723","maxLength":36,"minLength":0,"type":"string"}},"type":"object"},"PageInfo":{"description":"分页查询页的信息","properties":{"current_count":{"description":"当前列表中资源数量","format":"int32","maximum":2000,"minimum":0,"type":"integer"},"next_marker":{"description":"下一页的marker,值为资源的uuid,为空时表示最后一页","maxLength":36,"minLength":0,"type":"string"},"previous_marker":{"description":"上一页的marker,值为资源的uuid","maxLength":36,"minLength":0,"type":"string"}},"required":["current_count","previous_marker"],"type":"object"},"PeerLinkEntry":{"description":"实例的peer Link的详情","properties":{"bandwidth_info":{"$ref":"#/components/schemas/BandWidthInfo"},"create_owner":{"description":"创建归属服务名\n- cc 云连接\n- dc 云专线","format":"date-time","type":"string"},"created_time":{"description":"创建时间。","format":"date-time","type":"string"},"description":{"description":"描述信息","example":"到北京4的peer","maxLength":255,"minLength":0,"type":"string","x-ifnull":"hide"},"global_dc_gateway_id":{"description":"对应的专线全域接入网关ID","example":"f7b10579-74ee-4bb7-b2e2-74bfae081efd","maxLength":64,"minLength":0,"type":"string"},"id":{"description":"peer link ID。","example":"deddb081-a65b-4d3f-881a-c6a60114e9ad","maxLength":36,"minLength":0,"type":"string"},"instance_id":{"description":"实例ID","example":"0851a5e0-6623-42c2-bb02-b8956e313dd8","type":"string"},"name":{"description":"专线内部连接(peer link)名字","example":"peer_to_BJ4","maxLength":64,"minLength":0,"type":"string","x-ifnull":"hide"},"peer_site":{"$ref":"#/components/schemas/PeerSite"},"reason":{"description":"失败原因","example":"global-dc-gateway-to-bj-region","maxLength":255,"minLength":0,"type":"string","x-ifnull":"hide"},"status":{"$ref":"#/components/schemas/PeerLinkStatus"},"tenant_id":{"description":"租户项目ID","example":"cef6293371db41929ffd7459d5fd6e01","maxLength":255,"minLength":0,"pattern":"[a-z0-9]{32}","type":"string","x-ifnull":"hide"},"updated_time":{"description":"更新时间。","format":"date-time","type":"string"}},"type":"object"},"PeerLinkStatus":{"description":"关联连接状态, - PENDING_CREATE (创建中) - PENDING_UPDATE (更新中) - ACTIVE (可用状态) - ERROR (失败状态)","enum":["PENDING_CREATE","PENDING_UPDATE","ACTIVE","ERROR"],"example":"ACTIVE","type":"string"},"PeerSite":{"description":"对端的网关的描述信息","properties":{"gateway_id":{"description":"对端网关的ID","maxLength":36,"minLength":0,"type":"string"},"link_id":{"description":"对端网关连接的ID(如:对端为ER时为attachment ID,对端为GDGW时为对端的PeerLink Id","maxLength":64,"minLength":0,"type":"string"},"project_id":{"description":"对等体站点的项目ID","example":"cn-north4","maxLength":36,"minLength":0,"type":"string"},"region_id":{"description":"对端网关所在的Region","example":"cn-north4","maxLength":36,"minLength":0,"type":"string"},"site_code":{"description":"专线全域接入网关对应的站点位置","example":"area-subArea-city","maxLength":64,"minLength":0,"type":"string","x-ifnull":"hide"},"type":{"description":"对等体的类型\n- ER 企业路由器\n- GDGW 全域接入网关","enum":["ER","GDGW"],"example":"ER","maxLength":64,"minLength":0,"type":"string","x-ifnull":"hide"}}}}},"consumes":"","definitions":null,"description":null,"group_id":"044e9f7ee6954f958198fe6f41f8bf50","host":"dcaas.cn-north-4.myhuaweicloud.com","id":"8c885de379b447bbadbce4da1cfafc7e","info_version":"v3","method":"get","name":"ListPeerLinks","parameters":null,"paths":{"/v3/{project_id}/dcaas/global-dc-gateways/{global_dc_gateway_id}/peer-links":{"get":{"description":"查询全域接入网关与ER等对象的关联连接列表,分页查询使用的参数为marker、limit。marker和limit一起使用时才会生效,单独使用无效","operationId":"ListPeerLinks","parameters":[{"$ref":"#/components/parameters/AuthToken"},{"$ref":"#/components/parameters/ProjectId"},{"$ref":"#/components/parameters/PathByGlobalDcGatewayId"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Marker"},{"$ref":"#/components/parameters/PageReverse"},{"$ref":"#/components/parameters/Fields"},{"$ref":"#/components/parameters/ExtFields"},{"$ref":"#/components/parameters/SortKey"},{"$ref":"#/components/parameters/SortDir"},{"$ref":"#/components/parameters/QueryById"},{"$ref":"#/components/parameters/QueryByName"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListPeerLinksResponseBody"}}},"description":"OK","x-response-examples-1":{"application/json":{"peer_links":[{"bandwidth_info":{"bandwidth_size":0,"gcb_id":null},"create_owner":"cc","created_time":"2024-06-21T01:48:57.000Z","description":"","global_dc_gateway_id":"1c6edc27-5fdb-4dae-ac77-72d47c70ed83","id":"5ad07c58-71a8-41b7-a5c0-5b6148d518b2","instance_id":"f174fa3e-d63a-45bb-a5a4-b56782552494","name":"dgw-zss-02_1_peer_link","peer_site":{"gateway_id":"f8551651-0f42-48ff-9088-fff87e6d74e2","link_id":"c794a0f3-e89d-4e64-a614-9b6be4394b07","project_id":"6bea6e6ed6b34892bd2e195cad496348","region_id":"cn-southwest-246","site_code":"cn-southwest-246","type":"ER"},"reason":null,"status":"ACTIVE","tenant_id":"b197c48159d44a66b32c538c3f8da89a","updated_time":"2024-11-17T08:44:18.504Z"}],"request_id":"d6f35fa3bde2e26efad6253bd32b4837"}},"x-response-examples-description-1":"专线连接查询列表结果"}},"summary":"查询专线关联连接列表","tags":["PeerLink"],"x-huawei-security":{"enableEProject":true,"epsAction":"list","pdpKey":"dcaas:peerLink:list"},"x-is-registered":"Y","x-request-examples-description-1":"查询专线连接列表","x-request-examples-url-1":"GET https://{dc_endpoint}/v3/b197c48159d44a66b32c538c3f8da89a/dcaas/global-dc-gateways/1c6edc27-5fdb-4dae-ac77-72d47c70ed83/peer-links","x-support-sdk":"Y"}}},"product_short":"DC","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"查询专线关联连接列表","tags":"专线关联连接","uri":null,"version":"3.0.1"}