All Products
Search
Document Center

VPN Gateway:CreateVpnConnection

Last Updated:Oct 09, 2026

Membuat koneksi IPsec-VPN.

Deskripsi operasi

  • Jika instans Gateway VPN mendukung pembuatan koneksi IPsec-VPN dalam mode Terowongan IPsec ganda, Anda dapat mengonfigurasi parameter permintaan berikut selain parameter yang diperlukan saat memanggil operasi CreateVpnConnection:

    ClientToken, Name, EffectImmediately, AutoConfigRoute, array Tags, array TunnelOptionsSpecification, dan EnableTunnelsBgp.

    Untuk informasi tentang wilayah dan zona yang mendukung pembuatan koneksi IPsec-VPN dalam mode Terowongan IPsec ganda, lihat Peningkatan koneksi IPsec-VPN ke mode Terowongan IPsec ganda.

  • Jika instans Gateway VPN hanya mendukung pembuatan koneksi IPsec-VPN dalam mode Terowongan IPsec tunggal, Anda dapat mengonfigurasi parameter permintaan berikut selain parameter yang diperlukan saat memanggil operasi CreateVpnConnection:

    ClientToken, CustomerGatewayId, Name, EffectImmediately, IkeConfig, IpsecConfig, HealthCheckConfig, AutoConfigRoute, EnableDpd, EnableNatTraversal, BgpConfig, RemoteCaCertificate, dan array Tags.

  • Operasi CreateVpnConnection bersifat asinkron. Sistem mengembalikan ID instans, tetapi koneksi IPsec-VPN belum dibuat dan tugas pembuatan masih berjalan di latar belakang. Anda dapat memanggil operasi DescribeVpnGateway untuk mengkueri status instans Gateway VPN dan menentukan status pembuatan koneksi IPsec-VPN:

    • Jika instans Gateway VPN berada dalam status updating, koneksi IPsec-VPN sedang dibuat.

    • Jika instans Gateway VPN berada dalam status active, koneksi IPsec-VPN telah dibuat.

  • Operasi CreateVpnConnection tidak mendukung pembuatan beberapa koneksi IPsec-VPN secara bersamaan di bawah Gateway VPN yang sama.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vpc:CreateVpnConnection

create

*CustomerGateway.

acs:vpc:{#regionId}:{#accountId}:customergateway/{#CustomerGatewayId}

*VpnConnection.

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

*VpnGateway.

acs:vpc:{#regionId}:{#accountId}:vpngateway/{#VpnGatewayId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID wilayah koneksi IPsec-VPN. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

cn-shanghai

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Anda dapat menggunakan klien untuk menghasilkan nilai, tetapi Anda harus memastikan bahwa nilai tersebut unik di antara berbagai permintaan. Token klien hanya dapat berisi karakter ASCII.

Catatan

Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dari setiap permintaan API adalah unik.

02fb3da4-130e-11e9-8e44-001****

CustomerGatewayId

string

No

Parameter ini diperlukan saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec tunggal.

ID gateway pelanggan.

cgw-p0w2jemrcj5u61un8****

VpnGatewayId

string

Yes

ID instans Gateway VPN.

vpn-bp1q8bgx4xnkm****

Name

string

No

Nama koneksi IPsec-VPN.

Panjang nama harus 1 hingga 100 karakter, dan tidak boleh dimulai dengan http:// atau https://.

IPsec

LocalSubnet

string

Yes

Blok CIDR di sisi VPC yang perlu berkomunikasi dengan Pusat data lokal. Parameter ini digunakan untuk negosiasi Fase 2.

Pisahkan beberapa blok CIDR dengan koma (,). Contoh: 192.168.1.0/24,192.168.2.0/24.

Deskripsi mode perutean koneksi IPsec-VPN:

  • Jika LocalSubnet dan RemoteSubnet keduanya diatur ke 0.0.0.0/0, mode perutean tujuan digunakan.

  • Jika LocalSubnet dan RemoteSubnet keduanya diatur ke blok CIDR tertentu, mode trafik menarik digunakan.

10.10.1.0/24,10.10.2.0/24

RemoteSubnet

string

Yes

Blok CIDR di sisi Pusat data lokal yang perlu berkomunikasi dengan VPC. Parameter ini digunakan untuk negosiasi Fase 2.

Pisahkan beberapa blok CIDR dengan koma (,). Contoh: 192.168.3.0/24,192.168.4.0/24.

Deskripsi mode perutean koneksi IPsec-VPN:

  • Jika LocalSubnet dan RemoteSubnet keduanya diatur ke 0.0.0.0/0, mode perutean tujuan digunakan.

  • Jika LocalSubnet dan RemoteSubnet keduanya diatur ke blok CIDR tertentu, mode trafik menarik digunakan.

10.10.3.0/24,10.10.4.0/24

EffectImmediately

boolean

No

Apakah akan menerapkan konfigurasi koneksi IPsec-VPN segera. Nilai valid:

  • true: Ya. Sistem segera memulai negosiasi IPsec setelah konfigurasi selesai.

  • false (default): Tidak. Sistem memulai negosiasi IPsec hanya ketika trafik terdeteksi.

false

IkeConfig

string

No

Parameter ini didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec tunggal.

Konfigurasi untuk negosiasi Fase 1:

  • IkeConfig.Psk: Kunci bersama yang digunakan untuk otentikasi antara Gateway VPN dan Pusat data lokal.

    • Panjang kunci harus 1 hingga 100 karakter, dan dapat berisi angka, huruf, serta karakter khusus berikut: ~!\`@#$%^&*()_-+={}[]|;:',.<>/? Kunci tidak boleh berisi spasi.

    • Jika Anda tidak menentukan kunci bersama, sistem secara acak menghasilkan string sebagai kunci bersama. Anda dapat memanggil operasi DescribeVpnConnection untuk mengkueri kunci bersama yang dihasilkan secara otomatis.

      Catatan

      Kunci bersama di sisi koneksi IPsec-VPN harus sama dengan kunci autentikasi di sisi Pusat data lokal. Jika tidak, koneksi antara Pusat data lokal dan Gateway VPN tidak dapat dibuat.

  • IkeConfig.IkeVersion: Versi protokol IKE. Nilai valid: ikev1 dan ikev2. Nilai default: ikev1.

    Dibandingkan dengan IKEv1, IKEv2 menyederhanakan proses negosiasi SA dan memberikan dukungan yang lebih baik untuk skenario dengan beberapa blok CIDR.

  • IkeConfig.IkeMode: Mode negosiasi versi IKE. Nilai valid: main dan aggressive. Nilai default: main.

    • main: Mode utama. Proses negosiasi sangat aman.

    • aggressive: Mode agresif. Proses negosiasi cepat dan memiliki laju keberhasilan tinggi.

  • IkeConfig.IkeEncAlg: Algoritma enkripsi untuk negosiasi Fase 1.

    Nilai valid: aes, aes192, aes256, des, dan 3des. Nilai default: aes.

  • IkeConfig.IkeAuthAlg: Algoritma autentikasi untuk negosiasi Fase 1.

    Nilai valid: md5, sha1, sha256, sha384, dan sha512. Nilai default: md5.

  • IkeConfig.IkePfs: Algoritma pertukaran kunci Diffie-Hellman yang digunakan dalam negosiasi Fase 1. Nilai valid: group1, group2, group5, dan group14. Nilai default: group2.

  • IkeConfig.IkeLifetime: Siklus hidup SA yang dinegosiasikan dalam Fase 1. Unit: detik. Nilai valid: 0 hingga 86400. Nilai default: 86400.

  • IkeConfig.LocalId: Pengidentifikasi Gateway VPN. Panjang pengidentifikasi dapat mencapai 100 karakter dan tidak boleh berisi spasi. Nilai default adalah alamat IP Gateway VPN.

  • IkeConfig.RemoteId: Pengidentifikasi gateway pelanggan. Panjang pengidentifikasi dapat mencapai 100 karakter dan tidak boleh berisi spasi. Nilai default adalah alamat IP gateway pelanggan.

{"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

No

Parameter ini didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec tunggal.

Konfigurasi untuk negosiasi Fase 2:

  • IpsecConfig.IpsecEncAlg: Algoritma enkripsi untuk negosiasi Fase 2.

    Nilai valid: aes, aes192, aes256, des, dan 3des. Nilai default: aes.

  • IpsecConfig.IpsecAuthAlg: Algoritma autentikasi untuk negosiasi Fase 2.

    Nilai valid: md5, sha1, sha256, sha384, dan sha512. Nilai default: md5.

  • IpsecConfig.IpsecPfs: Algoritma pertukaran kunci Diffie-Hellman yang digunakan dalam negosiasi Fase 2. Nilai valid: disabled, group1, group2, group5, dan group14. Nilai default: group2.

  • IpsecConfig.IpsecLifetime: Siklus hidup SA yang dinegosiasikan dalam Fase 2. Unit: detik. Nilai valid: 0 hingga 86400. Nilai default: 86400.

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

HealthCheckConfig

string

No

Parameter ini didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec tunggal.

Konfigurasi pemeriksaan kesehatan:

  • HealthCheckConfig.enable: Apakah akan mengaktifkan pemeriksaan kesehatan. Nilai valid: true dan false (default).

  • HealthCheckConfig.dip: Alamat IP tujuan untuk pemeriksaan kesehatan.

  • HealthCheckConfig.sip: Alamat IP sumber untuk pemeriksaan kesehatan.

  • HealthCheckConfig.interval: Interval percobaan ulang untuk pemeriksaan kesehatan. Unit: detik. Nilai default: 3.

  • HealthCheckConfig.retry: Jumlah maksimum percobaan ulang pemeriksaan kesehatan. Nilai default: 3.

{"enable":"true","dip":"192.168.10.1","sip":"10.10.1.1","interval":"3","retry":"3"}

AutoConfigRoute

boolean

No

Apakah akan mengonfigurasi rute secara otomatis. Nilai valid:

  • true (default): Mengonfigurasi rute secara otomatis.

  • false: Tidak mengonfigurasi rute secara otomatis.

true

EnableDpd

boolean

No

Parameter ini didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec tunggal.

Apakah akan mengaktifkan fitur dead peer detection (DPD). Nilai valid:

  • true (default): Mengaktifkan fitur DPD. Inisiator IPsec mengirimkan paket DPD untuk memeriksa apakah perangkat peer aktif. Jika tidak ada tanggapan yang benar yang diterima dalam pengatur waktu yang ditentukan, peer dianggap terputus. IPsec menghapus ISAKMP SA dan IPsec SA yang sesuai, dan saluran data aman juga dihapus.

  • false: Menonaktifkan fitur DPD. Inisiator IPsec tidak mengirimkan paket probe DPD.

true

EnableNatTraversal

boolean

No

Parameter ini didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec tunggal.

Apakah akan mengaktifkan fitur penelusuran NAT. Nilai valid:

  • true (default): Mengaktifkan fitur penelusuran NAT. Setelah fitur ini diaktifkan, proses negosiasi IKE melewatkan verifikasi nomor Port UDP dan menemukan perangkat gerbang NAT di saluran data VPN.

  • false: Menonaktifkan fitur penelusuran NAT.

true

BgpConfig

string

No

Parameter ini didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec tunggal.

Konfigurasi BGP:

  • BgpConfig.EnableBgp: Apakah akan mengaktifkan fitur BGP. Nilai valid: true dan false (default).

  • BgpConfig.LocalAsn: Nomor sistem otonom (ASN) di sisi Alibaba Cloud. Nilai valid: 1 hingga 4294967295. Nilai default: 45104.

    Anda dapat memasukkan ASN dalam format dua segmen: 16 bit pertama dan 16 bit terakhir. Setiap segmen harus dimasukkan dalam format desimal.

    Misalnya, jika Anda memasukkan 123.456, ASN dihitung sebagai berikut: 123 × 65536 + 456 = 8061384.

  • BgpConfig.TunnelCidr: Blok CIDR Terowongan IPsec. Blok CIDR harus berada dalam rentang 169.254.0.0/16 dan memiliki panjang mask 30, serta tidak boleh berupa 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, atau 169.254.169.252/30.

    Catatan

    Blok CIDR Terowongan IPsec dari setiap koneksi IPsec-VPN di bawah instans Gateway VPN yang sama harus unik.

  • LocalBgpIp: Alamat IP BGP di sisi Alibaba Cloud. Alamat IP ini harus berada dalam blok CIDR Terowongan IPsec.

Catatan
  • Sebelum menambahkan konfigurasi BGP, pahami mekanisme kerja dan batasan fitur perutean dinamis BGP. Untuk informasi lebih lanjut, lihat Mengonfigurasi perutean dinamis BGP.

  • Gunakan ASN pribadi untuk membuat koneksi BGP dengan Alibaba Cloud. Lihat dokumentasi terkait untuk rentang ASN pribadi.

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

RemoteCaCertificate

string

No

Parameter ini didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec tunggal.

Jika instans Gateway VPN saat ini adalah Gateway VPN ShangMi (SM), Anda harus mengonfigurasi sertifikat CA dari peer.

  • Untuk Gateway VPN ShangMi (SM), parameter ini diperlukan saat Anda membuat koneksi IPsec-VPN.

  • Untuk Gateway VPN standar, parameter ini harus dibiarkan kosong.

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

Tags

array<object>

No

Daftar tag yang akan ditambahkan ke koneksi IPsec-VPN.

Anda dapat menambahkan hingga 20 tag ke koneksi IPsec-VPN sekaligus.

object

No

Informasi tag.

Key

string

No

Kunci tag. Parameter ini tidak boleh berupa string kosong setelah ditentukan.

Panjang kunci tag dapat mencapai 64 karakter, dan tidak boleh dimulai dengan aliyun atau acs:. Tidak boleh berisi http:// atau https://.

Anda dapat menentukan hingga 20 kunci tag sekaligus.

TagKey

Value

string

No

Nilai tag.

Panjang nilai tag dapat mencapai 128 karakter dan dapat berupa string kosong. Tidak boleh dimulai dengan aliyun atau acs:, dan tidak boleh berisi http:// atau https://.

Setiap kunci tag berkorespondensi dengan satu nilai tag. Anda dapat menentukan hingga 20 nilai tag sekaligus.

TagValue

TunnelOptionsSpecification

array<object>

No

Konfigurasi saluran data.

  • Parameter dalam array TunnelOptionsSpecification didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec ganda.

  • Saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec ganda, Anda harus menambahkan konfigurasi untuk saluran data utama dan sekunder. Hanya satu saluran data utama dan satu saluran data sekunder yang dapat ditambahkan ke koneksi IPsec-VPN.

array<object>

No

Informasi konfigurasi saluran data.

CustomerGatewayId

string

No

ID gateway pelanggan yang terkait dengan saluran data.

Catatan
  • Parameter ini diperlukan saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec ganda.

  • Parameter dalam array TunnelOptionsSpecification didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec ganda.

  • Saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec ganda, Anda harus menambahkan konfigurasi untuk saluran data utama dan sekunder. Hanya satu saluran data utama dan satu saluran data sekunder yang dapat ditambahkan ke koneksi IPsec-VPN.

cgw-p0wy363lucf1uyae8****

EnableDpd

boolean

No

Apakah akan mengaktifkan fitur dead peer detection (DPD) untuk saluran data. Nilai valid:

  • true (default): Mengaktifkan fitur DPD. Inisiator IPsec mengirimkan paket DPD untuk memeriksa apakah perangkat peer aktif. Jika tidak ada tanggapan yang benar yang diterima dalam pengatur waktu yang ditentukan, peer dianggap terputus. IPsec menghapus ISAKMP SA dan IPsec SA yang sesuai, dan saluran data aman juga dihapus.

  • false: Menonaktifkan fitur DPD. Inisiator IPsec tidak mengirimkan paket probe DPD.

true

EnableNatTraversal

boolean

No

Apakah akan mengaktifkan fitur penelusuran NAT untuk saluran data. Nilai valid:

  • true (default): Mengaktifkan fitur penelusuran NAT. Setelah fitur ini diaktifkan, proses negosiasi IKE melewatkan verifikasi nomor Port UDP dan menemukan perangkat gerbang NAT di saluran data.

  • false: Menonaktifkan fitur penelusuran NAT.

true

RemoteCaCertificate

string

No

Jika instans Gateway VPN saat ini adalah Gateway VPN ShangMi (SM), Anda harus mengonfigurasi sertifikat CA dari peer untuk saluran data.

  • Untuk Gateway VPN ShangMi (SM), parameter ini diperlukan.

  • Untuk Gateway VPN standar, parameter ini harus dibiarkan kosong.

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

Role

string

No

Peran saluran data. Nilai valid:

  • master: Saluran data saat ini adalah saluran data utama.

  • slave: Saluran data saat ini adalah saluran data sekunder.

master

TunnelBgpConfig

object

No

Konfigurasi BGP untuk saluran data.

LocalAsn

integer

No

Nomor sistem otonom (ASN) di sisi lokal (sisi Alibaba Cloud) saluran data. Nilai valid: 1 hingga 4294967295. Nilai default: 45104.

Catatan
  • Parameter ini diperlukan saat Anda mengaktifkan fitur BGP untuk koneksi IPsec-VPN (yaitu, saat Anda mengatur parameter EnableTunnelsBgp ke true).

  • Sebelum menambahkan konfigurasi BGP, pahami mekanisme kerja dan batasan fitur perutean dinamis BGP. Untuk informasi lebih lanjut, lihat Mengonfigurasi perutean dinamis BGP.

  • Gunakan ASN pribadi untuk membuat koneksi BGP dengan Alibaba Cloud. Lihat dokumentasi terkait untuk rentang ASN pribadi.

65530

LocalBgpIp

string

No

Alamat IP BGP di sisi lokal (sisi Alibaba Cloud) saluran data. Alamat IP ini harus berada dalam blok CIDR BGP.

169.254.10.1

TunnelCidr

string

No

Blok CIDR BGP saluran data. Blok CIDR harus berada dalam rentang 169.254.0.0/16 dan memiliki panjang mask 30, serta tidak boleh berupa 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, atau 169.254.169.252/30.

Catatan

Blok CIDR BGP dari setiap saluran data di bawah instans Gateway VPN yang sama harus unik.

169.254.10.0/30

TunnelIkeConfig

object

No

Konfigurasi untuk negosiasi Fase 1.

IkeAuthAlg

string

No

Algoritma autentikasi untuk negosiasi Fase 1.

Nilai valid: md5, sha1, sha256, sha384, dan sha512. Nilai default: md5.

md5

IkeEncAlg

string

No

Algoritma enkripsi untuk negosiasi Fase 1.

Nilai valid: aes, aes192, aes256, des, dan 3des. Nilai default: aes.

aes

IkeLifetime

integer

No

Siklus hidup SA yang dinegosiasikan dalam Fase 1. Unit: detik.

Nilai valid: 0 hingga 86400. Nilai default: 86400.

86400

IkeMode

string

No

Mode negosiasi versi IKE. Nilai valid: main dan aggressive. Nilai default: main.

  • main: Mode utama. Proses negosiasi sangat aman.

  • aggressive: Mode agresif. Proses negosiasi cepat dan memiliki laju keberhasilan tinggi.

main

IkePfs

string

No

Algoritma pertukaran kunci Diffie-Hellman yang digunakan dalam negosiasi Fase 1. Nilai default: group2.
Nilai valid: group1, group2, group5, dan group14.

group2

IkeVersion

string

No

Versi protokol IKE. Nilai valid: ikev1 dan ikev2. Nilai default: ikev1.

Dibandingkan dengan IKEv1, IKEv2 menyederhanakan proses negosiasi SA dan memberikan dukungan yang lebih baik untuk skenario dengan beberapa blok CIDR.

ikev1

LocalId

string

No

Pengidentifikasi di sisi lokal (sisi Alibaba Cloud) saluran data, yang digunakan untuk negosiasi Fase 1. Panjang pengidentifikasi dapat mencapai 100 karakter dan tidak boleh berisi spasi. Nilai default adalah alamat IP saluran data.

LocalId mendukung format FQDN. Jika Anda menggunakan format FQDN, kami menyarankan Anda mengatur mode negosiasi ke aggressive.

47.21.XX.XX

Psk

string

No

Kunci bersama yang digunakan untuk otentikasi antara saluran data dan peer.

  • Panjang kunci harus 1 hingga 100 karakter, dan dapat berisi angka, huruf, serta karakter khusus berikut: ~!\`@#$%^&*()_-+={}[]|;:',.<>/? Kunci tidak boleh berisi spasi.

  • Jika Anda tidak menentukan kunci bersama, sistem secara acak menghasilkan string 16 karakter sebagai kunci bersama. Anda dapat memanggil operasi DescribeVpnConnection untuk mengkueri kunci bersama yang dihasilkan secara otomatis.

Catatan

Kunci bersama saluran data harus sama dengan kunci bersama peer. Jika tidak, sistem tidak dapat membuat saluran data.

123456****

RemoteId

string

No

Pengidentifikasi peer, yang digunakan untuk negosiasi Fase 1. Panjang pengidentifikasi dapat mencapai 100 karakter dan tidak boleh berisi spasi. Nilai default adalah alamat IP gateway pelanggan yang terkait dengan saluran data.

RemoteId mendukung format FQDN. Jika Anda menggunakan format FQDN, kami menyarankan Anda mengatur mode negosiasi ke aggressive.

47.42.XX.XX

TunnelIpsecConfig

object

No

Konfigurasi untuk negosiasi Fase 2.

IpsecAuthAlg

string

No

Algoritma autentikasi untuk negosiasi Fase 2.

Nilai valid: md5, sha1, sha256, sha384, dan sha512. Nilai default: md5.

md5

IpsecEncAlg

string

No

Algoritma enkripsi untuk negosiasi Fase 2.

Nilai valid: aes, aes192, aes256, des, dan 3des. Nilai default: aes.

aes

IpsecLifetime

integer

No

Siklus hidup SA yang dinegosiasikan dalam Fase 2. Unit: detik.

Nilai valid: 0 hingga 86400. Nilai default: 86400.

86400

IpsecPfs

string

No

Algoritma pertukaran kunci Diffie-Hellman yang digunakan dalam negosiasi Fase 2. Nilai default: group2.

Nilai valid: disabled, group1, group2, group5, dan group14.

group2

EnableTunnelsBgp

boolean

No

Parameter ini didukung saat Anda membuat koneksi IPsec-VPN dalam mode Terowongan IPsec ganda.

Apakah akan mengaktifkan fitur BGP untuk saluran data. Nilai valid: true dan false (default).

true

DryRun

boolean

No

Apakah akan hanya melakukan pemeriksaan awal pada permintaan. Nilai valid:

  • true: Melakukan pemeriksaan awal pada permintaan tanpa membuat koneksi IPsec-VPN. Sistem memeriksa apakah parameter yang diperlukan telah ditentukan, format permintaan, dan batas layanan. Jika permintaan gagal dalam pemeriksaan awal, kode kesalahan yang sesuai dikembalikan. Jika permintaan lulus pemeriksaan awal, kode kesalahan DryRunOperation dikembalikan.

  • false (default): Mengirim permintaan normal dan membuat koneksi IPsec-VPN setelah permintaan lulus pemeriksaan awal.

false

Elemen respons

Element

Type

Description

Example

object

Hasil yang dikembalikan.

RequestId

string

ID permintaan.

082AD562-B8DB-4BB2-861F-DA1FCA01FD76

VpnConnectionId

string

ID koneksi IPsec-VPN.

vco-bp15oes1py4i6****

Name

string

Nama koneksi IPsec-VPN.

test

CreateTime

integer

Pengatur waktu saat koneksi IPsec-VPN dibuat. Unit: milidetik.

Pengatur waktu dalam format UNIX, yang mewakili durasi total dari 00:00:00 pada 1 Januari 1970 (UTC) hingga waktu saat koneksi IPsec-VPN dibuat.

1544666102000

Contoh

Respons sukses

JSONformat

{
  "RequestId": "082AD562-B8DB-4BB2-861F-DA1FCA01FD76",
  "VpnConnectionId": "vco-bp15oes1py4i6****",
  "Name": "test",
  "CreateTime": 1544666102000
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

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. Fitur IPsec-VPN tidak diaktifkan untuk Gateway VPN.
400 VpnRouteEntry.AlreadyExists The specified route entry is already exist. Entri rute sudah ada.
400 VpnRouteEntry.Conflict The specified route entry has conflict. Terdapat konflik entri rute.
400 NotSupportVpnConnectionParameter.IpsecPfs The specified vpn connection ipsec Ipsec Pfs is not support. Parameter PFS yang ditentukan untuk koneksi IPsec-VPN tidak didukung.
400 NotSupportVpnConnectionParameter.IpsecAuthAlg The specified vpn connection ipsec Auth Alg is not support. Algoritma autentikasi yang ditentukan untuk koneksi IPsec-VPN tidak didukung.
400 VpnRouteEntry.ConflictSSL The specified route entry has conflict with SSL client. Entri rute bertentangan dengan Klien SSL.
400 VpnRouteEntry.BackupRoute Validate backup route entry failed. Validasi entri rute aktif/standby gagal. Konfigurasi perutean tidak valid.
400 VpnRouteEntry.InvalidWeight Invalid route entry weight value. Nilai bobot entri rute tidak valid.
400 InvalidParameter.VpnConnectionName The specified vpn connection name is invalid. Nama koneksi VPN yang ditentukan tidak valid.
400 OperationUnsupported.SetDPD Current version of the VPN does not support setting DPD. Versi Gateway VPN saat ini tidak mendukung fitur DPD.
400 OperationUnsupported.SetNatTraversal Current version of the VPN does not support setting NAT traversal. Versi Gateway VPN saat ini tidak mendukung Penelusuran NAT.
400 QuotaExceeded.PolicyBasedRoute The maximum number of policy-based routes is exceeded. Existing routes: %s. Routes to be created: %s. Maximum routes: %s. Jumlah entri rute kebijakan telah mencapai batas atas. Jumlah saat ini adalah %s, operasi ini akan membuat %s lagi, dan batas atasnya adalah %s.
400 MissingParameter.TunnelCidr The parameter TunnelCidr is mandatory when BGP is enabled. Parameter Blok CIDR saluran data diperlukan saat BGP diaktifkan.
400 OperationUnsupported.EnableBgp Current version of the VPN does not support enable BGP. Versi Gateway VPN saat ini tidak mendukung BGP.
400 MissingParam.CustomerGatewayAsn Asn of customer gateway is mandatory when BGP is enabled. Saat BGP diaktifkan, nomor sistem otonom gerbang pelanggan tidak boleh kosong.
400 IllegalParam.LocalAsn The specified LocalAsn is invalid. Nomor sistem otonom lokal tidak valid.
400 IllegalParam.BgpConfig The specified BgpConfig is invalid. Konfigurasi BGP yang ditentukan tidak valid.
400 IllegalParam.EnableBgp VPN connection must enable BGP when VPN gateway has enabled BGP. Ketika BGP diaktifkan untuk Gateway VPN, BGP juga harus diaktifkan untuk koneksi VPN.
400 IllegalParam.TunnelCidr The specified TunnelCidr is invalid. Parameter TunnelCidr tidak valid.
400 InvalidLocalBgpIp.Malformed The specified LocalBgpIp is malformed. Alamat IP BGP lokal yang ditentukan tidak valid.
400 IllegalParam.LocalBgpIp The specified LocalBgpIp is invalid. Alamat BGP lokal tidak valid.
400 IllegalParam.LocalSubnet The specified "LocalSubnet" (%s) is invalid. Blok CIDR lokal (%s) tidak valid.
400 IllegalParam.RemoteSubnet The specified "RemoteSubnet" (%s) is invalid. Blok CIDR jarak jauh (%s) tidak valid.
400 OperationFailed.MissCertificate The VPN gateway has not associated any certificates. Tidak ada sertifikat yang terikat ke Gateway VPN.
400 MissingParam.RemoteId The remote ID is mandatory when creating national standard VPN connection. Peer ID diperlukan saat Anda membuat koneksi VPN SM.
400 CustomerGateway.ConflictRouteEntry The specified customer gateway has conflict with route entry. Terdapat konflik antara gerbang pengguna saat ini dan entri rute.
400 VpnTask.CONFLICT Vpn task has conflict. Terjadi konflik operasi VPN. Coba lagi nanti.
400 Forbidden.TagKey.Duplicated The specified tag key already exists. Terdapat sumber daya tag yang duplikat.
400 SizeLimitExceeded.TagNum The maximum number of tags is exceeded. Jumlah tag telah melebihi batas.
400 InvalidParameter.TagValue The specified parameter TagValue is invalid. Parameter TagValue yang ditentukan tidak valid.
400 InvalidParameter.TagKey The specified parameter TagKey is invalid. Parameter TagKey yang ditentukan tidak valid.
400 Duplicated.TagKey The specified parameter TagKey is duplicated. Parameter TagKey yang ditentukan duplikat.
400 InternalError The request processing has failed due to some unknown error, exception or failure.
400 InvalidTunnelCidr.Malformed The specified TunnelCidr is malformed. Blok CIDR saluran data yang ditentukan tidak valid.
400 VpnConnectionParamInvalid.SameVpnAndCgwDifferentIkeConfigs IPSec connections associated with the same user gateway and VPN gateway should have the same pre-shared key and IKE configuration. Beberapa koneksi IPsec-VPN terkait dengan Gateway VPN dan gerbang pelanggan yang sama. Kunci bersama dan parameter konfigurasi fase IKE dari koneksi IPsec-VPN ini harus identik.
400 VpnConnectionParamInvalid.SameVpnAndCgwTrafficSelectorOverlap Traffic selectors of IPSec connections associated with the same user gateway and VPN gateway should not overlap. Beberapa koneksi IPsec-VPN terkait dengan Gateway VPN dan gerbang pelanggan yang sama. Trafik selector dari koneksi IPsec-VPN ini tidak boleh tumpang tindih.
400 CustomerGateway.ConflictVpnIp The customer gateway associated with the IPSec connection should not have the same IP address as the VPN gateway. Gateway pelanggan yang terkait dengan koneksi IPsec-VPN tidak boleh memiliki alamat IP gerbang yang sama dengan Gateway VPN.
400 VpnGateway.IPsecServerAndVpnConnectionConflict The IPSec connection and IPSec server cannot be configured on the same VPN gateway at the same time. Gateway VPN tidak mendukung konfigurasi server IPsec dan koneksi IPsec-VPN secara bersamaan.
400 InvalidSslVpnServerCertId.NotFound The parameter is incorrect. The corresponding SSL VPN server certificate cannot be found. Parameter tidak valid. Sertifikat untuk server SSL-VPN tidak ditemukan.
400 MissingParameter.TunnelOptionsSpecification The required parameters are missing when creating a tunnel for dual-tunnel VPN. Parameter yang diperlukan hilang saat membuat saluran data untuk VPN saluran data ganda.
400 CreateDbrRoutesQuotaFull.QuotaFull The number of created destination routes exceeds the quota limit. Jumlah entri rute tujuan melebihi batas kuota.
400 CreatePbrRoutesQuotaFull.QuotaFull The number of policy routes exceeds the quota limit. Jumlah entri rute berbasis kebijakan melebihi batas kuota.
400 CreateVpnConnectionsQuotaFull.QuotaFull The number of VPN connections exceeds the quota limit. Jumlah koneksi VPN melebihi batas kuota.
400 DryRunOperation Request validation has been passed with DryRun flag set. Pemeriksaan DryRun berhasil.
400 OperationFailed.OpenCdtServiceFirst The operation is failed because of %s. Metode penagihan yang ditentukan memerlukan aktivasi Cloud Data Transfer (CDT). Aktifkan CDT dan coba lagi.
400 EncAlgInvalid.DesIncompatible Des/3des in IkeEncAlg and IpsecEncAlg does not support multi algorithm. DES dan 3DES tidak mendukung kompatibilitas multi-algoritma dalam algoritma enkripsi IKE atau algoritma enkripsi IPsec.
400 IkeVersionInvalid.GcmIncompatible Ikev1 does not support IkeEncAlg of gcm16. IKEv1 tidak mendukung konfigurasi hanya algoritma GCM-16 sebagai algoritma enkripsi IKE.
400 CustomerGateway.AsnNotConfigured ASN of CustomerGateway is required when enabling BGP on an IPSec connection. Saat BGP diaktifkan untuk koneksi IPSec-VPN, Anda harus mengonfigurasi ASN pada gerbang pelanggan.
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. BGP tidak dapat diaktifkan untuk Gateway VPN karena VPC tempat Gateway VPN berada telah bergabung dengan instans Cloud Enterprise Network dengan Sinkronisasi rute diaktifkan.
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. Anda tidak memiliki izin untuk melakukan operasi pada sumber daya yang ditentukan. Ajukan izin yang diperlukan dan coba lagi.
404 InvalidCustomerGatewayInstanceId.NotFound The specified customer gateway instance id does not exist. Instans gateway pelanggan yang ditentukan tidak ada. Periksa apakah ID instans gateway pelanggan sudah benar.
404 InvalidVpnGatewayInstanceId.NotFound The specified vpn gateway instance id does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.