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 activated 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. |
pc-bp1hp0wr072f6**** |
| Ckn |
string |
Yes |
The key name. Only hexadecimal characters are supported. Lowercase characters are automatically converted to uppercase. When the encryption algorithm type is GCM-AES-128 or GCM-AES-XPN-128, the length must be 32 hexadecimal characters. When the encryption algorithm type is GCM-AES-256 or GCM-AES-XPN-256, the length must be 64 hexadecimal characters. |
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.