All Products
Search

This Product

    VPN Gateway:CreateVpnConnection

    Document Center

    VPN Gateway:CreateVpnConnection

    Last Updated:Aug 07, 2026

    Buat koneksi IPsec-VPN dengan memanggil operasi CreateVpnConnection.

    Deskripsi operasi

    • Jika instans gateway VPN mendukung pembuatan koneksi IPsec-VPN dalam mode dual-tunnel, 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 mengenai wilayah dan zona yang mendukung koneksi IPsec-VPN dalam mode dual-tunnel, lihat Upgrade koneksi IPsec-VPN ke mode dual-tunnel.

    • Jika instans gateway VPN hanya mendukung pembuatan koneksi IPsec-VPN dalam mode single-tunnel, 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. Setelah mengirim permintaan, sistem akan mengembalikan ID instans, tetapi koneksi IPsec-VPN belum selesai dibuat. Tugas pembuatan masih berjalan di latar belakang. Anda dapat memanggil DescribeVpnGateway untuk memeriksa status instans gateway VPN guna menentukan status pembuatan koneksi IPsec-VPN:

      • Jika instans gateway VPN berada dalam status updating, koneksi IPsec-VPN sedang dalam proses pembuatan.

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

    • Operasi CreateVpnConnection tidak mendukung pembuatan koneksi IPsec-VPN secara konkuren pada 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 untuk koneksi IPsec-VPN. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru.

    cn-shanghai
    ClientToken

    string

    No

    Token client yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan client untuk menghasilkan token, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token client hanya boleh berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.

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

    string

    No

    Parameter ini didukung dan wajib saat membuat koneksi IPsec-VPN dalam mode single-tunnel.

    ID gateway pelanggan.

    cgw-p0w2jemrcj5u61un8****
    VpnGatewayId

    string

    Yes

    ID instans gateway VPN.

    vpn-bp1q8bgx4xnkm****
    Name

    string

    No

    Nama koneksi IPsec-VPN.

    Nama harus terdiri dari 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. Blok CIDR ini digunakan dalam negosiasi Fase 2.

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

    Mode perutean berikut didukung untuk 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 aliran data terproteksi 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. Blok CIDR ini digunakan dalam negosiasi Fase 2.

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

    Mode perutean berikut didukung untuk 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 aliran data terproteksi digunakan.

    10.10.3.0/24,10.10.4.0/24
    EffectImmediately

    boolean

    No

    Menentukan apakah konfigurasi koneksi IPsec-VPN langsung berlaku. Nilai yang valid:

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

    • false (default): Sistem hanya memulai negosiasi protokol IPsec ketika lalu lintas masuk terdeteksi.

    false
    IkeConfig

    string

    No

    Parameter ini didukung saat membuat koneksi IPsec-VPN dalam mode single-tunnel.

    Konfigurasi negosiasi Fase 1:

    • IkeConfig.Psk: Kunci pra-bersama yang digunakan untuk otentikasi identitas antara gateway VPN dan pusat data lokal.

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

      • Jika Anda tidak menentukan kunci pra-bersama, sistem akan menghasilkan string acak sebagai kunci pra-bersama. Anda dapat memanggil operasi DescribeVpnConnection untuk menanyakan kunci pra-bersama yang dihasilkan secara otomatis oleh sistem.

        Catatan

        Kunci pra-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 yang valid: ikev1 dan ikev2. Nilai default: ikev1.

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

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

      • main: Mode utama. Proses negosiasi sangat aman.

      • aggressive: Mode agresif. Negosiasi cepat dan memiliki tingkat keberhasilan tinggi.

    • IkeConfig.IkeEncAlg: Algoritma enkripsi yang digunakan dalam negosiasi Fase 1.

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

    • IkeConfig.IkeAuthAlg: Algoritma autentikasi yang digunakan dalam negosiasi Fase 1.

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

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

    • IkeConfig.IkeLifetime: Masa berlaku SA yang dinegosiasikan dalam Fase 1. Satuan: detik. Nilai yang valid: 0 hingga 86400. Nilai default: 86400.

    • IkeConfig.LocalId: Pengidentifikasi gateway VPN. Pengidentifikasi dapat terdiri dari maksimal 100 karakter dan tidak boleh berisi spasi. Nilai default adalah alamat IP gateway VPN.

    • IkeConfig.RemoteId: Pengidentifikasi gateway pelanggan. Pengidentifikasi dapat terdiri dari maksimal 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 membuat koneksi IPsec-VPN dalam mode single-tunnel.

    Konfigurasi negosiasi Fase 2:

    • IpsecConfig.IpsecEncAlg: Algoritma enkripsi yang digunakan dalam negosiasi Fase 2.

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

    • IpsecConfig. IpsecAuthAlg: Algoritma autentikasi yang digunakan dalam negosiasi Fase 2.

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

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

    • IpsecConfig. IpsecLifetime: Masa berlaku SA yang dinegosiasikan dalam Fase 2. Satuan: detik. Nilai yang valid: 0 hingga 86400. Nilai default: 86400.

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

    string

    No

    Parameter ini didukung saat membuat koneksi IPsec-VPN dalam mode single-tunnel.

    Konfigurasi pemeriksaan kesehatan:

    • HealthCheckConfig.enable: Menentukan apakah pemeriksaan kesehatan diaktifkan. Nilai yang valid: true dan false (default).

    • HealthCheckConfig.dip: Alamat IP tujuan pemeriksaan kesehatan.

    • HealthCheckConfig.sip: Alamat IP sumber pemeriksaan kesehatan.

    • HealthCheckConfig.interval: Interval pengulangan pemeriksaan kesehatan. Satuan: detik. Nilai default: 3.

    • HealthCheckConfig.retry: Jumlah pengulangan pemeriksaan kesehatan. Nilai default: 3.

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

    boolean

    No

    Menentukan apakah rute dikonfigurasi secara otomatis. Nilai yang valid:

    • true (default): Rute dikonfigurasi secara otomatis.

    • false: Rute tidak dikonfigurasi secara otomatis.

    true
    EnableDpd

    boolean

    No

    Parameter ini didukung saat membuat koneksi IPsec-VPN dalam mode single-tunnel.

    Menentukan apakah fitur Pendeteksian Peer Mati (DPD) diaktifkan. Nilai yang valid:

    • true (default): DPD diaktifkan. Inisiator IPsec mengirim paket DPD untuk memeriksa apakah perangkat peer masih aktif. Jika tidak ada respons yang benar diterima dalam periode yang ditentukan, peer dianggap terputus. SA ISAKMP dan SA IPsec terkait dihapus, dan saluran data keamanan juga dihapus.

    • false: DPD dinonaktifkan. Inisiator IPsec tidak mengirim paket probe DPD.

    true
    EnableNatTraversal

    boolean

    No

    Parameter ini didukung saat membuat koneksi IPsec-VPN dalam mode single-tunnel.

    Menentukan apakah fitur penelusuran NAT diaktifkan. Nilai yang valid:

    • true (default): Penelusuran NAT diaktifkan. Setelah penelusuran NAT diaktifkan, proses negosiasi IKE menghapus verifikasi nomor port UDP dan dapat mendeteksi perangkat gerbang NAT dalam saluran data VPN.

    • false: Penelusuran NAT dinonaktifkan.

    true
    BgpConfig

    string

    No

    Parameter ini didukung saat membuat koneksi IPsec-VPN dalam mode single-tunnel.

    Konfigurasi BGP:

    • BgpConfig.EnableBgp: Menentukan apakah fitur BGP diaktifkan. Nilai yang valid: true dan false (default).

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

      Anda dapat memasukkan nomor sistem otonom dalam format dua segmen: 16 bit pertama.16 bit terakhir. Masukkan setiap segmen dalam format desimal.

      Sebagai contoh, jika Anda memasukkan 123.456, nomor sistem otonomnya adalah 123 × 65536 + 456 = 8061384.

    • BgpConfig.TunnelCidr: Blok CIDR saluran data IPsec. Blok CIDR harus merupakan blok CIDR dengan panjang masker 30 dalam rentang 169.254.0.0/16 dan tidak boleh 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 saluran data IPsec setiap koneksi IPsec-VPN di bawah instans gateway VPN harus unik.

    • LocalBgpIp: Alamat BGP di sisi Alibaba Cloud. Alamat ini merupakan alamat IP dalam blok CIDR saluran data IPsec.

    Catatan

    • Sebelum mengonfigurasi BGP, pelajari cara kerja fitur perutean dinamis BGP dan batasannya. Untuk informasi selengkapnya, lihat Konfigurasi perutean dinamis BGP.

    • Gunakan nomor sistem otonom privat untuk membuat koneksi BGP dengan Alibaba Cloud. Lihat dokumentasi terkait untuk rentang nomor sistem otonom privat.

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

    string

    No

    Parameter ini didukung saat membuat koneksi IPsec-VPN dalam mode single-tunnel.

    Jika instans gateway VPN saat ini adalah gateway VPN China Certified Cryptography, Anda harus mengonfigurasi sertifikat CA peer.

    • Untuk gateway VPN China Certified Cryptography, parameter ini wajib saat membuat koneksi IPsec-VPN.

    • Untuk gateway VPN Standard, parameter ini harus dikosongkan.

    -----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. Setelah ditentukan, kunci tag tidak boleh berupa string kosong.

    Kunci tag dapat terdiri dari maksimal 64 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Kunci tag tidak boleh berisi http:// atau https://.

    Anda dapat menentukan hingga 20 kunci tag sekaligus.

    TagKey
    Value

    string

    No

    Nilai tag.

    Nilai tag dapat terdiri dari maksimal 128 karakter dan boleh berupa string kosong. Nilai tag tidak boleh dimulai dengan aliyun atau acs: dan tidak boleh berisi http:// atau https://.

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

    TagValue
    TunnelOptionsSpecification

    array<object>

    No

    Konfigurasi saluran data.

    • Parameter di bawah array TunnelOptionsSpecification didukung saat membuat koneksi IPsec-VPN dalam mode dual-tunnel.

    • Saat membuat koneksi IPsec-VPN dalam mode dual-tunnel, Anda harus mengonfigurasi saluran data aktif dan cadangan untuk koneksi IPsec-VPN. Hanya dua saluran data (aktif dan cadangan) yang dapat ditambahkan ke koneksi IPsec-VPN.

    array<object>

    No

    Konfigurasi saluran data.

    CustomerGatewayId

    string

    No

    ID gateway pelanggan yang diasosiasikan dengan saluran data.

    Catatan

    • Parameter ini wajib saat membuat koneksi IPsec-VPN dalam mode dual-tunnel.

    • Parameter di bawah array TunnelOptionsSpecification didukung saat membuat koneksi IPsec-VPN dalam mode dual-tunnel.

    • Saat membuat koneksi IPsec-VPN dalam mode dual-tunnel, Anda harus mengonfigurasi saluran data aktif dan cadangan untuk koneksi IPsec-VPN. Hanya dua saluran data (aktif dan cadangan) yang dapat ditambahkan ke koneksi IPsec-VPN.

    cgw-p0wy363lucf1uyae8****
    EnableDpd

    boolean

    No

    Menentukan apakah fitur Pendeteksian Peer Mati (DPD) diaktifkan untuk saluran data. Nilai yang valid:

    • true (default): DPD diaktifkan. Inisiator IPsec mengirim paket DPD untuk memeriksa apakah perangkat peer masih aktif. Jika tidak ada respons yang benar diterima dalam periode yang ditentukan, peer dianggap terputus. SA ISAKMP dan SA IPsec terkait dihapus, dan saluran data keamanan juga dihapus.

    • false: DPD dinonaktifkan. Inisiator IPsec tidak mengirim paket probe DPD.

    true
    EnableNatTraversal

    boolean

    No

    Menentukan apakah fitur penelusuran NAT diaktifkan untuk saluran data. Nilai yang valid:

    • true (default): Penelusuran NAT diaktifkan. Setelah penelusuran NAT diaktifkan, proses negosiasi IKE menghapus verifikasi nomor port UDP dan dapat mendeteksi perangkat gerbang NAT dalam saluran data.

    • false: Penelusuran NAT dinonaktifkan.

    true
    RemoteCaCertificate

    string

    No

    Jika instans gateway VPN saat ini adalah gateway VPN China Certified Cryptography, Anda harus mengonfigurasi sertifikat CA peer untuk saluran data.

    • Untuk gateway VPN China Certified Cryptography, parameter ini wajib.

    • Untuk gateway VPN Standard, parameter ini harus dikosongkan.

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

    string

    No

    Peran saluran data. Nilai yang valid:

    • master: Saluran data adalah saluran data aktif.

    • slave: Saluran data adalah saluran data cadangan.

    master
    TunnelBgpConfig

    object

    No

    Konfigurasi BGP untuk saluran data.

    LocalAsn

    integer

    No

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

    Catatan

    • Parameter ini wajib setelah Anda mengaktifkan fitur BGP untuk koneksi IPsec-VPN (dengan mengatur EnableTunnelsBgp ke true).

    • Sebelum mengonfigurasi BGP, pelajari cara kerja fitur perutean dinamis BGP dan batasannya. Untuk informasi selengkapnya, lihat Konfigurasi perutean dinamis BGP.

    • Gunakan nomor sistem otonom privat untuk membuat koneksi BGP dengan Alibaba Cloud. Lihat dokumentasi terkait untuk rentang nomor sistem otonom privat.

    65530
    LocalBgpIp

    string

    No

    Alamat BGP di ujung lokal (sisi Alibaba Cloud) saluran data. Alamat ini merupakan alamat IP dalam blok CIDR BGP.

    169.254.10.1
    TunnelCidr

    string

    No

    Blok CIDR BGP saluran data. Blok CIDR harus merupakan blok CIDR dengan panjang masker 30 dalam rentang 169.254.0.0/16 dan tidak boleh 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 setiap saluran data di bawah instans gateway VPN harus unik.

    169.254.10.0/30
    TunnelIkeConfig

    object

    No

    Konfigurasi negosiasi Fase 1.

    IkeAuthAlg

    string

    No

    Algoritma autentikasi yang digunakan dalam negosiasi Fase 1.

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

    md5
    IkeEncAlg

    string

    No

    Algoritma enkripsi yang digunakan dalam negosiasi Fase 1.

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

    aes
    IkeLifetime

    integer

    No

    Masa berlaku SA yang dinegosiasikan dalam Fase 1. Satuan: detik.

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

    86400
    IkeMode

    string

    No

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

    • main: Mode utama. Proses negosiasi sangat aman.

    • aggressive: Mode agresif. Negosiasi cepat dan memiliki tingkat keberhasilan tinggi.

    main
    IkePfs

    string

    No

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

    group2
    IkeVersion

    string

    No

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

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

    ikev1
    LocalId

    string

    No

    Pengidentifikasi ujung lokal (sisi Alibaba Cloud) saluran data, yang digunakan dalam negosiasi Fase 1. Pengidentifikasi dapat terdiri dari maksimal 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 agar Anda mengatur mode negosiasi ke aggressive.

    47.21.XX.XX
    Psk

    string

    No

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

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

    • Jika Anda tidak menentukan kunci pra-bersama, sistem akan menghasilkan string acak sepanjang 16 karakter sebagai kunci pra-bersama. Anda dapat memanggil operasi DescribeVpnConnection untuk menanyakan kunci pra-bersama yang dihasilkan secara otomatis oleh sistem.

    Catatan

    Kunci pra-bersama saluran data dan peer saluran data harus sama. Jika tidak, saluran data tidak dapat dibuat.

    123456****
    RemoteId

    string

    No

    Pengidentifikasi peer saluran data, yang digunakan dalam negosiasi Fase 1. Pengidentifikasi dapat terdiri dari maksimal 100 karakter dan tidak boleh berisi spasi. Nilai default adalah alamat IP gateway pelanggan yang diasosiasikan dengan saluran data.

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

    47.42.XX.XX
    TunnelIpsecConfig

    object

    No

    Konfigurasi negosiasi Fase 2.

    IpsecAuthAlg

    string

    No

    Algoritma autentikasi yang digunakan dalam negosiasi Fase 2.

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

    md5
    IpsecEncAlg

    string

    No

    Algoritma enkripsi yang digunakan dalam negosiasi Fase 2.

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

    aes
    IpsecLifetime

    integer

    No

    Masa berlaku SA yang dinegosiasikan dalam Fase 2. Satuan: detik.

    Nilai yang 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 yang valid: disabled, group1, group2, group5, dan group14.

    group2
    EnableTunnelsBgp

    boolean

    No

    Parameter ini didukung saat membuat koneksi IPsec-VPN dalam mode dual-tunnel.

    Menentukan apakah BGP diaktifkan untuk saluran data. Nilai yang valid: true dan false (default).

    true
    DryRun

    boolean

    No

    Menentukan apakah akan melakukan dry run tanpa menjalankan permintaan sebenarnya. Nilai yang valid:

    • true: hanya melakukan dry run. Sistem memeriksa permintaan terhadap potensi masalah, termasuk nilai parameter yang hilang, sintaksis permintaan yang salah, dan batasan layanan. Jika permintaan gagal dalam dry run, kode kesalahan dikembalikan. Jika permintaan lolos dry run, kode kesalahan DryRunOperation dikembalikan.

    • false (default): melakukan dry run dan menjalankan permintaan sebenarnya. Jika permintaan lolos dry run, koneksi IPsec-VPN dibuat.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    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

    Stempel waktu saat koneksi IPsec-VPN dibuat. Satuan: milidetik.

    Stempel waktu mengikuti format Stempel waktu UNIX, yang merepresentasikan jumlah milidetik yang telah berlalu sejak 1 Januari 1970, 00:00:00 UTC.

    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. Gateway VPN tidak memiliki fitur IPsec-VPN yang diaktifkan.
    400 VpnRouteEntry.AlreadyExists The specified route entry is already exist. Entri rute sudah ada.
    400 VpnRouteEntry.Conflict The specified route entry has conflict. Pool IP klien yang ditentukan berkonflik dengan koneksi VPN atau server SSL.
    400 NotSupportVpnConnectionParameter.IpsecPfs The specified vpn connection ipsec Ipsec Pfs is not support. Parameter PFS yang ditentukan dalam koneksi IPsec-VPN tidak didukung.
    400 NotSupportVpnConnectionParameter.IpsecAuthAlg The specified vpn connection ipsec Auth Alg is not support. Algoritma autentikasi yang ditentukan dalam koneksi IPsec-VPN tidak didukung.
    400 VpnRouteEntry.ConflictSSL The specified route entry has conflict with SSL client. Entri rute berkonflik dengan klien SSL.
    400 VpnRouteEntry.BackupRoute Validate backup route entry failed. Validasi entri rute aktif/cadangan gagal.
    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 fitur 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 berbasis kebijakan telah mencapai batas atas. Jumlah saat ini adalah %s, jumlah yang akan dibuat adalah %s, dan batas atas 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. Wilayah saat ini tidak mendukung pengaktifan BGP.
    400 MissingParam.CustomerGatewayAsn Asn of customer gateway is mandatory when BGP is enabled. Nomor sistem otonom gerbang pelanggan tidak boleh kosong saat BGP diaktifkan.
    400 IllegalParam.LocalAsn The specified LocalAsn is invalid. Parameter LocalAsn 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. Saat BGP diaktifkan pada gateway VPN, BGP juga harus diaktifkan pada 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 peer (%s) tidak valid.
    400 OperationFailed.MissCertificate The VPN gateway has not associated any certificates. Koneksi VPN saat ini tidak dikaitkan dengan sertifikat apa pun.
    400 MissingParam.RemoteId The remote ID is mandatory when creating national standard VPN connection. ID remote diperlukan saat Anda membuat koneksi VPN ShangMi (SM).
    400 CustomerGateway.ConflictRouteEntry The specified customer gateway has conflict with route entry. Terdapat konflik antara gerbang pelanggan saat ini dan entri rute.
    400 VpnTask.CONFLICT Vpn task has conflict. Terdapat konflik operasi VPN. Coba lagi nanti.
    400 Forbidden.TagKey.Duplicated The specified tag key already exists. Sumber daya tag duplikat.
    400 SizeLimitExceeded.TagNum The maximum number of tags is exceeded. Jumlah tag 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 diasosiasikan dengan Gateway VPN dan gateway pelanggan yang sama. Kunci bersama dan parameter konfigurasi fase IKE dari koneksi IPsec-VPN ini harus sama.
    400 VpnConnectionParamInvalid.SameVpnAndCgwTrafficSelectorOverlap Traffic selectors of IPSec connections associated with the same user gateway and VPN gateway should not overlap. Beberapa koneksi IPsec-VPN diasosiasikan dengan Gateway VPN dan gateway pelanggan yang sama. Blok CIDR Trafik menarik 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. Alamat IP gerbang pelanggan bertabrakan dengan alamat IP 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 server SSL-VPN terkait 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 koneksi VPN dua saluran data.
    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. Validasi dry run berhasil.
    400 OperationFailed.OpenCdtServiceFirst The operation is failed because of %s. Tipe 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 gcm16 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, ASN harus dikonfigurasi 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 pada Gateway VPN ketika VPC tempat Gateway VPN berada telah bergabung dengan Instans CEN 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. EIP bukan milik pemanggil saat ini. Periksa apakah Anda memiliki izin untuk mengakses EIP ini.
    404 InvalidCustomerGatewayInstanceId.NotFound The specified customer gateway instance id does not exist. Instans gerbang pelanggan yang ditentukan tidak ada. Periksa apakah ID instans gerbang pelanggan 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.