文档中心

专线连接

物理专线

AssociateDirectConnectConnectionMacSecKey-绑定MacSec密钥

调用AssociateDirectConnectConnectionMacSecKey接口，为指定物理专线绑定MacSec密钥。

使用说明

绑定MacSec密钥的物理专线需支持MacSec加密功能。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：AssociateDirectConnectConnectionMacSecKey

接口名称。当前 API 的名称为 AssociateDirectConnectConnectionMacSecKey。

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为 2020-04-01。

DirectConnectConnectionId String 必选示例值：dcc-2fe3zsmkshs59g****

物理专线的ID。

您可调用DescribeDirectConnectConnections接口，查询物理专线的ID。

KeyName String 必选示例值：KeyName01

MacSec密钥的名称。

以中文、字母、数字开头，只能包含中文、字母、数字、点号（.）、下划线（_）和中划线（-）。

长度限制为1 ~ 63个字符。

Ckn String 必选示例值：01349DE***

MacSec密钥对的CKN。

十六进制，长度为32或64个字符。

支持数字0~9和字母A~E。

Cak String 必选示例值：5521TN4***

MacSec密钥对的CAK。

十六进制，长度为32或64个字符。

支持数字0~9和字母A~E。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=AssociateDirectConnectConnectionMacSecKey&Version=2020-04-01&DirectConnectConnectionId=dcc-2fe3zsmkshs59g****&KeyName=KeyName01&Ckn=01349DE***&Cak=5521TN4*** 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": "AssociateDirectConnectConnectionMacSecKey",​
        "Version": "2020-04-01",​
        "Service": "directconnect",​
        "Region": "cn-north-1"​
    }​
}​

错误码

公共错误码请参见公共错误码文档。

最近更新时间：2026.07.10 15:41:39

这个页面对您有帮助吗？

有用

无用