Post x amz targetovertureservice.associatemacseckey

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1463248219.5 KB

Associates a MAC Security (MACsec) Connection Key Name (CKN)/ Connectivity Association Key (CAK) pair with an Direct Connect dedicated connection.

You must supply either the secretARN, or the CKN/CAK (ckn and cak) pair in the request.

For information about MAC Security (MACsec) key considerations, see MACsec pre-shared CKN/CAK key considerations in the Direct Connect User Guide.

post/#X-Amz-Target=OvertureService.AssociateMacSecKey

Headers

X-Amz-Target'OvertureService.AssociateMacSecKey' required

Request body

connectionIdstring required

The ID of the dedicated connection (dxcon-xxxx), or the ID of the LAG (dxlag-xxxx). You can use <a>DescribeConnections</a> or <a>DescribeLags</a> to retrieve connection ID.

secretARNstring

The Amazon Resource Name (ARN) of the MAC Security (MACsec) secret key to associate with the dedicated connection. You can use <a>DescribeConnections</a> or <a>DescribeLags</a> to retrieve the MAC Security (MACsec) secret key. If you use this request parameter, you do not use the <code>ckn</code> and <code>cak</code> request parameters.

cknstring

The MAC Security (MACsec) CKN to associate with the dedicated connection. You can create the CKN/CAK pair using an industry standard tool. The valid values are 64 hexadecimal characters (0-9, A-E). If you use this request parameter, you must use the <code>cak</code> request parameter and not use the <code>secretARN</code> request parameter.

cakstring

The MAC Security (MACsec) CAK to associate with the dedicated connection. You can create the CKN/CAK pair using an industry standard tool. The valid values are 64 hexadecimal characters (0-9, A-E). If you use this request parameter, you must use the <code>ckn</code> request parameter and not use the <code>secretARN</code> request parameter.

Response

Success

connectionIdstring

The ID of the dedicated connection (dxcon-xxxx), or the ID of the LAG (dxlag-xxxx).