文档首页/ 企业交换机 ESW/ API参考/ 二层连接/ 查询二层连接列表 - ListConnectionsAllInstances
更新时间：2025-11-20 GMT+08:00
查看PDF
分享

查询二层连接列表 - ListConnectionsAllInstances

功能介绍

当您的二层连接创建成功后，您可以通过调用此接口查询租户所有二层连接信息列表。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

esw:connection:list

List

-

-

-

-

URI

GET /v3/{project_id}/l2cg/connections

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

  • 参数解释：ESW实例所属项目ID。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

id

否

String

  • 参数解释：二层连接资源ID。二层连接创建成功后，会生成一个ID，是二层连接对应的唯一标识。

  • 约束限制：带“-”的UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

name

否

String

  • 参数解释：二层连接的名称。

  • 约束限制：

    • 长度范围为1~64个字符。

    • 名称由中文、英文字母、数字、下划线（_）、中划线（-）、点（.）组成。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

instance_id

否

String

  • 参数解释：ESW资源ID。ESW创建成功后，会生成一个ESW ID，是ESW对应的唯一标识。

  • 约束限制：带“-”的UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

vpc_id

否

String

  • 参数解释：ESW所在VPC资源ID。

  • 约束限制：

    • 需要使用本租户下可操作的VPC资源的ID。

    • 带“-”的UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

virsubnet_id

否

String

  • 参数解释：二层连接关联的二层子网ID。

  • 约束限制：

    • 需要使用本租户下可操作的子网资源的ID；此值即为子网详情中的“网络ID”参数值。

    • 带“-”的UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

request_id

String

  • 参数解释：请求的唯一标识。

  • 约束限制：UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

page_info

PageInfo object

  • 参数解释：分页信息。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

connections

Array of Connection objects

  • 参数解释：查询二层连接列表的响应体。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。
表4 PageInfo

参数

参数类型

描述

next_marker

String

  • 参数解释：当前页的最后一条记录，最后一页时无next_marker字段。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

previous_marker

String

  • 参数解释：分页查询起始的资源ID，为空时查询第一页。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

current_count

Integer

  • 参数解释：当前页记录总数。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。
表5 Connection

参数

参数类型

描述

fixed_ips

Array of strings

  • 参数解释：下联面网口主备IP；ESW实例在本端二层子网中占用的主备接口IP。

  • 约束限制：字符串列表，只能设置两个字符串，且每个字符串内容应该是标准IPv4格式；IP必须在二层子网网段范围内。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

id

String

  • 参数解释：二层连接的唯一标识。

  • 约束限制：带“-”的UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

instance_id

String

  • 参数解释：ESW实例的唯一标识。

  • 约束限制：带“-”的UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

name

String

  • 参数解释：二层连接的名称。

  • 约束限制：

    • 长度范围为1~64个字符。

    • 名称由中文、英文字母、数字、下划线（_）、中划线（-）、点（.）组成。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

project_id

String

  • 参数解释：ESW实例所属项目ID。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

remote_infos

Array of RemoteInfosResult objects

  • 参数解释：远端隧道信息。

  • 约束限制：不涉及。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

status

String

  • 参数解释：二层连接的状态。

  • 约束限制：不涉及。

  • 取值范围：

    • pending：准备中

    • connected：已连接

    • disconnect：未连接

    • failed：创建失败

    • abnormal：异常

  • 默认取值：不涉及。

virsubnet_id

String

  • 参数解释：二层连接关联的二层子网ID。

  • 约束限制：

    • 需要使用本租户下可操作的子网资源的ID；此值即为子网详情中的“网络ID”参数值。

    • 带“-”的UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

vpc_id

String

  • 参数解释：ESW所在VPC资源ID。

  • 约束限制：

    • 需要使用本租户下可操作的VPC资源的ID。

    • 带“-”的UUID格式。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

created_at

String

  • 参数解释：二层连接创建时间。

  • 约束限制：UTC时间，格式为yyyy-MM-ddTHH:mm:ss。

  • 取值范围：不涉及。

  • 默认取值：不涉及。

updated_at

String

  • 参数解释：二层连接更新时间。

  • 约束限制：UTC时间，格式为yyyy-MM-ddTHH:mm:ss。

  • 取值范围：不涉及。

  • 默认取值：不涉及。
表6 RemoteInfosResult

参数

参数类型

描述

segmentation_id

Integer

  • 参数解释：二层连接的隧道号，对应VXLAN网络标识VNI。

  • 约束限制：需与对端VXLAN设置的VNI保持一致。

  • 取值范围：1-16777216。

  • 默认取值：不涉及。

tunnel_ip

String

  • 参数解释：ESW实例的远端隧道IP。

  • 约束限制：不能与已存在的子网IP冲突。

  • 取值范围：标准的IPv4格式，例：192.168.1.1。

  • 默认取值：不涉及。

tunnel_port

Integer

  • 参数解释：二层连接的远端隧道端口。

  • 约束限制：不涉及。

  • 取值范围：4789。

  • 默认取值：不涉及。

tunnel_type

String

  • 参数解释：ESW实例的隧道协议类型。

  • 约束限制：不涉及。

  • 取值范围：vxlan。

  • 默认取值：不涉及。

请求示例

GET https://{{endpoint}}/v3/060576782980d5762f9ec014dd2f1148/l2cg/connections

响应示例

状态码：200

GET操作正常返回，更多状态码请参见状态码。

{
  "request_id" : "d3301f85b4951cce72aa30e6deae7022",
  "connections" : [ {
    "name" : "l2conn-ba19",
    "id" : "9cb4f6bd-89a0-4633-b53e-c333b8c9277f",
    "status" : "disconnect",
    "created_at" : "2025-06-24T06:09:03Z",
    "updated_at" : "2025-08-22T02:30:50Z",
    "project_id" : "88104fcc62a640bfa0a0bf687607621c",
    "instance_id" : "16b2eea7-5935-445d-8410-083b7064b939",
    "vpc_id" : "41829b5e-66c0-4928-a3d4-f4570ce81d8f",
    "virsubnet_id" : "7ef08d1e-6e82-4133-9147-5dde6a50ee90",
    "fixed_ips" : [ "192.168.1.170", "192.168.1.140" ],
    "remote_infos" : [ {
      "segmentation_id" : 6790,
      "tunnel_ip" : "192.168.4.202",
      "tunnel_port" : 4789,
      "tunnel_type" : "vxlan"
    } ]
  }, {
    "name" : "l2conn-89a4",
    "id" : "d5a0c32d-e52d-48d8-8afb-ee9975618ba3",
    "status" : "disconnect",
    "created_at" : "2025-08-22T02:53:04Z",
    "updated_at" : "2025-08-22T02:53:18Z",
    "project_id" : "88104fcc62a640bfa0a0bf687607621c",
    "instance_id" : "a14aa233-3ac1-4218-8d85-b168a6c1b6df",
    "vpc_id" : "a36e12f4-b490-4b85-bf41-dc61f8f4f4d7",
    "virsubnet_id" : "be272d7a-5111-451a-af8b-09b673b1a7e9",
    "fixed_ips" : [ "192.168.1.158", "192.168.1.42" ],
    "remote_infos" : [ {
      "segmentation_id" : 9732,
      "tunnel_ip" : "192.168.0.76",
      "tunnel_port" : 4789,
      "tunnel_type" : "vxlan"
    } ]
  } ],
  "page_info" : {
    "previous_marker" : "9cb4f6bd-89a0-4633-b53e-c333b8c9277f",
    "current_count" : 2
  }
}

状态码

状态码

描述

200

GET操作正常返回，更多状态码请参见状态码。

错误码

请参见错误码。

父主题： 二层连接

相关文档