AssociateMacSecKey - Express Connect - Alibaba Cloud ドキュメントセンター

専用 Express Connect 回線ポートに MACsec キーを関連付けます。MACsec は、専用の暗号化チップ (NIC やスイッチなど) を使用して低レイテンシーの暗号化と復号を実装し、物理リンク (光ファイバーやイーサネットなど) を直接暗号化して、送信者から受信者へのすべてのトラフィックを保護します。

操作説明

この機能を使用するには、次の条件を満たす必要があります。

Express Connect 回線が設置されているデバイスが MACsec 機能をサポートしている必要があります。
Express Connect 回線の支払いが完了している必要があります。
専用 Express Connect 回線のみがサポートされます。

その他の注意事項：

最大 3 つの CKN と CAK のペアを設定できます。
現在 Disassociated 状態のキーを関連付けると、以前にアクティブだったキーの関連付けが解除されます。
現在 AssociatedFailed 状態のキーを関連付けると、デバイスがセッションの再ネゴシエーションをトリガーします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	Express Connect 回線が存在するリージョンの ID です。 DescribeRegions API を呼び出して、リージョン ID を照会できます。	cn-hangzhou
PhysicalConnectionId	string	必須	Express Connect 回線の ID です。Express Connect 回線は、支払いが完了し、MACsec をサポートし、Enabled 状態である専用回線である必要があります。DescribePhysicalConnections を呼び出して、現在のステータスとデバイスの機能を確認できます。	pc-bp1hp0wr072f6****
CipherSuite	string	必須	暗号スイートです。有効な値： GCM-AES-128 GCM-AES-XPN-128 GCM-AES-256 GCM-AES-XPN-256	GCM-AES-128
Ckn	string	必須	キー名です。16 進文字のみ使用できます。小文字は自動的に大文字に変換されます。暗号化アルゴリズムが GCM-AES-128 または GCM-AES-XPN-128 の場合、長さは 32 桁の 16 進文字である必要があります。暗号化アルゴリズムが GCM-AES-256 または GCM-AES-XPN-256 の場合、長さは 64 桁の 16 進文字である必要があります。	0123456789ABCDEF0123456789ABCDEF
Cak	string	必須	パスフレーズです。16 進文字のみ使用できます。小文字は自動的に大文字に変換されます。暗号化アルゴリズムが GCM-AES-128 または GCM-AES-XPN-128 の場合、長さは 32 桁の 16 進文字である必要があります。暗号化アルゴリズムが GCM-AES-256 または GCM-AES-XPN-256 の場合、長さは 64 桁の 16 進文字である必要があります。	0123456789ABCDEF0123456789ABCDEF

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーターです。
RequestId	string	リクエスト ID です。	D32B3C26-6C6C-4988-93E9-D2A6444CE6AE

例

成功レスポンス

JSONJSON

{
  "RequestId": "D32B3C26-6C6C-4988-93E9-D2A6444CE6AE"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	IllegalParam.%s	The param of %s is illegal.	指定されたパラメーターが無効です。
400	ResourceNotFound.PhysicalConnectionId	The specified resource of [%s] is not found.	物理接続が存在しません。
400	IncorrectStatus.PhysicalConnection	The status of %s [%s] is incorrect.	Express Connect 回線のステータスでは、この操作はサポートされていません。
400	UnsupportedFeature.Macsec	The feature of Macsec is not supported.	現在の Express Connect 回線は MACsec 機能をサポートしていません。
400	IncorrectStatus.PconnMacsec	The status of %s [%s] is incorrect.	MACsec キーが非安定状態にあるため、この操作は許可されていません。
400	QuotaExceeded.PconnMacsec	The quota of PconnMacsec is exceeded, usage 3/3.	単一の Express Connect 回線に関連付けられる MACsec キーグループは最大値 3 つまでです。
400	UnsupportedFeature.Macsec.CipherSuite	The feature of Macsec.CipherSuite is not supported.	現在の Express Connect 回線は MACsec をサポートしていますが、選択された暗号化アルゴリズムはサポートしていません。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。