更新时间:2022-01-25 GMT+08:00

查询对等连接列表

功能介绍

查询提交请求的租户的所有对等连接。根据过滤条件进行过滤。分页查询请参考分页查询

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}
参数说明请参见表1
表1 参数说明

名称

是否必选

参数类型

说明

id

String

按照peering_id过滤查询

name

String

  • 功能说明:按照peering_name过查询
  • 取值范围:最大长度不超过64

status

String

按照status进行过滤

tenant_id

String

按照tenant_id过滤查询

vpc_id

String

按照vpc_id过滤查询

marker

String

分页查询起始的资源ID,为空时为查询第一页

limit

Integer

  • 功能说明:每页返回的个数
  • 取值范围:0~intmax
  • 默认值:2000

请求消息

  • 请求参数

  • 请求样例
    GET https://{Endpoint}/v2.0/vpc/peerings

响应消息

  • 响应参数
    表2 响应参数

    参数名称

    类型

    说明

    peerings

    Array of peering objects

    peering对象列表,参见表3

    peerings_links

    Array of peerings_link objects

    peerings_link对象列表,参见表5

    表3 peering对象

    属性

    类型

    说明

    id

    String

    对等连接id

    name

    String

    对等连接的名称

    status

    String

    状态位:

    • PENDING_ACCEPTANCE:等待接受
    • REJECTED:已拒绝。
    • EXPIRED:已过期。
    • DELETED:已删除。
    • ACTIVE:活动的。

    request_vpc_info

    Object

    对等连接发起端vpc信息,请参见表4

    accept_vpc_info

    Object

    对等连接接受端vpc信息,请参见表4

    description

    String

    对等连接描述

    created_at

    String

    资源创建时间,UTC时间

    格式:yyyy-MM-ddTHH:mm:ss

    updated_at

    String

    资源更新时间,UTC时间

    格式:yyyy-MM-ddTHH:mm:ss

    表4 vpc_info对象

    属性

    类型

    说明

    vpc_id

    String

    对等连接其中一端vpc id

    tenant_id

    String

    对等连接其中一端vpc所属的项目id

    表5 peerings_link对象

    名称

    参数类型

    说明

    href

    String

    API链接

    rel

    String

    API链接与该API版本的关系

  • 响应样例
    {
        "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",
                "id": "b147a74b-39bb-4c7a-aed5-19cac4c2df13",
                "status": "ACTIVE"
            }
        ]
    }

状态码

请参见状态码

错误码

请参考错误码