查询对等连接列表ListVpcPeerings_对等连接

华为云计算云知识查询对等连接列表ListVpcPeerings

查询对等连接列表ListVpcPeerings

时间: 2023-09-21 11:33:54

API网关云计算

猜你想看：

实时语音识别云服务器配置 CDN是什么意思视频点播加速什么是云桌面

功能介绍

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

调试

您可以在API Explorer中调试该接口。

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，表示从指定资源的下一条记录开始查询。 marker需要和limit配合使用：若不传入marker和limit参数，查询结果返回第一页全部资源记录。若不传入marker参数，limit为10，查询结果返回第1~10条资源记录。若marker为第10条记录的资源ID，limit为10，查询结果返回第11~20条资源记录。若marker为第10条记录的资源ID，不传入limit参数，查询结果返回第11条及之后的所有资源记录。
limit	否	Integer	分页查询每页返回的记录个数，取值范围为0~intmax（2^31-1），默认值2000。 limit需要和marker配合使用，详细规则请见marker的参数说明。默认值为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。只有在使用limit过滤，并且资源个数超过limit或者资源个数超过2000时（limit默认值），该参数的rel和href取值才会显示为next和其对应的link。

表3 peering对象
属性	类型	说明
id	String	对等连接id
name	String	对等连接的名称
status	String	状态位： PENDING_ACCEPTANCE：等待接受 REJECTED：已拒绝。 EXPIRED：已过期。 DELETED：已删除。 ACTIVE：活动的。
request_vpc_info	vpc_info object	对等连接发起端vpc信息，请参见表4。
accept_vpc_info	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",
            "description": "test",
            "id": "b147a74b-39bb-4c7a-aed5-19cac4c2df13",
            "status": "ACTIVE"
        }
    ]
}

状态码

请参见状态码。

错误码

请参考错误码。

上一篇：华为云视频点播应对视频网站业务挑战和解决方案下一篇：查询规格详情和规格扩展信息列表ListFlavors

功能介绍

调试

URI

请求参数

请求示例

响应参数

响应示例

状态码

错误码

最新文章