Query Express List
Last Updated：2021-11-23
**Description **
Information on the Query Express List.
Request Structure
GET /v{version}/et?marker=dcphy-gq65bz9ip712&maxKeys=1&status=established HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization stringRequest Header Field
No other special header fields are available, except for common header fields.
Request Parameters
| Parameter name | Type | Required? | Parameter Position | Description |
|---|---|---|---|---|
| version | String | Yes | URL Parameters | API version number |
| marker | String | No | Query parameters | The start position of query to obtain the list by batch, which is a character string generated by the system. |
| maxKeys | Integer | No | Query parameters | The maximum number contained in each page, which is usually no more than 1,000 pages per page, and 1,000 by default. |
| status | String | No | Query parameters | Express status. Its value range is ack-wait/accept/reject/building/pay-wait/established/stopped/deleted, which respectively correspond to Applying/Application accepted/Application rejected/Constructing/Unpaid (the unpaid port duration fee for the completed construction)/Available/Expired/Deleting after the expiry |
Return Header Field
There are no other special header fields except the common header field.
Return Parameter
| Parameter Name | Type | Description |
|---|---|---|
| marker | String | Mark the starting position of the query |
| isTruncated | boolean | “True” means there is still data behind, and “false” means it is already the last page. |
| nextMarker | String | Gets the “marker” value to be passed on the next page. This field does not appear when “isTruncated” is false. |
| maxKeys | Integer | Maximum number of master instances per page |
| ets | List<ET> | ET List |
Request Example
GET /v{version}/et?marker=dcphy-gq65bz9ip712&maxKeys=1 HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce auth v1/f81d3b34e48048fbb2634dc7882d7e21/20170311T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Return Examples
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content Type: application/json;charset=UTF 8
Server: BWS
{
"nextMarker": "dcphy-gq65bz9ip712",
"marker": "dcphy-gq65bz9ie712",
"maxKeys": 1,
"isTruncated": true,
"ets": [{
"id": "dcphy-jy1sbnx32ez0",
"name": "et_6",
"description": "Description",
"status": "established",
"expireTime": "2019-01-30T08:50:00Z",
"isp": "ISP_CTC",
"intfType": "10G",
"apType": "BAIDU",
"apAddr": "BB",
"userName": "Zhang San",
"userPhone": "133*****333",
"userEmail": "1***@123.com",
"userIdc": "Bejing|City Area|Dongcheng Area|2321"
}]
}