查询对等连接列表
功能介绍
查询提交请求的租户的所有对等连接。根据过滤条件进行过滤。分页查询请参考分页查询。
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} | 名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| id | 否 | String | 按照peering_id过滤查询 |
| name | 否 | String |
|
| status | 否 | String | 按照status进行过滤 |
| tenant_id | 否 | String | 按照tenant_id过滤查询 |
| vpc_id | 否 | String | 按照vpc_id过滤查询 |
| marker | 否 | String | 分页查询的起始资源ID，表示从指定资源的下一条记录开始查询。 marker需要和limit配合使用：
|
| limit | 否 | Integer | 分页查询每页返回的记录个数，取值范围为0~intmax（2^31-1），默认值2000。 limit需要和marker配合使用，详细规则请见marker的参数说明。 默认值为2000。 |
请求参数
无
请求示例
GET https://{Endpoint}/v2.0/vpc/peerings 响应参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| 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。 |
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 对等连接id |
| name | String | 对等连接的名称 |
| status | String | 状态位：
|
| 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 |
响应示例
{
"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"
}
]
} 状态码
请参见状态码。
错误码
请参考错误码。
