Associe une clé MACsec à un port de circuit Express Connect dédié. MACsec utilise des puces de chiffrement dédiées (telles que des cartes réseau ou des commutateurs) pour mettre en œuvre un chiffrement et un déchiffrement à faible latence, en chiffrant directement les liaisons physiques (telles que les fibres optiques ou l'Ethernet) afin de couvrir tout le trafic de l'expéditeur au destinataire.
Description de l'opération
Pour utiliser cette fonctionnalité, les conditions suivantes doivent être remplies :
-
L'équipement sur lequel réside le circuit Express Connect prend en charge la fonctionnalité MACsec.
-
Le paiement du circuit Express Connect doit être effectué.
-
Seuls les circuits Express Connect dédiés sont pris en charge.
Autres remarques :
-
Un maximum de trois paires CKN et CAK peut être configuré.
-
L'association d'une clé actuellement dans l'état Disassociated dissocie la clé précédemment active.
-
L'association d'une clé actuellement dans l'état AssociatedFailed déclenche la renégociation de la session par l'équipement.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| RegionId |
string |
Oui |
L'identifiant de la région du circuit Express Connect. Vous pouvez appeler l'opération DescribeRegions pour interroger les identifiants de région. |
cn-hangzhou |
| PhysicalConnectionId |
string |
Oui |
L'identifiant du circuit Express Connect. Le circuit Express Connect doit être un circuit dédié dont le paiement est effectué, qui prend en charge MACsec et qui est dans l'état Enabled. Vous pouvez appeler DescribePhysicalConnections pour interroger l'état actuel et les capacités de l'équipement. |
pc-bp1hp0wr072f6**** |
| CipherSuite |
string |
Oui |
Le type d'algorithme de chiffrement. Valeurs valides :
|
GCM-AES-128 |
| Ckn |
string |
Oui |
Le nom de la clé. Seuls les caractères hexadécimaux sont pris en charge. Les caractères minuscules sont automatiquement convertis en majuscules. Lorsque le type d'algorithme de chiffrement est GCM-AES-128 ou GCM-AES-XPN-128, la longueur doit être de 32 caractères hexadécimaux. Lorsque le type d'algorithme de chiffrement est GCM-AES-256 ou GCM-AES-XPN-256, la longueur doit être de 64 caractères hexadécimaux. |
0123456789ABCDEF0123456789ABCDEF |
| Cak |
string |
Oui |
La phrase secrète. Seuls les caractères hexadécimaux sont pris en charge. Les caractères minuscules sont automatiquement convertis en majuscules. Lorsque le type d'algorithme de chiffrement est GCM-AES-128 ou GCM-AES-XPN-128, la longueur doit être de 32 caractères hexadécimaux. Lorsque le type d'algorithme de chiffrement est GCM-AES-256 ou GCM-AES-XPN-256, la longueur doit être de 64 caractères hexadécimaux. |
0123456789ABCDEF0123456789ABCDEF |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
|||
| RequestId |
string |
L'identifiant de la requête. |
D32B3C26-6C6C-4988-93E9-D2A6444CE6AE |
Exemples
JSON format
{
"RequestId": "D32B3C26-6C6C-4988-93E9-D2A6444CE6AE"
}Codes d'erreur
|
Code de statut HTTP |
Code d'erreur |
Message d'erreur |
Description |
|---|---|---|---|
| 400 | IllegalParam.%s | The param of %s is illegal. | Le paramètre spécifié n'est pas valide. |
| 400 | ResourceNotFound.PhysicalConnectionId | The specified resource of [%s] is not found. | La connexion physique n'existe pas. |
| 400 | IncorrectStatus.PhysicalConnection | The status of %s [%s] is incorrect. | L'état du circuit Express Connect ne permet pas cette opération. |
| 400 | UnsupportedFeature.Macsec | The feature of Macsec is not supported. | Le circuit Express Connect actuel ne prend pas en charge la fonction MACsec. |
| 400 | IncorrectStatus.PconnMacsec | The status of %s [%s] is incorrect. | L'opération n'est pas autorisée car une clé MACsec est dans un état non stable. |
| 400 | QuotaExceeded.PconnMacsec | The quota of PconnMacsec is exceeded, usage 3/3. | Un maximum de trois groupes de clés MACsec peut être associé à un seul circuit Express Connect. |
| 400 | UnsupportedFeature.Macsec.CipherSuite | The feature of Macsec.CipherSuite is not supported. | Le circuit Express Connect actuel prend en charge MACsec, mais ne prend pas en charge l'algorithme de chiffrement sélectionné. |
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.