Querying the VPC channel List
Function
This API is used to query the list of VPC channels that have been created.
URI
The following table lists the HTTP/HTTPS request method and URI of the API.
Request Method | URI |
---|---|
GET | /v1.0/apigw/vpc-channels[?page_size, page_no, id, name, vpc_type] |
o
- A combination of different query conditions can be added at the end of the URI by using question marks (?) and ampersands (&).
- Query conditions include: id, name, vpc_type, page_size, and page_no.
Parameter | Mandatory | Type | Description |
---|---|---|---|
id | No | String | VPC channel ID |
name | No | String | VPC channel name |
vpc_type | No | Integer | VPC channel type, which can be: |
page_size | No | Integer | Number of VPC channels displayed on each page. The default value is 20. |
page_no | No | Integer | Page number. The default value is 1. |
precise_search | No | String | Parameter name (name) for exact matching |
Request
N/A
Response
Parameter | Type | Description |
---|---|---|
total | Integer | Total number of VPC channels that match the query conditions |
size | Integer | Length of the returned VPC channel list |
vpcs | Dictionary | VPC channel list |
Parameter | Type | Description |
---|---|---|
id | String | VPC channel ID |
name | String | VPC channel name |
type | Integer | VPC channel type, which can be:
|
member_type | String | Member type of the VPC channel, which can be:
|
status | Integer | VPC channel status, which can be:
|
port | Integer | Host port of the VPC channel |
balance_strategy | Integer | Distribution algorithm, which can be:
|
create_time | Timestamp | Time when the VPC channel is created |
Example response:
{"total": 2,"size": 2,"vpcs": [{"name": "Channel_1","type": 1,"member_type": "instance","port": 8080,"balance_strategy": 1,"id": "39c62689302a48fe9f4bd7cf5c052064","create_time": "2018-04-24T12:07:58Z","status": 1},{"name": "Channel_2","type": 2,"member_type": "instance","port": 8088,"balance_strategy": 1,"id": "e6831cbcbe2b45bbbc6318c2892f060b","create_time": "2018-04-24T11:57:03Z","status": 1}]}
Status Codes
Status Code | Description |
---|---|
200 | OK |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
500 | Server Internal Error |
- Function
- URI
- Request
- Response
- Status Codes