Querying Direct Connect Channel List

Last updated: 2020-06-04 18:52:20


    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new DC API 3.0 which is standardized and faster.


    This API (DescribeDirectConnectTunnels) is used to query the list of direct connect tunnels.
    Domain name: dc.api.qcloud.com

    Request Parameters

    The following request parameter list only provides the API request parameters. Common request parameters are required when the API is called. The Action field for this API is DescribeDirectConnectTunnels.

    Parameter Required Type Description
    directConnectId No String Direct connect ID
    For example: dc-kd7d06of
    directConnectTunnelId No String Direct connect tunnel ID
    For example: dcx-kd7d0125

    Response Parameters

    Parameter Type Description
    code Int Error code
    0: Successful
    Other values: Failed
    message String Error message
    data.n Array Returned array
    data.n.directConnectTunnelId String Direct connect tunnel ID assigned by the system
    For example: dcx-kd7d0125
    data.n.directConnectTunnelName String Direct connect tunnel name
    data.n.directConnectId String Direct connect ID assigned by the system
    For example: dc-kd7d06of
    data.n.ownerAccount String Developer account ID of the direct connect
    data.n.networkType Int Network type. Default is 0.
    0: VPC
    1: BM network
    data.n.region String Network region
    data.n.vpcId String Unified ID of VPC/BM network
    data.n.directConnectGatewayId String Direct connect gateway ID, for example: dcg-d545ddf
    data.n.bandwidth Int Direct connect bandwidth (in Mbps)
    data.n.routeMode Int 0: BGP routing
    1: Static routing
    Default is BGP routing.
    data.n.bgpPeers.asn string BGP ASN
    data.n.bgpPeers.authKey String BGP key
    data.n.routeFilterPrefixes.n.cidr String Peer IP address range
    data.n.status Int Status of the direct connect tunnel
    0: Connected
    1: Requesting
    2: Configuring
    6: Configured
    20: Waiting for connection
    21: Rejected
    data.n.vlan Int vlan Id
    data.n.localGatewayIp String Tencent's IP
    data.n.peerGatewayIp String Customer's IP
    data.n.peeringSubnetMask String The mask of interconnection IP
    For example:
    data.n.remark String Notes

    Sample Code

    Request example

      GET https://dc.api.qcloud.com/v2/index.php?Action=DescribeDirectConnectTunnels
      &<<a href="https://cloud.tencent.com/doc/api/229/6976">common request parameters</a>>

    Response example

        "code": 0,
        "message": "",
        "data": [
                "directConnectTunnelId": "dcx-2nakhj58",
                "directConnectTunnelName": "barrytest2",
                "directConnectId": "dc-5e8ak079",
                "networkType": 1,
                "ownerAccount": "",
                "region": "gz",
                "vpcId": "vpc-kx49lmyv",
                "bandwidth": 0,
                "routeMode": 0,
                "bgpPeers": {
                    "asn": "10",
                    "authKey": "124545d"
                "routeFilterPrefixes": [
                        "cidr": ""
                "status": 1,
                "vlan": 0,
                "remark": ""

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback