All Products
Search
Document Center

VPN Gateway:ModifyVpnConnectionAttribute

Last Updated:Oct 31, 2026

Mengubah konfigurasi koneksi IPsec-VPN.

Deskripsi operasi

  • Untuk mengubah koneksi IPsec-VPN dalam mode saluran data ganda, Anda dapat mengonfigurasi parameter permintaan berikut selain parameter wajib saat Anda memanggil operasi ModifyVpnConnectionAttribute:

    array ClientToken, Name, LocalSubnet, RemoteSubnet, EffectImmediately, AutoConfigRoute, TunnelOptionsSpecification, dan EnableTunnelsBgp.

  • Untuk mengubah koneksi IPsec-VPN dalam mode saluran data tunggal, Anda dapat mengonfigurasi parameter permintaan berikut selain parameter wajib saat Anda memanggil operasi ModifyVpnConnectionAttribute:

    ClientToken, Name, LocalSubnet, RemoteSubnet, EffectImmediately, IkeConfig, IpsecConfig, HealthCheckConfig, AutoConfigRoute, EnableDpd, EnableNatTraversal, BgpConfig, dan RemoteCaCertificate.

  • Operasi ModifyVpnConnectionAttribute bersifat asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID permintaan, tetapi konfigurasi koneksi IPsec-VPN tidak langsung diubah. Node modifikasi masih berjalan di latar belakang. Anda dapat memanggil operasi DescribeVpnGateway untuk mengkueri status instans dari instans Gateway VPN dan memeriksa status modifikasi konfigurasi koneksi IPsec-VPN:

    • Jika Gateway VPN berada dalam status updating, konfigurasi koneksi IPsec-VPN sedang diubah.

    • Jika Gateway VPN berada dalam status active, konfigurasi koneksi IPsec-VPN telah diubah.

  • Operasi ModifyVpnConnectionAttribute tidak mendukung modifikasi konkuren konfigurasi koneksi IPsec-VPN 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:ModifyVpnConnectionAttribute

update

*VpnConnection

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

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 membuat 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 bersifat unik.

02fb3da4-130e-11e9-8e44-0016e04115b

VpnConnectionId

string

Yes

ID koneksi IPsec-VPN.

vco-bp1bbi27hojx80nck****

Name

string

No

Nama koneksi IPsec-VPN.

Nama harus terdiri dari 1 hingga 100 karakter, dan tidak boleh diawali dengan http:// atau https://.

nametest

LocalSubnet

string

No

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.

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 yang diminati digunakan.

10.1.1.0/24,10.1.2.0/24

RemoteSubnet

string

No

Blok CIDR di sisi Pusat data lokal. Parameter ini digunakan untuk negosiasi Fase 2.

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

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 yang diminati digunakan.

10.2.1.0/24,10.2.2.0/24

EffectImmediately

boolean

No

Apakah konfigurasi koneksi IPsec-VPN langsung berlaku. Nilai valid:

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

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

false

IkeConfig

string

No

Parameter ini didukung saat Anda mengubah koneksi IPsec-VPN dalam mode saluran data tunggal.

Konfigurasi negosiasi Fase 1:

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

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

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

    Catatan

    Kunci bersama di sisi koneksi IPsec-VPN harus cocok dengan kunci otentikasi 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.

    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 valid: main dan aggressive.

    • main: Mode utama. Proses negosiasi sangat aman.

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

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

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

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

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

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

  • IkeConfig.IkeLifetime: Masa berlaku SA yang ditentukan oleh negosiasi Fase 1. Unit: detik. Nilai valid: 0 hingga 86400.

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

  • IkeConfig.RemoteId: Pengidentifikasi gateway pelanggan. Pengidentifikasi dapat terdiri dari hingga 100 karakter dan tidak boleh berisi spasi. Nilai default adalah alamat IP gateway pelanggan.

{"Psk":"pgw6dy7d1i8i****","IkeVersion":"ikev1","IkeMode":"main","IkeEncAlg":"aes","IkeAuthAlg":"sha1","IkePfs":"group2","IkeLifetime":86400,"LocalId":"116.64.XX.XX","RemoteId":"139.18.XX.XX"}

IpsecConfig

string

No

Parameter ini didukung saat Anda mengubah koneksi IPsec-VPN dalam mode saluran data tunggal.

Konfigurasi untuk negosiasi Fase 2:

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

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

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

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

  • IpsecConfig.IpsecPfs: Algoritma pertukaran kunci Diffie-Hellman yang digunakan dalam negosiasi Fase 1 untuk meneruskan paket dari semua protokol. Nilai valid: disabled, group1, group2, group5, dan group14.

  • IpsecConfig.IpsecLifetime: Masa berlaku SA yang ditentukan oleh negosiasi Fase 2. Unit: detik. Nilai valid: 0 hingga 86400.

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

HealthCheckConfig

string

No

Parameter ini didukung saat Anda mengubah koneksi IPsec-VPN dalam mode saluran data tunggal.

Konfigurasi Pemeriksaan kesehatan:

  • HealthCheckConfig.enable: Apakah akan mengaktifkan Pemeriksaan kesehatan. Nilai valid: true dan false.

  • 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.

  • HealthCheckConfig.retry: Jumlah maksimum percobaan ulang Pemeriksaan kesehatan.

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

AutoConfigRoute

boolean

No

Apakah akan memublikasikan entri rute secara otomatis. Nilai valid:

  • true: Memublikasikan entri rute secara otomatis.

  • false: Tidak memublikasikan entri rute secara otomatis.

true

EnableDpd

boolean

No

Parameter ini didukung saat Anda mengubah koneksi IPsec-VPN dalam mode saluran data tunggal.

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

  • true: Mengaktifkan fitur DPD. Inisiator IPsec mengirim paket DPD untuk memeriksa apakah perangkat peer masih 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 mengirim paket probe DPD.

true

EnableNatTraversal

boolean

No

Parameter ini didukung saat Anda mengubah koneksi IPsec-VPN dalam mode saluran data tunggal.

Apakah akan mengaktifkan fitur penelusuran NAT. Nilai valid:

  • true: Mengaktifkan fitur penelusuran NAT. Setelah fitur ini diaktifkan, proses negosiasi IKE melewati 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 mengubah koneksi IPsec-VPN dalam mode saluran data tunggal.

Konfigurasi BGP:

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

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

    Anda dapat memasukkan ASN dalam format dua bagian: 16 bit pertama dan 16 bit terakhir, dipisahkan oleh periode. Setiap bagian 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 berupa subnet dengan panjang mask 30 dalam 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 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
  • Parameter ini wajib diisi saat fitur perutean dinamis BGP diaktifkan untuk Gateway VPN.

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

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

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

RemoteCaCertificate

string

No

Parameter ini didukung saat Anda mengubah koneksi IPsec-VPN dalam mode saluran data tunggal.

Jika Gateway VPN saat ini adalah Gateway VPN SM, Anda dapat mengubah sertifikat CA dari peer.

Jika Gateway VPN saat ini adalah Gateway VPN standar, parameter ini tidak didukung.

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

TunnelOptionsSpecification

array<object>

No

Konfigurasi saluran data.

Parameter dalam array TunnelOptionsSpecification hanya didukung saat Anda mengubah koneksi IPsec-VPN dalam mode saluran data ganda. Anda dapat mengubah konfigurasi saluran data utama dan sekunder dari koneksi IPsec-VPN secara bersamaan.

array<object>

No

Konfigurasi saluran data.

TunnelId

string

No

ID saluran data.

tun-opsqc4d97wni27****

CustomerGatewayId

string

No

ID instans dari instans gateway pelanggan yang terkait dengan saluran data.

cgw-1nmwbpgrp7ssqm1yn****

Role

string

No

Peran saluran data.

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

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

master

EnableDpd

boolean

No

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

  • true: Mengaktifkan fitur DPD. Inisiator IPsec mengirim paket DPD untuk memeriksa apakah perangkat peer masih 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 mengirim paket probe DPD.

true

EnableNatTraversal

boolean

No

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

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

  • false: Menonaktifkan fitur penelusuran NAT.

true

RemoteCaCertificate

string

No

Jika Gateway VPN saat ini adalah Gateway VPN SM, Anda dapat mengubah sertifikat CA dari peer untuk saluran data.

Jika Gateway VPN saat ini adalah Gateway VPN standar, parameter ini tidak didukung.

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

TunnelBgpConfig

object

No

Konfigurasi BGP saluran data.

LocalAsn

integer

No

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

Catatan
  • Parameter ini hanya dapat dikonfigurasi atau diubah setelah Anda mengaktifkan fitur BGP untuk koneksi IPsec-VPN (yaitu, mengatur EnableTunnelsBgp ke true).

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

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

65530

LocalBgpIp

string

No

Alamat IP BGP di sisi Alibaba Cloud dari 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 berupa subnet dengan panjang mask 30 dalam 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 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 yang digunakan dalam negosiasi Fase 1.

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

md5

IkeEncAlg

string

No

Algoritma enkripsi yang digunakan dalam negosiasi Fase 1.

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

aes

IkeLifetime

integer

No

Masa berlaku SA yang ditentukan oleh negosiasi Fase 1. Unit: detik. Nilai valid: 0 hingga 86400.

86400

IkeMode

string

No

Mode negosiasi versi IKE. Nilai valid:

  • main: Mode utama. Proses negosiasi sangat aman.

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

main

IkePfs

string

No

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

group2

IkeVersion

string

No

Versi protokol IKE. Nilai valid: ikev1 dan ikev2.

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

ikev1

LocalId

string

No

Pengidentifikasi di sisi Alibaba Cloud dari saluran data, yang digunakan untuk negosiasi Fase 1. Pengidentifikasi dapat terdiri dari hingga 100 karakter dan tidak boleh berisi spasi. Nilai default adalah alamat IP saluran data.

LocalId mendukung format FQDN. Jika Anda menggunakan format FQDN, atur mode negosiasi ke aggressive.

47.21.XX.XX

Psk

string

No

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

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

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

Catatan

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

123456****

RemoteId

string

No

Pengidentifikasi peer, yang digunakan untuk negosiasi Fase 1. Pengidentifikasi dapat terdiri dari hingga 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, atur mode negosiasi ke aggressive.

47.42.XX.XX

TunnelIpsecConfig

object

No

Konfigurasi untuk negosiasi Fase 2.

IpsecAuthAlg

string

No

Algoritma autentikasi yang digunakan dalam negosiasi Fase 2.

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

md5

IpsecEncAlg

string

No

Algoritma enkripsi yang digunakan dalam negosiasi Fase 2.

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

aes

IpsecLifetime

integer

No

Masa berlaku SA yang ditentukan oleh negosiasi Fase 2. Unit: detik. Nilai valid: 0 hingga 86400.

86400

IpsecPfs

string

No

Algoritma pertukaran kunci Diffie-Hellman yang digunakan dalam negosiasi Fase 2.

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

group2

EnableTunnelsBgp

boolean

No

Parameter ini didukung saat Anda mengubah koneksi IPsec-VPN dalam mode saluran data ganda.

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

true

Elemen respons

Element

Type

Description

Example

object

Tanggapan.

EnableNatTraversal

boolean

Apakah Penelusuran NAT diaktifkan untuk koneksi IPsec-VPN. Nilai valid:

  • false: Penelusuran NAT dinonaktifkan.

  • true: Penelusuran NAT diaktifkan.

Parameter ini hanya dikembalikan untuk koneksi IPsec-VPN dalam mode saluran data tunggal.

true

CreateTime

integer

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

Pengatur waktu dalam format UNIX, yang menunjukkan jumlah total milidetik yang telah berlalu sejak 00:00:00 UTC pada 1 Januari 1970.

1492753817000

EffectImmediately

boolean

Apakah konfigurasi koneksi IPsec-VPN langsung berlaku. Nilai valid:

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

  • false: Tidak. Sistem hanya memulai negosiasi IPsec ketika trafik masuk ke koneksi.

false

VpnGatewayId

string

ID gerbang VPN.

vpn-bp1q8bgx4xnkm2ogj****

LocalSubnet

string

Blok CIDR di sisi VPC.

10.1.1.0/24,10.1.2.0/24

RequestId

string

ID permintaan.

7DB79D0C-5F27-4AB5-995B-79BE55102F90

VpnConnectionId

string

ID koneksi IPsec-VPN.

vco-bp1bbi27hojx80nck****

Description

string

Deskripsi koneksi IPsec-VPN.

description

RemoteSubnet

string

Blok CIDR pusat data lokal.

10.2.1.0/24,10.2.2.0/24

CustomerGatewayId

string

ID gerbang pelanggan yang terkait dengan koneksi IPsec-VPN.

Parameter ini hanya dikembalikan untuk koneksi IPsec-VPN dalam mode saluran data tunggal.

cgw-p0w2jemrcj5u61un8****

Name

string

Nama koneksi IPsec-VPN.

nametest

EnableDpd

boolean

Apakah dead peer detection (DPD) diaktifkan untuk koneksi IPsec-VPN. Nilai valid:

  • false: DPD dinonaktifkan.

  • true: DPD diaktifkan.

Parameter ini hanya dikembalikan untuk koneksi IPsec-VPN dalam mode saluran data tunggal.

true

IkeConfig

object

Konfigurasi negosiasi Fase 1.

Parameter dalam array IkeConfig hanya dikembalikan untuk koneksi IPsec-VPN dalam mode saluran data tunggal.

RemoteId

string

Pengenal pusat data lokal. FQDN dan alamat IP didukung (Port). Secara default, parameter ini diatur ke alamat IP gerbang pelanggan yang dipilih.

139.18.XX.XX

IkeLifetime

integer

pengatur waktu IKE SA. Unit: detik.

86400

IkeEncAlg

string

Algoritma enkripsi untuk negosiasi Fase 1.

aes

LocalId

string

Pengenal VPC. FQDN dan alamat IP didukung (Port). Secara default, parameter ini diatur ke alamat IP gerbang VPN yang dipilih.

116.64.XX.XX

IkeMode

string

Mode negosiasi IKE. Nilai valid:

  • main: Mode utama. Mode ini memberikan keamanan tinggi selama negosiasi.

  • aggressive: Mode agresif. Mode ini memiliki fitur negosiasi yang lebih cepat dan laju keberhasilan yang lebih tinggi.

main

IkeVersion

string

Versi IKE. Nilai valid:

  • ikev1

  • ikev2

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

ikev1

IkePfs

string

Kelompok Diffie-Hellman (DH) untuk negosiasi Fase 1.

group2

Psk

string

Kunci bersama.

pgw6dy7d1i8i****

IkeAuthAlg

string

algoritma autentikasi untuk negosiasi Fase 1.

sha1

IpsecConfig

object

Konfigurasi negosiasi Fase 2.

Parameter dalam array IpsecConfig hanya dikembalikan untuk koneksi IPsec-VPN dalam mode saluran data tunggal.

IpsecAuthAlg

string

algoritma autentikasi untuk negosiasi Fase 2.

sha1

IpsecLifetime

integer

pengatur waktu IPsec SA. Unit: detik.

86400

IpsecEncAlg

string

Algoritma enkripsi untuk negosiasi Fase 2.

aes

IpsecPfs

string

Kelompok DH untuk negosiasi Fase 2.

group2

VcoHealthCheck

object

Konfigurasi Pemeriksaan kesehatan.

Parameter dalam array VcoHealthCheck hanya dikembalikan untuk koneksi IPsec-VPN dalam mode saluran data tunggal.

Dip

string

Alamat IP tujuan.

192.168.1.1

Interval

integer

Interval percobaan ulang untuk Pemeriksaan kesehatan. Unit: detik.

3

Retry

integer

Jumlah percobaan ulang Pemeriksaan kesehatan.

3

Sip

string

Alamat IP sumber.

10.1.1.1

Enable

string

Apakah fitur Pemeriksaan kesehatan diaktifkan untuk koneksi IPsec-VPN. Nilai valid:

  • true: Fitur Pemeriksaan kesehatan diaktifkan.

  • false: Fitur Pemeriksaan kesehatan dinonaktifkan.

true

VpnBgpConfig

object

Konfigurasi BGP.

Parameter dalam array VpnBgpConfig hanya dikembalikan untuk koneksi IPsec-VPN dalam mode saluran data tunggal.

Status

string

Status negosiasi BGP. Nilai valid:

  • success: Normal.

  • false: Abnormal.

success

PeerBgpIp

string

Alamat IP BGP di sisi pusat data lokal.

169.254.11.2

TunnelCidr

string

Blok CIDR BGP koneksi IPsec-VPN.

169.254.11.0/30

EnableBgp

string

Status aktif BGP. Nilai valid:

  • true: BGP diaktifkan.

  • false: BGP dinonaktifkan.

true

LocalBgpIp

string

Alamat IP BGP di sisi Alibaba Cloud.

169.254.11.1

PeerAsn

integer

Nomor sistem otonom (ASN) pusat data lokal.

65531

LocalAsn

integer

Nomor sistem otonom di sisi Alibaba Cloud.

65530

TunnelOptionsSpecification

object

TunnelOptions

array<object>

Konfigurasi saluran data koneksi IPsec-VPN.

Parameter dalam array TunnelOptionsSpecification hanya dikembalikan untuk koneksi IPsec-VPN dalam mode dual-tunnel.

array<object>

Konfigurasi saluran data.

CustomerGatewayId

string

ID gerbang pelanggan yang terkait dengan saluran data.

cgw-p0wy363lucf1uyae8****

EnableDpd

boolean

Apakah DPD diaktifkan untuk saluran data. Nilai valid:

  • false: DPD dinonaktifkan.

  • true: DPD diaktifkan.

true

EnableNatTraversal

boolean

Apakah Penelusuran NAT diaktifkan untuk saluran data. Nilai valid:

  • false: Penelusuran NAT dinonaktifkan.

  • true: Penelusuran NAT diaktifkan.

true

InternetIp

string

Alamat IP gerbang di sisi Alibaba Cloud untuk saluran data.

47.21.XX.XX

RemoteCaCertificate

string

Sertifikat CA dari ujung peer saluran data.

Parameter ini hanya dikembalikan ketika gerbang VPN bertipe SM.

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

Role

string

Peran saluran data.

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

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

master

State

string

Status saluran data. Nilai valid:

  • active: Saluran data berfungsi dengan baik.

  • updating: Saluran data sedang diperbarui.

  • deleting: Saluran data sedang dihapus.

active

TunnelBgpConfig

object

Konfigurasi BGP saluran data.

LocalAsn

integer

Nomor sistem otonom ujung lokal (sisi Alibaba Cloud) saluran data.

65530

LocalBgpIp

string

Alamat IP BGP ujung lokal (sisi Alibaba Cloud) saluran data.

169.254.10.1

PeerAsn

integer

Nomor sistem otonom ujung peer saluran data.

65531

PeerBgpIp

string

Alamat IP BGP ujung peer saluran data.

169.254.10.2

TunnelCidr

string

Blok CIDR BGP saluran data.

169.254.10.0/30

TunnelId

string

ID saluran data.

tun-opsqc4d97wni27****

TunnelIkeConfig

object

Konfigurasi negosiasi Fase 1.

IkeAuthAlg

string

algoritma autentikasi untuk negosiasi Fase 1.

sha1

IkeEncAlg

string

Algoritma enkripsi untuk negosiasi Fase 1.

aes

IkeLifetime

integer

pengatur waktu IKE SA. Unit: detik.

86400

IkeMode

string

Mode negosiasi IKE. Nilai valid:

  • main: Mode utama. Mode ini memberikan keamanan tinggi selama negosiasi.

  • aggressive: Mode agresif. Mode ini memiliki fitur negosiasi yang lebih cepat dan laju keberhasilan yang lebih tinggi.

main

IkePfs

string

Kelompok Diffie-Hellman (DH) untuk negosiasi Fase 1.

group2

IkeVersion

string

Versi IKE.

ikev1

LocalId

string

Identifier ujung lokal (sisi Alibaba Cloud) saluran data.

47.21.XX.XX

Psk

string

Kunci bersama.

123456****

RemoteId

string

Identifier ujung peer saluran data.

47.42.XX.XX

TunnelIpsecConfig

object

Konfigurasi negosiasi Fase 2.

IpsecAuthAlg

string

algoritma autentikasi untuk negosiasi Fase 2.

sha1

IpsecEncAlg

string

Algoritma enkripsi untuk negosiasi Fase 2.

aes

IpsecLifetime

integer

pengatur waktu IPsec SA. Unit: detik.

86400

IpsecPfs

string

Kelompok DH untuk negosiasi Fase 2.

group2

ZoneNo

string

Zona tempat saluran data diterapkan.

ap-southeast-5a

EnableTunnelsBgp

boolean

Status aktif BGP untuk saluran data. Nilai valid:

  • true: BGP diaktifkan.

  • false: BGP dinonaktifkan.

Parameter ini hanya dikembalikan untuk koneksi IPsec-VPN dalam pola dual-tunnel.

true

ResourceGroupId

string

ID kelompok sumber daya tempat koneksi IPsec-VPN berada.

Koneksi IPsec-VPN berada dalam kelompok sumber daya yang sama dengan gerbang VPN terkait. Anda dapat memanggil operasi ListResourceGroups untuk mengkueri informasi kelompok sumber daya (format).

rg-acfmzs372yg****

Contoh

Respons sukses

JSONformat

{
  "EnableNatTraversal": true,
  "CreateTime": 1492753817000,
  "EffectImmediately": false,
  "VpnGatewayId": "vpn-bp1q8bgx4xnkm2ogj****",
  "LocalSubnet": "10.1.1.0/24,10.1.2.0/24",
  "RequestId": "7DB79D0C-5F27-4AB5-995B-79BE55102F90",
  "VpnConnectionId": "vco-bp1bbi27hojx80nck****",
  "Description": "description",
  "RemoteSubnet": "10.2.1.0/24,10.2.2.0/24",
  "CustomerGatewayId": "cgw-p0w2jemrcj5u61un8****",
  "Name": "nametest",
  "EnableDpd": true,
  "IkeConfig": {
    "RemoteId": "139.18.XX.XX",
    "IkeLifetime": 86400,
    "IkeEncAlg": "aes",
    "LocalId": "116.64.XX.XX",
    "IkeMode": "main",
    "IkeVersion": "ikev1",
    "IkePfs": "group2",
    "Psk": "pgw6dy7d1i8i****",
    "IkeAuthAlg": "sha1"
  },
  "IpsecConfig": {
    "IpsecAuthAlg": "sha1",
    "IpsecLifetime": 86400,
    "IpsecEncAlg": "aes",
    "IpsecPfs": "group2"
  },
  "VcoHealthCheck": {
    "Dip": "192.168.1.1",
    "Interval": 3,
    "Retry": 3,
    "Sip": "10.1.1.1",
    "Enable": "true"
  },
  "VpnBgpConfig": {
    "Status": "success",
    "PeerBgpIp": "169.254.11.2",
    "TunnelCidr": "169.254.11.0/30",
    "EnableBgp": "true",
    "LocalBgpIp": "169.254.11.1",
    "PeerAsn": 65531,
    "LocalAsn": 65530
  },
  "TunnelOptionsSpecification": {
    "TunnelOptions": [
      {
        "CustomerGatewayId": "cgw-p0wy363lucf1uyae8****",
        "EnableDpd": true,
        "EnableNatTraversal": true,
        "InternetIp": "47.21.XX.XX",
        "RemoteCaCertificate": "-----BEGIN CERTIFICATE----- MIIB7zCCAZW**** -----END CERTIFICATE-----",
        "Role": "master",
        "State": "active",
        "TunnelBgpConfig": {
          "LocalAsn": 65530,
          "LocalBgpIp": "169.254.10.1",
          "PeerAsn": 65531,
          "PeerBgpIp": "169.254.10.2",
          "TunnelCidr": "169.254.10.0/30"
        },
        "TunnelId": "tun-opsqc4d97wni27****",
        "TunnelIkeConfig": {
          "IkeAuthAlg": "sha1",
          "IkeEncAlg": "aes",
          "IkeLifetime": 86400,
          "IkeMode": "main",
          "IkePfs": "group2",
          "IkeVersion": "ikev1",
          "LocalId": "47.21.XX.XX",
          "Psk": "123456****",
          "RemoteId": "47.42.XX.XX"
        },
        "TunnelIpsecConfig": {
          "IpsecAuthAlg": "sha1",
          "IpsecEncAlg": "aes",
          "IpsecLifetime": 86400,
          "IpsecPfs": "group2"
        },
        "ZoneNo": "ap-southeast-5a"
      }
    ]
  },
  "EnableTunnelsBgp": true,
  "ResourceGroupId": "rg-acfmzs372yg****"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 VpnGateway.Configuring The specified service is configuring.
400 VpnGateway.FinancialLocked The specified service is financial locked.
400 InvalidName The name is not valid
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 QuotaExceeded.PBR The policy-based routes has reached the upper limit. Jumlah entri rute kebijakan telah mencapai batas maksimum.
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.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.
400 InvalidTunnelCidr.Malformed The specified TunnelCidr is malformed. Blok CIDR saluran data yang ditentukan tidak valid.
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 OperationFailed.RouteConflictWithIPsecServer Operation failed because the route to create conflicts with the client IP pool of the IPsec server. Blok CIDR tujuan entri rute bertentangan dengan blok CIDR klien Server IPsec.
400 IllegalParam.TunnelId The specified TunnelId is invalid. Parameter TunnelId tidak valid.
400 IllegalParam.Role The specified Role is invalid. Parameter Role 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 ModifyIkeV1WithMultiRoutes.Invalid Failed to modify VPN connection parameters. Multi-network is configured while using IkeV1 protocol. Gagal mengubah parameter koneksi VPN-VPN. Beberapa segmen jaringan dikonfigurasi saat IKEv1 sedang digunakan.
400 Vco.StatusNotSupport The current VPN connection state does not support this operation. Status instans saat ini tidak mendukung operasi ini.
400 IkeVersionInvalid.GcmIncompatible Ikev1 does not support IkeEncAlg of gcm16. IKEv1 tidak mendukung konfigurasi hanya algoritma GCM-16 sebagai algoritma enkripsi IKE.
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 CustomerGateway.ConflictVpnIp The specified customer gateway has conflict with vpn gateway ip. Gateway pelanggan yang terkait dengan koneksi IPsec-VPN tidak boleh memiliki alamat IP gerbang yang sama dengan Gateway VPN.
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.
500 OperationFailed.RouteConflictWithIPsecServer Operation failed because the specified route conflicts with IPsec server. Blok CIDR tujuan entri rute bertentangan dengan blok CIDR klien Server IPsec.
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 InvalidVpnConnectionInstanceId.NotFound The specified vpn connection instance id does not exist. Koneksi IPsec-VPN yang ditentukan tidak ada. Periksa apakah ID koneksi VPN benar.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.