すべてのプロダクト
Search

このプロダクト

    Express Connect:AssociateMacSecKey

    ドキュメントセンター

    Express Connect:AssociateMacSecKey

    最終更新日:Apr 27, 2026

    この操作は、専用物理接続のポートに MacSec キーを関連付けます。NIC やスイッチなどの専用暗号化ハードウェアを使用して、低遅延での暗号化および復号を実行します。光ファイバーケーブルやイーサネットケーブルなどの物理リンクを直接暗号化し、送信者から受信者へのすべてのトラフィックを保護します。

    操作説明

    この操作には、以下の前提条件があります。

    • Express Connect 物理接続をホストするデバイスが MacSec 機能をサポートしていること。

    • Express Connect 物理接続の料金が完全に支払済みであること。

    • MacSec は専用物理接続でのみ設定可能です。

    以下の点にご注意ください。

    • Ckn および Cak のセットは最大 3 組まで設定できます。

    • 「未関連付け (Disassociated)」状態のキーを関連付けると、システムは以前アクティブだったキーの関連付けを解除します。

    • 「関連付け失敗 (AssociatedFailed)」状態のキーを関連付けると、デバイスがセッションを再ネゴシエートします。

    今すぐお試しください

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

    テスト

    RAM 認証

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

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    Express Connect 物理接続のリージョン ID です。

    DescribeRegions 操作を呼び出して、リージョン ID を取得できます。

    cn-hangzhou
    PhysicalConnectionId

    string

    必須

    Express Connect 物理接続の ID です。

    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 文字、GCM-AES-256 または GCM-AES-XPN-256 の場合は 64 文字の 16 進数文字が必要です。

    0123456789ABCDEF0123456789ABCDEF
    Cak

    string

    必須

    シークレットキーです。このパラメーターには 16 進数文字のみを指定できます。小文字は自動的に大文字に変換されます。暗号スイートによって、シークレットキーに必要な長さが異なります。GCM-AES-128 または GCM-AES-XPN-128 の場合は 32 文字、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.
    400 UnsupportedFeature.Macsec The feature of Macsec is not supported.
    400 IncorrectStatus.PconnMacsec The status of %s [%s] is incorrect.
    400 QuotaExceeded.PconnMacsec The quota of PconnMacsec is exceeded, usage 3/3.
    400 UnsupportedFeature.Macsec.CipherSuite The feature of Macsec.CipherSuite is not supported.

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

    変更履歴

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