Dissociates a MACsec key from a dedicated Express Connect circuit port.
Operation description
If you dissociate a key that is in the Associated state, the most recently effective key is automatically associated.
If you dissociate a key that is in the Disassociated state, the key is deleted.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID of the Express Connect circuit. You can call the DescribeRegions operation to query region IDs. |
cn-hangzhou |
| PhysicalConnectionId |
string |
Yes |
The ID of the Express Connect circuit. The Express Connect circuit must be in the Enabled state and its BusinessStatus must be Normal. You can call DescribePhysicalConnections to query the circuit. |
pc-bp1hp0wr072f6**** |
| Ckn |
string |
Yes |
The key name. Only hexadecimal characters are supported. Lowercase characters are automatically converted to uppercase. When the encryption algorithm is GCM-AES-128 or GCM-AES-XPN-128, the length must be 32 hexadecimal characters. When the encryption algorithm is GCM-AES-256 or GCM-AES-XPN-256, the length must be 64 hexadecimal characters. This value must be a key name that has been associated with the target Express Connect circuit by calling AssociateMacSecKey. |
0123456789ABCDEF0123456789ABCDEF |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
D32B3C26-6C6C-4988-93E9-D2A6444CE6AE |
Examples
Success response
JSON format
{
"RequestId": "D32B3C26-6C6C-4988-93E9-D2A6444CE6AE"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | IllegalParam.%s | The param of %s is illegal. | The parameter is invalid. |
| 400 | ResourceNotFound.PhysicalConnectionId | The specified resource of [%s] is not found. | The Express Connect circuit does not exist. |
| 400 | IncorrectStatus.PhysicalConnection | The status of %s [%s] is incorrect. | The status of the physical connection does not support this operation. |
| 400 | IncorrectStatus.PconnMacsec | The status of %s [%s] is incorrect. | The operation is not allowed because the MACSec key is in an unstable state. |
| 400 | ResourceNotFound.PconnMacsec | The specified resource of %s is not found. | The Ckn to be disassociated does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.