すべてのプロダクト
Search

このプロダクト

    VPN Gateway:ModifyVpnAttachmentAttribute

    ドキュメントセンター

    VPN Gateway:ModifyVpnAttachmentAttribute

    最終更新日:Aug 10, 2026

    IPsec-VPN 接続の構成を変更します。

    操作説明

    • デュアルトンネル IPsec-VPN 接続を変更する場合、必須パラメーターに加えて、次のリクエストパラメーターがサポートされています：ClientToken、Name、LocalSubnet、RemoteSubnet、EffectImmediately、TunnelOptionsSpecification 配列、および EnableTunnelsBgp。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vpc:ModifyVpnAttachmentAttribute

    update

    *VpnConnections

    acs:vpc:{#regionId}:{#accountId}:vpnconnection/{#VpnConnectionId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    IPsec-VPN 接続のリージョン ID。

    DescribeRegions オペレーションを呼び出して、リージョン ID を照会できます。

    cn-hangzhou
    VpnConnectionId

    string

    必須

    IPsec-VPN 接続の ID。

    vco-p0w5112fgnl2ihlmf****
    Name

    string

    任意

    IPsec-VPN 接続の名前。

    名前は 1～100 文字で、http:// または https:// で始まることはできません。

    nametest
    LocalSubnet

    string

    任意

    オンプレミスデータセンターと通信する必要がある VPC 側の CIDR ブロック。位相 2 のネゴシエーションに使用されます。

    複数の CIDR ブロックを指定する場合は、カンマ (,) で区切ります。例: 192.168.1.0/24,192.168.2.0/24。

    IPsec-VPN 接続のルーティングモードの説明:

    • LocalSubnet と RemoteSubnet の両方が 0.0.0.0/0 に設定されている場合、宛先ルーティングモードが使用されます。

    • LocalSubnet と RemoteSubnet の両方が特定の CIDR ブロックに設定されている場合、保護データフローモードが使用されます。

    10.1.1.0/24,10.1.2.0/24
    RemoteSubnet

    string

    任意

    VPC と通信する必要があるオンプレミスデータセンター側の CIDR ブロック。このパラメーターは位相 2 ネゴシエーションに使用されます。

    10.1.3.0/24,10.1.4.0/24
    EffectImmediately

    boolean

    任意

    IPsec-VPN 接続の構成をすぐに効果があるかどうかを指定します。有効な値:

    false
    IkeConfig

    string

    任意

    このパラメーターは、シングルトンネル IPsec-VPN 接続を変更する場合にサポートされます。

    {"Psk":"1234****","IkeVersion":"ikev1","IkeMode":"main","IkeEncAlg":"aes","IkeAuthAlg":"sha1","IkePfs":"group2","IkeLifetime":86400,"LocalId":"47.XX.XX.1","RemoteId":"47.XX.XX.2"}
    IpsecConfig

    string

    任意

    このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を変更する場合にサポートされます。

    位相 2 ネゴシエーションの構成:

    • IpsecConfig.IpsecEncAlg: 位相 2 ネゴシエーションで使用される暗号化アルゴリズム。有効な値: aes、aes192、aes256、des、3des。

    • IpsecConfig.IpsecAuthAlg: 位相 2 ネゴシエーションで使用される認証アルゴリズム。有効な値: md5、sha1、sha256、sha384、sha512。

    • IpsecConfig.IpsecPfs: 位相 2 ネゴシエーションで使用される Diffie-Hellman キー交換アルゴリズム。有効な値: disabled、group1、group2、group5、group14。

    • IpsecConfig.IpsecLifetime: 位相 2 でネゴシエートされる SA の有効期間。単位: 秒。有効な値: 0 ～ 86400。

    {"IpsecEncAlg":"aes","IpsecAuthAlg":"sha1","IpsecPfs":"group2","IpsecLifetime":86400}
    BgpConfig

    string

    任意

    このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を変更する場合にサポートされます。

    BGP 構成:

    • BgpConfig.EnableBgp: BGP を有効にするかどうかを指定します。有効な値:

      • true: BGP を有効にします。

      • false: BGP を無効にします。

    • BgpConfig.LocalAsn: Alibaba Cloud 側の自律システム番号 (ASN)。有効な値: 1 ～ 4294967295。

      ASN を 2 セグメント表記で入力できます: 上位 16 ビット.下位 16 ビット。各セグメントは 10 進数形式で入力します。

      たとえば、123.456 と入力した場合、ASN は 123 × 65536 + 456 = 8061384 となります。

    • BgpConfig.TunnelCidr: IPsec トンネルの CIDR ブロック。CIDR ブロックは 169.254.0.0/16 内の /30 CIDR ブロックである必要があり、169.254.0.0/30、169.254.1.0/30、169.254.2.0/30、169.254.3.0/30、169.254.4.0/30、169.254.5.0/30、169.254.6.0/30、または 169.254.169.252/30 は使用できません。

    • LocalBgpIp: Alibaba Cloud 側の BGP IP アドレス。このアドレスは、IPsec トンネルの CIDR ブロック内の IP アドレスである必要があります。

    説明

    • BGP を構成する前に、BGP 動的ルートの仕組みとその制限について理解しておくことを推奨します。詳細については、「BGP 動的ルートの構成」をご参照ください。

    • Alibaba Cloud との BGP 接続を確立するには、プライベート ASN を使用することを推奨します。プライベート ASN の範囲については、関連ドキュメントをご参照ください。

    {"EnableBgp":"true","LocalAsn":"45104","TunnelCidr":"169.254.11.0/30","LocalBgpIp":"169.254.11.1"}
    HealthCheckConfig

    string

    任意

    このパラメーターは、シングルトンネル IPsec-VPN 接続を変更する場合にサポートされます。

    {"enable":"true","dip":"192.168.1.1","sip":"10.1.1.1","interval":"3","retry":"3","Policy": "revoke_route"}
    AutoConfigRoute

    boolean

    任意

    ルートを自動的に設定するかどうかを指定します。有効な値:

    • true: ルートを自動的に設定します。

    • false: ルートを自動的に設定しません。

    true
    EnableDpd

    boolean

    任意

    このパラメーターは、単一トンネル IPsec-VPN 接続を変更する際にサポートされます。

    Dead Peer Detection (DPD) 機能を有効にするかどうかを指定します。有効な値:

    • true: DPD 機能を有効にします。IPsec イニシエーターが DPD パケットを送信して、ピアデバイスの生存を確認します。指定された時間内に正しい応答を受信しない場合、ピアは切断されたとみなされます。ISAKMP SA および対応する IPsec SA が削除され、セキュリティトンネルも削除されます。

    • false: DPD 機能を無効にします。IPsec イニシエーターは DPD プローブパケットを送信しません。

    true
    EnableNatTraversal

    boolean

    任意

    このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を変更する場合にサポートされます。

    NAT 越えを有効にするかどうかを指定します。有効な値:

    • true: NAT 越えを有効にします。NAT 越えを有効にすると、IKE ネゴシエーションプロセスで UDP ポート番号の検証がスキップされ、VPN トンネル内の NAT ゲートウェイデバイスを検出できます。

    • false: NAT 越えを無効にします。

    true
    RemoteCaCert

    string

    任意

    ピアの CA 証明書。

    -----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----
    ClientToken

    string

    任意

    リクエストのべき等性を確保するために使用されるクライアントトークン。

    クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用できます。

    説明

    このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。各 API リクエストの RequestId は異なります。

    123e4567-e89b-12d3-a456-4266****
    NetworkType

    string

    任意

    IPsec-VPN 接続のネットワークタイプ。有効な値:

    • public: IPsec-VPN 接続は、インターネット経由で暗号化された通信チャネルを確立します。

    • private: IPsec-VPN 接続は、プライベートネットワーク経由で暗号化された通信チャネルを確立します。

    public
    CustomerGatewayId

    string

    任意

    IPsec-VPN 接続に関連付けられたカスタマーゲートウェイインスタンス。

    cgw-p0w2jemrcj5u61un8****
    TunnelOptionsSpecification

    array<object>

    任意

    トンネルの構成。

    TunnelOptionsSpecification 配列内のパラメーターは、デュアルトンネルモードの IPsec-VPN 接続を変更する場合にのみサポートされます。IPsec-VPN 接続の両方のトンネルの構成を同時に変更できます。

    array<object>

    任意

    トンネル構成情報のフォーマット。

    TunnelId

    string

    任意

    トンネル ID。

    tun-0jod7plwf2a0o9lvu****
    CustomerGatewayId

    string

    任意

    トンネルに関連付けられたカスタマーゲートウェイの ID。

    cgw-p0w2jemrcj5u61un8****
    TunnelIndex

    integer

    任意

    トンネルの作成注文。

    1
    EnableDpd

    boolean

    任意

    トンネルの Dead Peer Detection (DPD) 特徴を有効にするかどうかを指定します。有効な値:

    true
    EnableNatTraversal

    boolean

    任意

    トンネルの NAT 越えを有効にするかどうかを指定します。有効な値:

    • true: NAT 越えを有効にします。NAT 越えを有効にすると、IKE ネゴシエーションプロセスで UDP ポート番号の検証がスキップされ、トンネル沿いの NAT ゲートウェイデバイスを検出できます。

    • false: NAT 越えを無効にします。

    true
    TunnelBgpConfig

    object

    任意

    トンネルの BGP 設定を追加します。

    説明

    IPsec-VPN 接続で BGP を有効にした後 (つまり、EnableTunnelsBgp を true に設定した後) に、このパラメーターを設定してください。

    LocalAsn

    integer

    任意

    トンネルの Alibaba Cloud 側の自律システム番号 (ASN)。有効な値: 1 ～ 4294967295。デフォルト値: 45104。

    説明

    Alibaba Cloud との BGP 接続を確立するには、プライベート ASN を使用してください。プライベート ASN の範囲については、関連ドキュメントを参照してください。

    65530
    LocalBgpIp

    string

    任意

    Alibaba Cloud 側の BGP アドレス。このアドレスは BGP CIDR ブロック内の IP アドレスです。

    169.254.10.1
    TunnelCidr

    string

    任意

    トンネルの BGP CIDR ブロック。CIDR ブロックは 169.254.0.0/16 内のプレフィックス長 30 の CIDR ブロックである必要があり、169.254.0.0/30、169.254.1.0/30、169.254.2.0/30、169.254.3.0/30、169.254.4.0/30、169.254.5.0/30、169.254.6.0/30、または 169.254.169.252/30 は使用できません。

    169.254.10.0/30
    TunnelIkeConfig

    object

    任意

    位相 1 ネゴシエーション構成。

    IkeAuthAlg

    string

    任意

    位相 1 ネゴシエーションの認証アルゴリズム。有効な値: md5、sha1、sha256、sha384、sha512。

    sha1
    IkeEncAlg

    string

    任意

    位相 1 ネゴシエーションの暗号化アルゴリズム。有効な値: aes、aes192、aes256、des、3des。

    aes
    IkeLifetime

    integer

    任意

    位相 1 ネゴシエーションによって生成される SA の時間。単位: 秒。

    86400
    IkeMode

    string

    任意

    IKE バージョンのネゴシエーションモード。有効な値: main、aggressive。

    • main: メインモード。ネゴシエーションプロセスのセキュリティが高いです。

    • aggressive: アグレッシブモード。ネゴシエーションが高速で、成功率が高いです。

    main
    IkePfs

    string

    任意

    第 1 フェーズのネゴシエーションで使用される Diffie-Hellman キー交換アルゴリズム。

    有効な値: group1、group2、group5、group14。

    group2
    IkeVersion

    string

    任意

    IKE プロトコルのバージョン。有効な値: ikev1 および ikev2。

    ikev2
    LocalId

    string

    任意

    トンネルの Alibaba Cloud 側の識別子で、位相 1 ネゴシエーションに使用されます。値の長さは最大 100 文字で、スペースを含めることはできません。

    47.XX.XX.1
    Psk

    string

    任意

    事前共有鍵。トンネルとトンネルピア間の身分認証に使用されます。

    • 鍵の長さは 1～100 文字で、数字、大文字、小文字、および以下の文字を含めることができます。スペースは含めることができません。~!\`@#$%^&*()_-+={}[]|;:',.<>/?

    • 事前共有鍵を指定しない場合、システムが 16 文字の文字列をランダムに生成して事前共有鍵として設定します。 DescribeVpnAttachments を呼び出して、システムによって自動生成された事前共有鍵を照会できます。

    説明

    トンネルとトンネルピアの事前共有鍵は同じである必要があります。異なる場合、トンネルを確立できません。

    123456****
    RemoteId

    string

    任意

    トンネルピアの識別子で、位相 1 ネゴシエーションに使用されます。値の長さは最大 100 文字で、スペースを含めることはできません。

    47.XX.XX.2
    TunnelIpsecConfig

    object

    任意

    位相 2 ネゴシエーション構成。

    IpsecAuthAlg

    string

    任意

    位相 2 ネゴシエーションで使用される認証アルゴリズム。

    有効な値: md5、sha1、sha256、sha384、sha512。

    sha1
    IpsecEncAlg

    string

    任意

    位相 2 ネゴシエーションの暗号化アルゴリズム。有効な値: aes、aes192、aes256、des、3des。

    aes
    IpsecLifetime

    integer

    任意

    位相 2 ネゴシエーションによって生成される SA の時間。単位: 秒。

    86400
    IpsecPfs

    string

    任意

    ネゴシエーションの第 2 段階で使用される Diffie-Hellman キー交換アルゴリズム。

    有効な値: disabled、group1、group2、group5、group14。

    group2
    EnableTunnelsBgp

    boolean

    任意

    このパラメーターは、デュアルトンネルモードの IPsec-VPN 接続を変更する場合にサポートされます。

    トンネルの BGP を有効にするかどうかを指定します。有効な値: true または false。

    説明

    BGP 構成を追加する前に、BGP 動的ルートの動作メカニズムと制限事項を理解しておくことを推奨します。詳細については、「BGP 動的ルートの設定」をご参照ください。

    false

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    VpnConnectionId

    string

    IPsec-VPN 接続の ID。

    vco-p0w5112fgnl2ihlmf****
    CustomerGatewayId

    string

    IPsec-VPN 接続に関連付けられたカスタマーゲートウェイの ID。

    cgw-p0w2jemrcj5u61un8****
    VpnGatewayId

    string

    IPsec-VPN 接続に関連付けられている VPN ゲートウェイインスタンスの ID。

    vpn-not-exist: IPsec-VPN 接続が VPN ゲートウェイインスタンスに関連付けられていません。

    vpn-not-exist
    Name

    string

    IPsec-VPN 接続の名前。

    nametest
    Description

    string

    IPsec-VPN 接続の説明。

    desctest
    LocalSubnet

    string

    オンプレミスデータセンターとの通信が必要な Alibaba Cloud 側の CIDR ブロック (VPC CIDR ブロックなど)。

    10.1.1.0/24,10.1.2.0/24
    RemoteSubnet

    string

    Alibaba Cloud との通信が必要なオンプレミスデータセンター側の CIDR ブロック。

    10.1.3.0/24,10.1.4.0/24
    IkeConfig

    object

    位相 1 ネゴシエーションの構成。

    IkeConfig 配列内のパラメーターは、シングルトンネルモードの IPsec-VPN 接続に対してのみ返されます。

    Psk

    string

    Alibaba Cloud IPsec-VPN 接続とオンプレミスデータセンター間の身分認証に使用される事前共有鍵。

    説明

    IPsec-VPN 接続側の事前共有鍵は、オンプレミスデータセンター側の認証キーと同じである必要があります。異なる場合、オンプレミスデータセンターと VPN ゲートウェイ間の接続を確立できません。

    1234***
    IkeVersion

    string

    IKE プロトコルのバージョン。

    • ikev1

    • ikev2

    IKEv2 は IKEv1 と比較して、SA ネゴシエーションプロセスを簡素化し、マルチ CIDR ブロックシナリオに対するサポートが強化されています。

    ikev1
    IkeMode

    string

    IKE ネゴシエーションモード。

    • main: メインモード。ネゴシエーションプロセスは高いセキュリティを提供します。

    • aggressive: アグレッシブモード。ネゴシエーションが高速で、成功率が高くなります。

    main
    IkeEncAlg

    string

    位相 1 ネゴシエーションの暗号化アルゴリズム。

    aes
    IkeAuthAlg

    string

    位相 1 ネゴシエーションの認証アルゴリズム。

    sha1
    IkePfs

    string

    位相 1 ネゴシエーションで使用される Diffie-Hellman キー交換アルゴリズム。

    グループ2
    IkeLifetime

    integer

    位相 1 ネゴシエーションによって生成された SA の有効期間。単位: 秒。

    86400
    LocalId

    string

    IPsec-VPN 接続の Alibaba Cloud 側の識別子。

    47.XX.XX.1
    RemoteId

    string

    IPsec-VPN 接続のオンプレミスデータセンター側の識別子。

    47.XX.XX.2
    IpsecConfig

    object

    位相 2 ネゴシエーションの構成。

    IpsecConfig 配列内のパラメーターは、シングルトンネルモードの IPsec-VPN 接続に対してのみ返されます。

    IpsecEncAlg

    string

    位相 2 ネゴシエーションの暗号化アルゴリズム。

    aes
    IpsecAuthAlg

    string

    位相 2 ネゴシエーションの認証アルゴリズム。

    md5
    IpsecPfs

    string

    位相 2 ネゴシエーションで使用される Diffie-Hellman キー交換アルゴリズム。

    グループ2
    IpsecLifetime

    integer

    位相 2 ネゴシエーションによって生成された SA の有効期間。単位: 秒。

    86400
    CreateTime

    integer

    IPsec-VPN 接続が作成されたタイムスタンプ。単位: ミリ秒。

    このタイムスタンプは UNIX タイムスタンプ形式で、1970 年 1 月 1 日 00:00:00 (UTC) から IPsec-VPN 接続が作成された時刻までに経過したミリ秒の総数を表します。

    1658201810000
    EffectImmediately

    boolean

    IPsec-VPN 接続構成がすぐに効果を発揮するかどうかを示します。

    false
    Status

    string

    IPsec-VPN 接続のステータス。

    • ike_sa_not_established: 位相 1 のネゴシエーションに失敗しました。

    • ike_sa_established: 位相 1 のネゴシエーションに成功しました。

    • ipsec_sa_not_established: 位相 2 のネゴシエーションに失敗しました。

    • ipsec_sa_established: 位相 2 のネゴシエーションに成功しました。

    ike_sa_not_established
    VcoHealthCheck

    object

    IPsec-VPN 接続のヘルスチェック構成。

    VcoHealthCheck 配列内のパラメーターは、シングルトンネルモードの IPsec-VPN 接続に対してのみ返されます。

    Enable

    string

    IPsec-VPN 接続のヘルスチェック特徴が有効かどうかを示します。

    true
    Sip

    string

    ヘルスチェックのソース IP アドレス。

    10.1.1.1
    Dip

    string

    ヘルスチェックの送信先 IP アドレス。

    192.168.1.1
    Interval

    integer

    ヘルスチェックの再試行間隔。単位: 秒。

    3
    Retry

    integer

    ヘルスチェックのために送信されるリトライパケットの数。

    3
    Policy

    string

    ヘルスチェックの失敗時に公開されたルートを撤回するかどうかを指定します。

    • revoke_route: 公開されたルートを撤回します。

    • reserve_route: 公開されたルートを撤回しません。

    revoke_ルート
    EnableDpd

    boolean

    IPsec-VPN 接続で Dead Peer Detection (DPD) 機能が有効かどうかを示します。

    • true: 有効です。

    • false: 無効です。

    このパラメーターは、シングルトンネルモードの IPsec-VPN 接続に対してのみ返されます。

    true
    EnableNatTraversal

    boolean

    IPsec-VPN 接続で NAT 越えが有効かどうかを示します。

    • true: 有効です。

    • false: 無効です。

    このパラメーターは、シングルトンネルモードの IPsec-VPN 接続に対してのみ返されます。

    true
    VpnBgpConfig

    object

    IPsec-VPN 接続の BGP 構成。

    EnableBgp

    string

    IPsec-VPN 接続で BGP 機能が有効かどうかを示します。

    true
    TunnelCidr

    string

    IPsec トンネルの CIDR ブロック。

    169.254.11.0/30
    LocalBgpIp

    string

    Alibaba Cloud 側の BGP IP アドレス。

    169.254.11.1
    PeerBgpIp

    string

    オンプレミスデータセンター側の BGP IP アドレス。

    169.254.11.2
    LocalAsn

    integer

    Alibaba Cloud 側の自律システム番号。

    45104
    PeerAsn

    integer

    オンプレミスデータセンター側の自律システム番号。

    65535
    Status

    string

    BGP ネゴシエーションステータス。

    false
    AttachType

    string

    IPsec-VPN 接続に関連付けられたリソースのタイプ。

    CEN
    NetworkType

    string

    IPsec-VPN 接続のネットワークタイプ。

    public
    AttachInstanceId

    string

    IPsec-VPN 接続にアタッチされた転送ルーティング vRouter インスタンスが属する Cloud Enterprise Network (CEN) インスタンスのインスタンス ID。

    cen-c2r3m3zxkumoqz****
    Spec

    string

    IPsec-VPN 接続の帯域幅スペック。

    1000M
    ResourceGroupId

    string

    IPsec-VPN 接続が属するリソースグループの ID。

    ListResourceGroups オペレーションを呼び出して、リソースグループ情報を照会できます。

    rg-acfmzs372yg****
    TunnelOptionsSpecification

    array<object>

    IPsec-VPN 接続のトンネル構成。

    array<object>

    トンネル構成情報のフォーマット。

    CustomerGatewayId

    string

    トンネルに関連付けられたカスタマーゲートウェイの ID。

    cgw-p0w2jemrcj5u61un8****
    EnableDpd

    boolean

    トンネルで DPD 機能が有効かどうかを示します。

    true
    EnableNatTraversal

    boolean

    トンネルで NAT 越え機能が有効かどうかを示します。

    true
    InternetIp

    string

    トンネルの Alibaba Cloud 側のゲートウェイ IP アドレス。

    47.XX.XX.66
    Role

    string

    トンネルのロール。

    master
    TunnelId

    string

    トンネル ID。

    tun-0jod7plwf2a0o9lvu****
    TunnelIndex

    integer

    トンネルの作成注文。

    1
    State

    string

    トンネルのステータス。

    • active: 正常。

    • updating: 更新中。

    • deleting: 削除中。

    アクティブな
    TunnelBgpConfig

    object

    トンネルの BGP 構成。

    LocalAsn

    integer

    トンネルのローカルエンド (Alibaba Cloud 側) の自律システム番号。 [_single.resp.200.props.TunnelOptionsSpecification.items.TunnelBgpConfig.LocalBgpI

    65530
    LocalBgpIp

    string

    トンネルの Alibaba Cloud 側の BGP アドレス。 [responses.200.schema.properties.TunnelOptionsSpecification.items.properties.TunnelBgpConfig.properties.P

    169.254.10.1
    PeerAsn

    integer

    The autonomous system number of the tunnel peer.

    65531
    PeerBgpIp

    string

    The BGP address of the tunnel peer.

    169.254.10.2
    TunnelCidr

    string

    The BGP CIDR block of the tunnel.

    169.254.10.0/30
    TunnelIkeConfig

    object

    位相 1 ネゴシエーション構成。

    IkeAuthAlg

    string

    The authentication algorithm in the IKE phase.

    sha1
    IkeEncAlg

    string

    The encryption algorithm in the IKE phase.

    aes
    IkeLifetime

    integer

    The lifetime in the IKE phase. Unit: seconds.

    86400
    IkeMode

    string

    The negotiation mode of the IKE version. Valid values:

    • main: Main mode. This mode offers high negotiation security.

    • aggressive: Aggressive mode. This mode supports fast negotiation and a higher success rate.

    main
    IkePfs

    string

    The DH group in the IKE phase.

    group2
    IkeVersion

    string

    The IKE protocol version.

    ikev2
    LocalId

    string

    The identifier on the Alibaba Cloud side of the tunnel.

    47.XX.XX.1
    Psk

    string

    The pre-shared key.

    123456****
    RemoteId

    string

    The identifier of the tunnel peer.

    47.XX.XX.2
    TunnelIpsecConfig

    object

    位相 2 ネゴシエーション構成。

    IpsecAuthAlg

    string

    The authentication algorithm in the IPsec phase.

    sha1
    IpsecEncAlg

    string

    The encryption algorithm in the IPsec phase.

    aes
    IpsecLifetime

    integer

    The lifetime in the IPsec phase. Unit: seconds.

    86400
    IpsecPfs

    string

    The DH group in the IPsec phase.

    group2
    EnableTunnelsBgp

    boolean

    トンネルの BGP ステータス。

    • true: 有効。

    • false: 無効。

    このパラメーターは、デュアルトンネルモードの IPsec-VPN 接続に対してのみ返されます。

    false
    RequestId

    string

    リクエスト ID。

    35822A84-867F-3936-A2E6-A4C4E3ED11C0

    例

    成功レスポンス

    JSONJSON

    {
  "VpnConnectionId": "vco-p0w5112fgnl2ihlmf****",
  "CustomerGatewayId": "cgw-p0w2jemrcj5u61un8****",
  "VpnGatewayId": "vpn-not-exist",
  "Name": "nametest",
  "Description": "desctest",
  "LocalSubnet": "10.1.1.0/24,10.1.2.0/24",
  "RemoteSubnet": "10.1.3.0/24,10.1.4.0/24",
  "IkeConfig": {
    "Psk": "1234***",
    "IkeVersion": "ikev1",
    "IkeMode": "main",
    "IkeEncAlg": "aes",
    "IkeAuthAlg": "sha1",
    "IkePfs": "group2",
    "IkeLifetime": 86400,
    "LocalId": "47.XX.XX.1",
    "RemoteId": "47.XX.XX.2"
  },
  "IpsecConfig": {
    "IpsecEncAlg": "aes",
    "IpsecAuthAlg": "md5",
    "IpsecPfs": "group2",
    "IpsecLifetime": 86400
  },
  "CreateTime": 1658201810000,
  "EffectImmediately": false,
  "Status": "ike_sa_not_established",
  "VcoHealthCheck": {
    "Enable": "true",
    "Sip": "10.1.1.1",
    "Dip": "192.168.1.1",
    "Interval": 3,
    "Retry": 3,
    "Policy": "revoke_route"
  },
  "EnableDpd": true,
  "EnableNatTraversal": true,
  "VpnBgpConfig": {
    "EnableBgp": "true",
    "TunnelCidr": "169.254.11.0/30",
    "LocalBgpIp": "169.254.11.1",
    "PeerBgpIp": "169.254.11.2",
    "LocalAsn": 45104,
    "PeerAsn": 65535,
    "Status": "false"
  },
  "AttachType": "CEN",
  "NetworkType": "public",
  "AttachInstanceId": "cen-c2r3m3zxkumoqz****",
  "Spec": "1000M",
  "ResourceGroupId": "rg-acfmzs372yg****",
  "TunnelOptionsSpecification": [
    {
      "CustomerGatewayId": "cgw-p0w2jemrcj5u61un8****",
      "EnableDpd": true,
      "EnableNatTraversal": true,
      "InternetIp": "47.XX.XX.66",
      "Role": "master",
      "TunnelId": "tun-0jod7plwf2a0o9lvu****",
      "TunnelIndex": 1,
      "State": "active",
      "TunnelBgpConfig": {
        "LocalAsn": 65530,
        "LocalBgpIp": "169.254.10.1",
        "PeerAsn": 65531,
        "PeerBgpIp": "169.254.10.2",
        "TunnelCidr": "169.254.10.0/30"
      },
      "TunnelIkeConfig": {
        "IkeAuthAlg": "sha1",
        "IkeEncAlg": "aes",
        "IkeLifetime": 86400,
        "IkeMode": "main",
        "IkePfs": "group2",
        "IkeVersion": "ikev2",
        "LocalId": "47.XX.XX.1",
        "Psk": "123456****",
        "RemoteId": "47.XX.XX.2"
      },
      "TunnelIpsecConfig": {
        "IpsecAuthAlg": "sha1",
        "IpsecEncAlg": "aes",
        "IpsecLifetime": 86400,
        "IpsecPfs": "group2"
      }
    }
  ],
  "EnableTunnelsBgp": false,
  "RequestId": "35822A84-867F-3936-A2E6-A4C4E3ED11C0"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 VpnConnection.Configuring The specified service is configuring. サービスを設定中です。後でもう一度お試しください。
    400 VpnConnection.FinancialLocked The specified service is financial locked. 支払い遅延のため、指定されたサービスはロック済みです。
    400 InvalidName The name is not valid
    400 VpnRouteEntry.AlreadyExists The specified route entry is already exist. ルートはすでに存在します。
    400 VpnRouteEntry.Conflict The specified route entry has conflict. 指定されたクライアント IP プールが VPN 接続または SSL サーバーと競合しています。
    400 NotSupportVpnConnectionParameter.IpsecPfs The specified vpn connection ipsec Ipsec Pfs is not support. IPsec-VPN 接続で指定された PFS パラメーターはサポートされていません。
    400 NotSupportVpnConnectionParameter.IpsecAuthAlg The specified vpn connection ipsec Auth Alg is not support. IPsec-VPN 接続で指定された認証アルゴリズムはサポートされていません。
    400 VpnRouteEntry.BackupRoute Validate backup route entry failed. アクティブ/スタンバイルートエントリの検証が失敗しました。
    400 VpnRouteEntry.InvalidWeight Invalid route entry weight value. ルートの重み値が無効です。
    400 MissingParameter.TunnelCidr The parameter TunnelCidr is mandatory when BGP is enabled. BGP が有効な場合、トンネル CIDR ブロックパラメーターは必須です。
    400 OperationUnsupported.EnableBgp Current region does not support enable BGP. このリージョンでは BGP の有効化はサポートされていません。
    400 MissingParam.CustomerGatewayAsn Asn of customer gateway is mandatory when BGP is enabled. BGP が有効な場合、カスタマーゲートウェイの自律システム番号を空にすることはできません。
    400 IllegalParam.LocalAsn The specified LocalAsn is invalid. LocalAsn パラメーターが無効です。
    400 IllegalParam.BgpConfig The specified BgpConfig is invalid. 指定された BGP 構成が無効です。
    400 IllegalParam.EnableBgp VPN connection must enable BGP when VPN gateway has enabled BGP. VPN ゲートウェイで BGP が有効になっている場合、VPN 接続でも BGP を有効にする必要があります。
    400 IllegalParam.TunnelCidr The specified TunnelCidr is invalid. TunnelCidr パラメーターが無効です。
    400 InvalidLocalBgpIp.Malformed The specified LocalBgpIp is malformed. 指定されたローカル BGP IP アドレスが無効です。
    400 IllegalParam.LocalBgpIp The specified LocalBgpIp is invalid. ローカル BGP アドレスが無効です。
    400 IllegalParam.LocalSubnet The specified "LocalSubnet" (%s) is invalid. ローカル CIDR ブロック (%s) が無効です。
    400 IllegalParam.RemoteSubnet The specified "RemoteSubnet" (%s) is invalid. ピア CIDR ブロック (%s) が無効です。
    400 CustomerGateway.ConflictRouteEntry The specified customer gateway has conflict with route entry. 現在のカスタマーゲートウェイとルートの間に競合が存在します。
    400 IllegalParam.NetworkType The specified NetworkType (%s) is invalid. 入力された NetworkType が無効です。入力が正しいかどうかを確認してください。
    400 InvalidTunnelCidr.Malformed The specified TunnelCidr is malformed. 指定されたトンネル CIDR ブロックが無効です。
    400 VpnGateway.Configuring The specified service is configuring.
    400 VpnTask.CONFLICT Vpn task has conflict. VPN 操作の競合が存在します。後でもう一度お試しください。
    400 ModifyIkeV1WithMultiRoutes.Invalid Failed to modify VPN connection parameters. Multi-network is configured while using IkeV1 protocol. VPN 接続パラメーターの変更に失敗しました。IKEv1 プロトコル使用時はマルチネットワーク構成はサポートされていません。
    400 InvalidVpnGatewayInstanceId.NotFound The specified vpn gateway instance id does not exist. 指定された VPN ゲートウェイが存在しません。VPN ゲートウェイが正しいかどうかを確認してください。
    400 Resource.QuotaFull The resources you are operating have reached the upper limit of the quota. Please increase the quota or use other solutions to avoid it according to the VPN operation document. 操作中のリソースがクォータ制限に達しました。VPN ドキュメントを参照してクォータを増やすか、代替ソリューションを使用してください。
    400 CreateDbrRoutesQuotaFull.QuotaFull The number of created destination routes exceeds the quota limit. 送信先ルートの数がクォータ制限を超えています。
    400 CreatePbrRoutesQuotaFull.QuotaFull The number of policy routes exceeds the quota limit. ポリシーベースルートの数がクォータ制限を超えています。
    400 EncAlgInvalid.DesIncompatible Des/3des in IkeEncAlg and IpsecEncAlg does not support multi algorithm. DES および 3DES アルゴリズムは、IKE 暗号化アルゴリズムまたは IPsec 暗号化アルゴリズムにおけるマルチアルゴリズム互換性をサポートしていません。
    400 IkeVersionInvalid.GcmIncompatible Ikev1 does not support IkeEncAlg of gcm16. IKEv1 は、IKE 暗号化アルゴリズムとして GCM-128 アルゴリズムのみを設定することをサポートしていません。
    400 CustomerGateway.ConflictVpnIp The specified customer gateway has conflict with vpn gateway ip. カスタマーゲートウェイの IP アドレスが VPN ゲートウェイの IP アドレスと競合しています。
    400 CustomerGateway.AsnNotConfigured ASN of CustomerGateway is required when enabling BGP on an IPSec connection. IPsec-VPN 接続で BGP が有効な場合、カスタマーゲートウェイに ASN を設定する必要があります。
    403 Forbbiden.SubUser User not authorized to operate on the specified resource as your account is created by another user.
    403 Forbidden User not authorized to operate on the specified resource. EIP が現在の呼び出し元に属していません。この EIP を操作する権限があるかどうかを確認してください。
    404 InvalidVpnConnectionInstanceId.NotFound The specified vpn connection instance id does not exist. 指定された VPN 接続が存在しません。VPN 接続 ID が正しいかどうかを確認してください。

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

    変更履歴

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