查询对等连接 - ShowVpcPeering

功能介绍

查询对等连接详情。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
vpc:peerings:get
Read
peering *
vpc:AccepterVpcId
vpc:RequesterVpcId
vpc:PeeringId
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
vpc:peerings:get	Read	peering *	vpc:AccepterVpcId vpc:RequesterVpcId vpc:PeeringId	-	-

URI

GET /v2.0/vpc/peerings/{peering_id}

参数说明请参见表1。

表1 参数说明
名称	是否必选	参数类型	说明
peering_id	是	String	对等连接的唯一标识，按照peering_id查询

请求参数

无

请求示例

GET https://{Endpoint}/v2.0/vpc/peerings/22b76469-08e3-4937-8c1d-7aad34892be1

响应参数

表2 响应参数
参数名称	类型	说明
peering	peering object	peering对象列表，参见表3。

表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

响应示例

{ 
    "peering": { 
        "name": "test", 
        "description": "test",
        "id": "22b76469-08e3-4937-8c1d-7aad34892be1",
        "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"
        }, 
        "status": "ACTIVE"
    }
}