Query dedicated line list
Updated at：2025-11-11
Description
Query information about the dedicated channel list.
Request structure
Plain Text
1GET /v{version}/et?marker={marker}&maxKeys={maxKeys}&status={status} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization stringRequest headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | For API version No., the current value is 1 |
| marker | String | No | Query | The starting position of the batch list query is a system-generated string |
| maxKeys | Integer | No | Query | Maximum number of items included per page, maximum: 1,000, default: 1,000 |
| status | String | No | Query | Dedicated line status, with the value range being ack-wait/accept/reject/building/pay-wait/established/stopped/deleted, respectively corresponding to application pending/accepted/rejected/under construction/unpaid (construction completed, with port duration fee unpaid)/available/expired/pending deletion upon expiration |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| marker | String | Mark the starting position of the query. |
| isTruncated | Boolean | true indicates there is more data later, false indicates it is the last page |
| nextMarker | String | The marker value needed to fetch the next page. This field is absent when isTruncated is false. |
| maxKeys | Integer | Maximum number of items included per page |
| ets | List<[ET](ET/API Reference/Appendix.md#ET)> | Dedicated channel list |
Request example
Plain Text
1GET /v{version}/et?marker=dcphy-gq65bz9ip712&maxKeys=1 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/20170311T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de Response example
Plain Text
1 HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3 Date: Thu, 16 Mar 2017 06:29:48 GMT
4 Content-Type: application/json;charset=UTF-8
5 Server: BWS
6
7{
8 "nextMarker": "dcphy-gq65bz9ip712",
9 "marker": "dcphy-gq65bz9ie712",
10 "maxKeys": 1,
11 "isTruncated": true,
12 "ets": [{
13 "id": "dcphy-jy1sbnx32ez0",
14 "name": "et_6",
15 "description": "Description",
16 "status": "established",
17 "expireTime": "2019-01-30T08:50:00Z",
18 "isp": "ISP_CTC",
19 "intfType": "10G",
20 "apType": "BAIDU",
21 "apAddr": "BB",
22 "userName": "Zhang San",
23 "userPhone": "133*****333",
24 "userEmail": "1***@123.com",
25 "userIdc": "Beijing|Municipal District|Dongcheng District|2321",
26 "tags":[
27 {
28 "tagKey": "tagKey",
29 "tagValue": "tagValue"
30 }
31 ]
32 }]
33}