CreateVpnConnection 操作を呼び出して IPsec-VPN 接続を作成します。
操作説明
VPN ゲートウェイインスタンスがデュアルトンネルモードでの IPsec-VPN 接続の作成をサポートしている場合、
CreateVpnConnection操作は必須パラメーターに加えて以下のリクエストパラメーターをサポートします。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vpc:CreateVpnConnection |
create |
*CustomerGateway。
*VpnConnection。
*VpnGateway。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
IPsec-VPN 接続のリージョン ID。最新のリージョンリストをクエリするには、 DescribeRegions を呼び出せます。 |
cn-shanghai |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用できます。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。各 API リクエストの RequestId は異なります。 |
02fb3da4-130e-11e9-8e44-001**** |
| CustomerGatewayId |
string |
任意 |
このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を作成する場合にサポートされ、必須です。 |
cgw-p0w2jemrcj5u61un8**** |
| VpnGatewayId |
string |
必須 |
VPN ゲートウェイのインスタンス ID。 |
vpn-bp1q8bgx4xnkm**** |
| Name |
string |
任意 |
IPsec-VPN 接続の名前。 名前の長さは 1~100 文字で、先頭を |
IPsec |
| LocalSubnet |
string |
必須 |
オンプレミスデータセンターと通信する必要がある VPC 側の CIDR ブロック。位相 2 ネゴシエーションに使用されます。 複数の CIDR ブロックを指定する場合は、カンマ (,) で区切ります。例: 192.168.1.0/24,192.168.2.0/24。 IPsec-VPN 接続のルーティングモードの説明:
|
10.10.1.0/24,10.10.2.0/24 |
| RemoteSubnet |
string |
必須 |
VPC と通信する必要のあるオンプレミスデータセンターの CIDR ブロック。これは位相 2 ネゴシエーションに使用されます。 複数の CIDR ブロックを指定する場合は、カンマ (,) で区切ります。例: 192.168.3.0/24,192.168.4.0/24。 IPsec-VPN 接続のルーティングモードの説明:
|
10.10.3.0/24,10.10.4.0/24 |
| EffectImmediately |
boolean |
任意 |
IPsec-VPN 接続構成がすぐに効果を発揮するかどうかを指定します。有効な値: |
false |
| IkeConfig |
string |
任意 |
このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を作成する場合にサポートされます。 フェーズ 1 ネゴシエーション設定:
|
{"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 ネゴシエーション設定:
|
{"IpsecEncAlg":"aes","IpsecAuthAlg":"sha1","IpsecPfs":"group2","IpsecLifetime":86400} |
| HealthCheckConfig |
string |
任意 |
このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を作成する場合にサポートされます。 ヘルスチェック設定:
|
{"enable":"有効","dip":"192.168.10.1","sip":"10.10.1.1","interval":"間隔","retry":"リトライ"} |
| AutoConfigRoute |
boolean |
任意 |
ルートを自動的に設定するかどうかを指定します。有効な値:
|
true |
| EnableDpd |
boolean |
任意 |
このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を作成する場合にサポートされます。 Dead Peer Detection (DPD) 機能を有効にするかどうかを指定します。有効な値:
|
true |
| EnableNatTraversal |
boolean |
任意 |
このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を作成する場合にサポートされます。 NAT 越えを有効にするかどうかを指定します。有効な値:
|
true |
| BgpConfig |
string |
任意 |
このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を作成する場合にサポートされます。 BGP 設定:
説明
|
{"EnableBgp":"true","LocalAsn":"45104","TunnelCidr":"169.254.11.0/30","LocalBgpIp":"169.254.11.1"} |
| RemoteCaCertificate |
string |
任意 |
このパラメーターは、シングルトンネルモードで IPsec-VPN 接続を作成する場合にサポートされます。 |
-----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE----- |
| Tags |
array<object> |
任意 |
IPsec-VPN 接続に追加するタグのリスト。 |
|
|
object |
任意 |
タグ情報のフォーマット。 |
||
| Key |
string |
任意 |
タグキー。この値は空文字列にできません。 タグキーの長さは最大 64 文字です。 一度に最大 20 個のタグキーを指定できます。 |
TagKey |
| Value |
string |
任意 |
タグ値。 タグ値の長さは最大 128 文字で、空文字列も指定できます。 各タグキーには 1 つのタグ値が対応します。一度に最大 20 個のタグ値を指定できます。 |
TagValue |
| TunnelOptionsSpecification |
array<object> |
任意 |
トンネル構成。 |
|
|
array<object> |
任意 |
トンネル構成情報のフォーマット。 |
||
| CustomerGatewayId |
string |
任意 |
トンネルに関連付けられたカスタマーゲートウェイの ID。 |
cgw-p0wy363lucf1uyae8**** |
| EnableDpd |
boolean |
任意 |
トンネルの Dead Peer Detection (DPD) 機能を有効にするかどうかを指定します。有効な値:
|
true |
| EnableNatTraversal |
boolean |
任意 |
トンネルの NAT 越えを有効にするかどうかを指定します。有効な値:
|
true |
| RemoteCaCertificate |
string |
任意 |
現在の VPN ゲートウェイインスタンスが中国 SM ベースの VPN ゲートウェイである場合、トンネルのピア CA 証明書を設定する必要があります。 |
-----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE----- |
| Role |
string |
任意 |
トンネルのロール。有効な値: |
master |
| TunnelBgpConfig |
object |
任意 |
トンネルの BGP 構成。 |
|
| LocalAsn |
integer |
任意 |
トンネルの Alibaba Cloud 側の自律システム番号 (ASN)。有効な値: 1 ~ 4294967295。デフォルト値: 45104。 説明
|
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 は指定できません。 説明
VPN ゲートウェイインスタンス内では、各トンネルの BGP CIDR ブロックは一意である必要があります。 |
169.254.10.0/30 |
| TunnelIkeConfig |
object |
任意 |
位相 1 ネゴシエーション構成。 |
|
| IkeAuthAlg |
string |
任意 |
位相 1 ネゴシエーションで使用される認証アルゴリズム。 有効な値: md5、sha1、sha256、sha384、sha512。デフォルト値: md5。 |
md5 |
| IkeEncAlg |
string |
任意 |
位相 1 ネゴシエーションで使用される暗号化アルゴリズム。 有効な値: aes、aes192、aes256、des、または 3des。デフォルト値: aes。 |
aes |
| IkeLifetime |
integer |
任意 |
フェーズ 1 でネゴシエートされるセキュリティアソシエーション (SA) の有効期間。単位: 秒。 有効な値: 0 ~ 86400。デフォルト値: 86400。 |
86400 |
| IkeMode |
string |
任意 |
IKE バージョンのネゴシエーションモード。有効な値: main または aggressive。デフォルト値: main。
|
main |
| IkePfs |
string |
任意 |
第 1 位相ネゴシエーションで使用される Diffie-Hellman キー交換アルゴリズム。デフォルト値: group2。 |
group2 |
| IkeVersion |
string |
任意 |
IKE プロトコルのバージョン。有効な値: ikev1 または ikev2。デフォルト値: ikev1。 IKEv2 は IKEv1 と比較して、SA ネゴシエーションプロセスを簡素化し、マルチ CIDR ブロックシナリオに対するサポートが強化されています。 |
ikev1 |
| LocalId |
string |
任意 |
トンネルのローカルエンド (Alibaba Cloud 側) の識別子で、位相 1 ネゴシエーションに使用されます。値の長さは最大 100 文字で、スペースを含めることはできません。デフォルト値はトンネルの IP アドレスです。 |
47.21.XX.XX |
| Psk |
string |
任意 |
事前共有鍵。トンネルとトンネルピア間の身分認証に使用されます。
説明
トンネルとトンネルピアの事前共有鍵は同じである必要があります。異なる場合、トンネルを確立できません。 |
123456**** |
| RemoteId |
string |
任意 |
トンネルピアの識別子で、位相 1 ネゴシエーションに使用されます。値の長さは最大 100 文字で、スペースを含めることはできません。デフォルト値はトンネルに関連付けられたカスタマーゲートウェイの IP アドレスです。 |
47.42.XX.XX |
| TunnelIpsecConfig |
object |
任意 |
位相 2 ネゴシエーション構成。 |
|
| IpsecAuthAlg |
string |
任意 |
位相 2 ネゴシエーションで使用される認証アルゴリズム。 有効な値: md5、sha1、sha256、sha384、sha512。デフォルト値: md5。 |
md5 |
| IpsecEncAlg |
string |
任意 |
位相 2 ネゴシエーションで使用される暗号化アルゴリズム。 有効な値: aes、aes192、aes256、des、または 3des。デフォルト値: aes。 |
aes |
| IpsecLifetime |
integer |
任意 |
フェーズ 2 でネゴシエートされる SA の有効期間。単位: 秒。 有効な値: 0 ~ 86400。デフォルト値: 86400。 |
86400 |
| IpsecPfs |
string |
任意 |
第 2 位相ネゴシエーションで使用される Diffie-Hellman キー交換アルゴリズム。デフォルト値: group2。 |
group2 |
| EnableTunnelsBgp |
boolean |
任意 |
このパラメーターは、デュアルトンネル IPsec-VPN 接続を作成する場合にサポートされます。 トンネルの BGP を有効にするかどうかを指定します。有効な値: true または false (デフォルト)。 |
true |
| DryRun |
boolean |
任意 |
ドライランを実行するかどうかを指定します。有効な値: |
false |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答パラメーター。 |
||
| RequestId |
string |
リクエスト ID。 |
082AD562-B8DB-4BB2-861F-DA1FCA01FD76 |
| VpnConnectionId |
string |
IPsec-VPN 接続の ID。 |
vco-bp15oes1py4i6**** |
| Name |
string |
IPsec-VPN 接続の名前。 |
test |
| CreateTime |
integer |
IPsec-VPN 接続が作成されたタイムスタンプ。単位: ミリ秒。 タイムスタンプは UNIX タイムスタンプ形式で、1970 年 1 月 1 日 00:00:00 UTC からの経過ミリ秒数を表します。 |
1544666102000 |
例
成功レスポンス
JSONJSON
{
"RequestId": "082AD562-B8DB-4BB2-861F-DA1FCA01FD76",
"VpnConnectionId": "vco-bp15oes1py4i6****",
"Name": "test",
"CreateTime": 1544666102000
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | Resource.QuotaFull | The quota of resource is full | |
| 400 | InvalidVpnConnection.AlreadyExists | Vpn connection already exists. | |
| 400 | VpnGateway.Configuring | The specified service is configuring. | |
| 400 | VpnGateway.FinancialLocked | The specified service is financial locked. | |
| 400 | VpnGateway.IpsecVpnDisabled | The vpn gateway does not enable IPSec VPN. | VPN ゲートウェイで IPsec-VPN 特徴が有効になっていません。 |
| 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.ConflictSSL | The specified route entry has conflict with SSL client. | ルートエントリが SSL クライアントと競合しています。 |
| 400 | VpnRouteEntry.BackupRoute | Validate backup route entry failed. | アクティブ/スタンバイルートエントリの検証が失敗しました。 |
| 400 | VpnRouteEntry.InvalidWeight | Invalid route entry weight value. | ルートの重み値が無効です。 |
| 400 | InvalidParameter.VpnConnectionName | The specified vpn connection name is invalid. | 指定された VPN 接続名が無効です。 |
| 400 | OperationUnsupported.SetDPD | Current version of the VPN does not support setting DPD. | 現在の VPN ゲートウェイバージョンは Dead Peer Detection (DPD) 機能をサポートしていません。 |
| 400 | OperationUnsupported.SetNatTraversal | Current version of the VPN does not support setting NAT traversal. | 現在の VPN ゲートウェイバージョンは NAT 越え機能をサポートしていません。 |
| 400 | QuotaExceeded.PolicyBasedRoute | The maximum number of policy-based routes is exceeded. Existing routes: %s. Routes to be created: %s. Maximum routes: %s. | ポリシーベースルートの数が上限に達しました。現在の数は %s で、%s 個のルートが作成され、上限は %s です。 |
| 400 | MissingParameter.TunnelCidr | The parameter TunnelCidr is mandatory when BGP is enabled. | BGP が有効な場合、トンネル CIDR ブロックパラメーターは必須です。 |
| 400 | OperationUnsupported.EnableBgp | Current version of the VPN 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 | OperationFailed.MissCertificate | The VPN gateway has not associated any certificates. | 現在の VPN 接続は証明書に関連付けられていません。 |
| 400 | MissingParam.RemoteId | The remote ID is mandatory when creating national standard VPN connection. | ShangMi (SM) VPN 接続を作成する場合、リモート ID は必須です。 |
| 400 | CustomerGateway.ConflictRouteEntry | The specified customer gateway has conflict with route entry. | 現在のカスタマーゲートウェイとルートの間に競合が存在します。 |
| 400 | VpnTask.CONFLICT | Vpn task has conflict. | VPN 操作の競合が存在します。後でもう一度お試しください。 |
| 400 | Forbidden.TagKey.Duplicated | The specified tag key already exists. | タグのリソースが重複しています。 |
| 400 | SizeLimitExceeded.TagNum | The maximum number of tags is exceeded. | タグの数が上限を超えています。 |
| 400 | InvalidParameter.TagValue | The specified parameter TagValue is invalid. | 指定された TagValue パラメーターが無効です。 |
| 400 | InvalidParameter.TagKey | The specified parameter TagKey is invalid. | 指定された TagKey パラメーターが無効です。 |
| 400 | Duplicated.TagKey | The specified parameter TagKey is duplicated. | 指定された TagKey パラメーターが重複しています。 |
| 400 | InternalError | The request processing has failed due to some unknown error, exception or failure. | |
| 400 | InvalidTunnelCidr.Malformed | The specified TunnelCidr is malformed. | 指定されたトンネル CIDR ブロックが無効です。 |
| 400 | VpnConnectionParamInvalid.SameVpnAndCgwDifferentIkeConfigs | IPSec connections associated with the same user gateway and VPN gateway should have the same pre-shared key and IKE configuration. | 複数の IPsec-VPN 接続が同じ VPN ゲートウェイおよびカスタマーゲートウェイに関連付けられています。これらの複数の IPsec-VPN 接続の共有鍵および IKE 位相構成パラメーターは同一である必要があります。 |
| 400 | VpnConnectionParamInvalid.SameVpnAndCgwTrafficSelectorOverlap | Traffic selectors of IPSec connections associated with the same user gateway and VPN gateway should not overlap. | 複数の IPsec-VPN 接続が同じ VPN ゲートウェイおよびカスタマーゲートウェイに関連付けられています。これらの複数の IPsec-VPN 接続の対象トラフィック CIDR ブロックは重複してはなりません。 |
| 400 | CustomerGateway.ConflictVpnIp | The customer gateway associated with the IPSec connection should not have the same IP address as the VPN gateway. | カスタマーゲートウェイの IP アドレスが VPN ゲートウェイの IP アドレスと競合しています。 |
| 400 | VpnGateway.IPsecServerAndVpnConnectionConflict | The IPSec connection and IPSec server cannot be configured on the same VPN gateway at the same time. | VPN ゲートウェイでは、IPsec サーバーと IPsec-VPN 接続を同じ時間に設定することはサポートされていません。 |
| 400 | InvalidSslVpnServerCertId.NotFound | The parameter is incorrect. The corresponding SSL VPN server certificate cannot be found. | パラメーターが無効です。対応する SSL サーバーの証明書が見つかりません。 |
| 400 | MissingParameter.TunnelOptionsSpecification | The required parameters are missing when creating a tunnel for dual-tunnel VPN. | デュアルトンネル 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 | CreateVpnConnectionsQuotaFull.QuotaFull | The number of VPN connections exceeds the quota limit. | VPN 接続の数がクォータ制限を超えています。 |
| 400 | DryRunOperation | Request validation has been passed with DryRun flag set. | DryRun 検証が有効です。 |
| 400 | OperationFailed.OpenCdtServiceFirst | The operation is failed because of %s. | 指定された課金タイプでは Cloud Data Transfer (CDT) の有効化が必要です。CDT を有効化してからもう一度お試しください。請求書を確認してください。 |
| 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.AsnNotConfigured | ASN of CustomerGateway is required when enabling BGP on an IPSec connection. | IPsec-VPN 接続で BGP が有効な場合、カスタマーゲートウェイに ASN を設定する必要があります。 |
| 400 | OperationFailed.CenLevelNotSupport | When the VPC to which the VPN gateway belongs is attached to a FULL-mode CEN, the VPN gateway cannot enable BGP. | VPN ゲートウェイが属する VPC がルート同期有効化済みの Cloud Enterprise Network (CEN) インスタンスに参加している場合、VPN ゲートウェイで BGP を有効にすることはできません。 |
| 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 | InvalidCustomerGatewayInstanceId.NotFound | The specified customer gateway instance id does not exist. | 指定されたカスタマーゲートウェイインスタンスが存在しません。カスタマーゲートウェイインスタンス ID が正しいかどうかを確認してください。 |
| 404 | InvalidVpnGatewayInstanceId.NotFound | The specified vpn gateway instance id does not exist. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。