You need to enable JavaScript to run this app.
文档中心
专线连接

专线连接

复制全文
下载 pdf
物理专线
DescribeDirectConnectConnectionAttributes - 查询物理专线详情
复制全文
下载 pdf
DescribeDirectConnectConnectionAttributes - 查询物理专线详情
调用DescribeDirectConnectConnectionAttributes查询指定物理专线的详细信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action String 必选 示例值:DescribeDirectConnectConnectionAttributes​
接口名称。当前 API 的名称为 DescribeDirectConnectConnectionAttributes。​
​
Version String 必选 示例值:2020-04-01​
接口版本。当前 API 的版本为 2020-04-01。​
​
DirectConnectConnectionId String 必选 示例值:dcc-7qthudw0ll6jmc****​
要查询的物理专线的ID。您可调用DescribeDirectConnectConnections查询物理专线的ID。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
ConnectionType String 示例值:DedicatedConnection​
物理专线的类型。​
  • DedicatedConnection:独享专线​
  • SharedConnection:共享专线​
​
AccountId String 示例值:21000*****​
物理专线所属账号的ID。​
​
DirectConnectConnectionId String 示例值:dcc-7qthudw0ll6jmc****​
物理专线的ID。​
  • 若物理专线类型为独享专线,则返回值为独享专线的ID。​
  • 若物理专线类型为共享专线,则返回值为共享专线的ID。​
​
DirectConnectConnectionName String 示例值:test​
物理专线的名称。​
​
Description String 示例值:This is a sample description​
物理专线的描述。​
​
CreationTime String 示例值:2021-04-09T08:36:47+08:00​
创建物理专线的时间。​
​
UpdateTime String 示例值:2021-04-10T09:18:28+08:00​
更新物理专线的时间。​
​
PortType String 示例值:1000Base​
物理专线的端口类型。​
  • 1000Base:表示1G光口。​
  • 10GBase:表示10G光口。​
  • 40GBase:表示40G光口。​
  • 100GBase:表示100G光口。​
说明​
40GBase、100GBase默认不开放,如有需要,请联系客户经理。​
​
Bandwidth Integer 示例值:1000​
物理专线的带宽,单位:Mbps。​
​
LineOperator String 示例值:ChinaTelecom​
物理专线的运营商​
  • ChinaTelecom:中国电信​
  • ChinaMobile:中国移动​
  • ChinaUnicom:中国联通​
  • ChinaOther:中国其他具有相应电信业务经营资质的运营商。​
​
DirectConnectAccessPointId String 示例值:ap-cn-shanghai-***-A​
物理专线接入点的ID。可调用DescribeDirectConnectAccessPoints查询专线接入点的信息。​
​
PeerLocation String 示例值:北京IDC​
物理专线的对端接入点。​
​
Status String 示例值:Available​
物理专线的状态。​
  • Creating: 创建中​
  • Deleting: 删除中​
  • Pending:配置中​
  • Available:可用​
  • Initial:申请中​
  • Allocated:施工中​
  • Rejected:申请驳回​
  • UnConfirmed:等待对方接受​
  • NoPayment:待支付​
​
VlanId Integer 示例值:1212​
共享专线的VLAN ID。若物理专线类型为独享专线,则此参数返回“0”。​
​
ParentConnectionId String 示例值:dcc-e5z1z57glr0g2yjrzamyw****​
共享专线所属物理专线的ID。若物理专线类型为独享专线,则此参数返回空。​
​
ParentConnectionAccountId String 示例值:2000956****​
共享专线所属物理专线的账号ID。若物理专线类型为独享专线,则此参数返回空。​
​
CustomerName String 示例值:韩*梅​
专线联系人姓名。​
​
CustomerContactPhone String 示例值:185****2333​
专线联系人联系电话。​
​
CustomerContactEmail String 示例值:exampletest@163.com​
专线联系人联系邮箱。​
​
Tags Object[] 示例值:-​
物理专线已添加的全部标签信息。​
Key String 示例值:k1​
标签键。​
​
Value String 示例值:v1​
标签值。​
​
​
PortSpec String 示例值:1G​
专线端口规格。​
​
BillingType Integer 示例值:1​
专线计费类型,当前仅支持“1”包年包月计费。​
​
BusinessStatus String 示例值:Normal​
专线的计费状态。​
  • Normal: 正常。​
  • FinancialLocked: 被锁定。​
​
DeletedTime String 示例值:2023-12-02 23:59:59​
预期资源强制回收时间。​
​
ExpiredTime String 示例值:2023-12-03 12:00:00​
专线的到期时间。​
​
ExpectBandwidth Integer 示例值:500​
期望物理专线的带宽,单位:Mbps。​
​
ProjectName String 示例值:Project_1​
物理专线所属的项目。​
​
DirectConnectTrafficQosPolicyId String 示例值:dcq-4atoi32cl4c9t0q****​
物理专线关联的QoS策略的ID。​
​
ExpectedExpireShutdownTime String 示例值:2024-10-11 12:00:00​
专线到期关停的时间。​
​
AdvanceFeatures Object[] 示例值:-​
物理专线支持的功能特性详情。​
macsec Boolean 示例值:false​
是否支持Macsec加密。​
  • true:支持。​
  • false:不支持。​
​
​
IsCloudLinkService Boolean 示例值:false​
是否为上云链路服务。​
  • true:是。​
  • false:不是。​
​
LineNumber String 示例值:N9234***​
上云链路服务的楼内线编号。​
​
MacsecCipherSuite String 示例值:GCM-AES-XPN-256​
Macsec加密使用的加密套件。​
​
MacsecEncryptionMode String 示例值:no_encrypt​
Macsec的加密模式。​
  • no_encrypt:不加密。​
  • should_encrypt:条件加密模式。​
  • must_encrypt:强制加密模式。​
​
MacsecKeys Object[] 示例值:-​
Macsec加密的密钥信息。​
Status String 示例值:Available​
Macsec密钥的状态。​
  • Creating:创建中。​
  • Available:可使用。​
  • Pending:配置中。​
  • Deleting:删除中。​
​
KeyName String 示例值:macsec-key-1​
Macsec密钥的名称。​
​
StartOn String 示例值:2026-04-13T19:40:53+08:00​
Macsec密钥创建的时间。​
​
​
​
​
请求示例​
​
GET /?Action=DescribeDirectConnectConnectionAttributes&Version=2020-04-01&DirectConnectConnectionId=dcc-7qthudw0ll6jmc**** HTTP/1.1​
Host: directconnect.cn-beijing.volcengineapi.com​
X-Date: 20250804T033538Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250804/cn-beijing/directconnect/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "DescribeDirectConnectConnectionAttributes",​
"Version": "2020-04-01",​
"Service": "directconnect",​
"Region": "cn-north-1"​
},​
"Result": {​
"AccountId": "21000*****",​
"AdvanceFeatures": [​
{​
"macsec": true​
}​
],​
"Bandwidth": 1000,​
"BillingType": 1,​
"BusinessStatus": "Normal",​
"ConnectionType": "DedicatedConnection",​
"CreationTime": "2021-04-09T08:36:47+08:00",​
"CustomerContactEmail": "exampletest@163.com",​
"CustomerContactPhone": "185****2333",​
"CustomerName": "韩*梅",​
"DeletedTime": "2023-12-02 23:59:59",​
"Description": "This is a sample description",​
"DirectConnectAccessPointId": "ap-cn-shanghai-***-A",​
"DirectConnectConnectionId": "dcc-7qthudw0ll6jmc****",​
"DirectConnectConnectionName": "test",​
"DirectConnectTrafficQosPolicyId": "dcq-4atoi32cl4c9t0q****",​
"ExpectBandwidth": 500,​
"ExpectedExpireShutdownTime": "2024-10-11 12:00:00",​
"ExpiredTime": "2023-12-03 12:00:00",​
"IsCloudLinkService": true,​
"LineNumber": "N9234***",​
"LineOperator": "ChinaTelecom",​
"MacsecCipherSuite": "GCM-AES-XPN-256",​
"MacsecEncryptionMode": "no_encrypt",​
"MacsecKeys": [​
{​
"Status": "Available",​
"KeyName": "macsec-key-1",​
"StartOn": "2026-04-13T19:40:53+08:00"​
}​
],​
"ParentConnectionAccountId": "2000956****",​
"ParentConnectionId": "dcc-e5z1z57glr0g2yjrzamyw****",​
"PeerLocation": "北京IDC",​
"PortSpec": "1G",​
"PortType": "1000Base",​
"ProjectName": "Project_1",​
"Status": "Available",​
"Tags": [​
{​
"Key": "k1",​
"Value": "v1"​
}​
],​
"UpdateTime": "2021-04-10T09:18:28+08:00",​
"VlanId": 1212​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
404​
InvalidDirectConnectConnection.NotFound​
The specified direct connect connection does not exist.​
指定的物理专线不存在。​
​
​
最近更新时间:2026.07.10 15:41:38
这个页面对您有帮助吗?
有用
有用
无用
无用