Docs

Direct Connect

DC Connection

DescribeDirectConnectConnectionLoaAttributes - Querying a LOA application for a DC Connection

Call DescribeDirectConnectConnectionLoaAttributes to view the details of a LOA (Letter of Authorization) for a specified Direct Connect (DC) Connection.

Debug

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

The following only details request parameters specific to this API and key common parameters. For more information, see Common parameters.

Action String requiredExample: DescribeDirectConnectConnectionLoaAttributes

The interface name. The current API name is DescribeDirectConnectConnectionLoaAttributes.

Version String required Example: 2020-04-01

The interface version. The current API version is 2020-04-01.

DirectConnectConnectionId String required Example: dcc-3tehy13n2l4c6c0v****

The ID of the DC Connection.

You can call the DescribeDirectConnectConnections interface to query the DC Connection ID.

Response parameters

The following only details response parameters specific to this API. For more information, see Response structure.

DirectConnectConnectionId String Example: dcc-3tehy13n2l4c6c0v****

The ID of the DC Connection.

Bandwidth Integer Example: 1000

Bandwidth of the DC Connection. Unit: Mbps.

PeerLocation String Example: XXXX, Yuhang District, Hangzhou City, Zhejiang Province

The peer address for the DC Connection.

LineType String Example: MSTP

The connection type.

MSTP: MSTP DC Connection

MPLSVPN: MPLS VPN DC Connection

FIBRE: Fiber DC Connection

Other: Other types of DC Connections

LoaContent String Example: YmFzZTY0IGVuY29kZWQg****

The LOA encoded in Base64.

LoaContentType String Example: application/pdf

Fixed as application/pdf.

CompanyName String Example: ByteDance

The company name of the customer using the DC Connection.

SystemIntegrator String Example: VolcanoEngine

The name of the constructor.

ConstructionTime String Example: 2023-04-29

The time when the constructor is scheduled to arrive on site.

Engineers Object[] Example: -

The details of the construction engineer.

Name String Example: San* Zhang

Name of the construction engineer.

ContactPhone String Example: 1881188****

Contact information for the construction engineer.

CertificateNo String Example: 22222219990101****

The ID number of the construction engineer. Enter the ID card number or Passport number according to the ID type.

Certificate type String Example: IDCard

The ID type of the construction engineer. Values:

IDCard: Chinese ID card

Passport: International passport

Request examples

GET /? HTTP/1.1​
Host: directconnect.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/directconnect/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​

Response examples

{​
    "ResponseMetadata": {​
        "RequestId": "20230604110420****100232280022D31",​
        "Action": "DescribeDirectConnectConnectionLoaAttributes",​
        "Version": "2020-04-01",​
        "Service": "directconnect",​
        "Region": "cn-north-1"​
    },​
    "Result": {​
        "Bandwidth": 1000,​
        "CompanyName": "ByteDance",​
        "ConstructionTime": "2023-04-29",​
        "DirectConnectConnectionId": "dcc-3tehy13n2l4c6c0v****",​
        "Engineers": [​
            {​
                "Name": "San* Zhang",​
                "ContactPhone": "1881188****",​
                "CertificateNo": "22222219990101****",​
                "CertificateType": "IDCard"​
            }​
        ],​
        "LineType": "MSTP",​
        "LoaContent": "YmFzZTY0IGVuY29kZWQg****",​
        "LoaContentType": "application/pdf",​
        "PeerLocation": "XXXX, Yuhang District, Hangzhou City, Zhejiang Province",​
        "SystemIntegrator": "VolcanoEngine"​
    }​
}​

Error codes

The table below describes the error codes for this API that are associated with business logic. For details, see Common error codes.

Status code	Error codes	Error message	Description
404	InvalidDirectConnectConnectionLoa.NotFound	The specified direct connect connection LOA does not exist.	The LOA for the specified DC Connection does not exist.

Last updated: 2026.02.26 11:13:16