CreateVpnGateway - VPN Gateway - Alibaba Cloud Documentation Center

Membuat gerbang VPN.

Deskripsi operasi

Sebelum membuat gerbang VPN, pahami batas gerbang VPN. Untuk informasi selengkapnya, lihat Batas gerbang VPN.
Di beberapa wilayah, Instans gerbang VPN hanya mendukung koneksi IPsec-VPN saluran data ganda secara default. Saat Anda memanggil operasi CreateVpnGateway di wilayah ini untuk membuat Instans gerbang VPN, Anda harus menentukan parameter VSwitchId dan DisasterRecoveryVSwitchId selain parameter yang diperlukan. Untuk informasi selengkapnya tentang wilayah dan zona yang mendukung koneksi IPsec-VPN saluran data ganda, lihat Meningkatkan koneksi IPsec-VPN ke mode saluran data ganda.
Operasi CreateVpnGateway bersifat asinkron. Sistem mengembalikan ID Instans, tetapi gerbang VPN belum dibuat dan tugas pembuatan masih berjalan di latar belakang. Anda dapat memanggil operasi DescribeVpnGateway untuk mengkueri status pembuatan gerbang VPN:
- Jika gerbang VPN berada dalam status provisioning, gerbang VPN sedang dibuat.
- Jika gerbang VPN berada dalam status active, gerbang VPN telah dibuat.

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:CreateVpnGateway

create

*VpnGateway.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	Wilayah tempat gerbang VPN berada. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
Name	string	No	Nama gerbang VPN. Nilai default: ID gerbang VPN. Panjang nama harus 2 hingga 100 karakter, dan tidak boleh diawali dengan `http://` atau `https://`. Nama harus diawali dengan huruf dan dapat berisi huruf, digit, garis bawah (_), tanda hubung (-), dan titik (.). Karakter khusus lainnya tidak didukung.	MYVPN
VpcId	string	Yes	ID VPC tempat gerbang VPN berada.	vpc-bp1ub1yt9cvakoelj****
InstanceChargeType	string	No	Metode penagihan gerbang VPN. Nilai valid: POSTPAY (metode penagihan pay-as-you-go).	Example value for the China site: PREPAY. Example value for the international site: POSTPAY
Period	integer	No	Durasi langganan. Unit: bulan. Nilai valid: 1 hingga 9, 12, 24, dan 36.	1
AutoPay	boolean	No	Apakah akan membayar Tagihan untuk gerbang VPN secara otomatis. Nilai valid: true: Membayar Tagihan untuk gerbang VPN secara otomatis. false (default): Tidak membayar Tagihan untuk gerbang VPN secara otomatis. Catatan Aktifkan pembayaran otomatis untuk berhasil membuat Instans gerbang VPN. Jika Anda menonaktifkan pembayaran otomatis, Anda harus membayar Tagihan secara manual untuk membuat Instans gerbang VPN.	false
Bandwidth	integer	Yes	Bandwidth gerbang VPN. Unit: Mbit/s. Jika Anda ingin membuat gerbang VPN Internet-public, nilai valid adalah 10, 100, 200, 500, dan 1000. Jika Anda ingin membuat gerbang VPN internal-public, nilai valid adalah 200 dan 1000. Catatan Di beberapa wilayah, bandwidth maksimum yang didukung oleh gerbang VPN adalah 500 Mbit/s. Untuk informasi selengkapnya, lihat Batas gerbang VPN.	5
EnableIpsec	boolean	No	Apakah akan mengaktifkan fitur IPsec-VPN. Nilai valid: true (default): Mengaktifkan fitur IPsec-VPN. false: Tidak mengaktifkan fitur IPsec-VPN.	true
EnableSsl	boolean	No	Apakah akan mengaktifkan fitur SSL-VPN. Nilai valid: true: Mengaktifkan fitur SSL-VPN. false (default): Tidak mengaktifkan fitur SSL-VPN.	false
SslConnections	integer	No	Jumlah maksimum koneksi SSL-VPN bersamaan. Nilai valid: 5 (default), 10, 20, 50, 100, 200, 500, dan 1000.	5
VSwitchId	string	No	ID vSwitch yang akan diasosiasikan dengan Instans gerbang VPN. Di wilayah yang mendukung koneksi IPsec-VPN saluran data ganda, parameter ini diperlukan. Anda harus menentukan vSwitch dan juga menentukan parameter DisasterRecoveryVSwitchId. Di wilayah yang mendukung koneksi IPsec-VPN saluran data tunggal, jika Anda tidak menentukan vSwitch, sistem akan secara otomatis memilih vSwitch di VPC.	vsw-bp1j5miw2bae9s2vt****
VpnType	string	No	Tipe gerbang VPN. Nilai valid: Normal (default): Standar.	Normal
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 permintaan yang berbeda. 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****
NetworkType	string	No	Jenis jaringan gerbang VPN. Nilai valid: public (default): gerbang VPN Internet-public. private: gerbang VPN internal-public.	public
DisasterRecoveryVSwitchId	string	No	ID vSwitch kedua yang akan diasosiasikan dengan Instans gerbang VPN. Parameter ini diperlukan jika wilayah saat ini mendukung koneksi IPsec-VPN mode saluran data ganda. Anda harus menentukan dua vSwitch yang diterapkan di zona berbeda dalam VPC tempat Instans gerbang VPN diasosiasikan untuk mengimplementasikan pemulihan bencana tingkat zona untuk koneksi IPsec-VPN. Untuk wilayah yang hanya mendukung satu zona, pemulihan bencana tingkat zona tidak didukung. Kami menyarankan Anda menentukan dua vSwitch berbeda di zona aktif untuk mengimplementasikan ketersediaan tinggi untuk koneksi IPsec-VPN. Anda juga dapat menentukan vSwitch yang sama. Untuk informasi selengkapnya tentang wilayah dan zona yang mendukung koneksi IPsec-VPN saluran data ganda, lihat Meningkatkan koneksi IPsec-VPN ke mode saluran data ganda.	vsw-p0wiz7obm0tbimu4r****
ResourceGroupId	string	No	ID kelompok sumber daya tempat gerbang VPN berada. Anda dapat memanggil operasi ListResourceGroups untuk mengkueri ID kelompok sumber daya. Jika Anda tidak menentukan ID kelompok sumber daya, gerbang VPN akan termasuk dalam kelompok sumber daya default setelah dibuat. Setelah gerbang VPN dibuat, jika Anda membuat server SSL, sertifikat klien SSL, server IPsec, atau koneksi IPsec-VPN (mengacu pada skenario di mana koneksi IPsec-VPN diasosiasikan dengan gerbang VPN) di bawah gerbang VPN, Sumber daya ini secara otomatis termasuk dalam kelompok sumber daya gerbang VPN dan tidak dapat dimodifikasi. Jika Anda mengubah kelompok sumber daya gerbang VPN, kelompok sumber daya dari Sumber daya sebelumnya juga akan berubah.	rg-acfmzs372yg****

Elemen respons

Element	Type	Description	Example
	object	Hasil yang dikembalikan.
VpnGatewayId	string	ID Instans gerbang VPN.	vpn-uf68lxhgr7ftbqr3p****
RequestId	string	ID permintaan.	EB2C156A-41F8-49CC-A756-D55AFC8BFD69
Name	string	Nama gerbang VPN.	MYVPN
OrderId	integer	ID pesanan. Jika Anda tidak mengaktifkan pembayaran otomatis untuk gerbang VPN, buka Biaya dan Penagihan untuk menyelesaikan pembayaran.	208240895400460

Contoh

Respons sukses

JSONformat

{
  "VpnGatewayId": "vpn-uf68lxhgr7ftbqr3p****",
  "RequestId": "EB2C156A-41F8-49CC-A756-D55AFC8BFD69",
  "Name": "MYVPN",
  "OrderId": 208240895400460
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidVpcId.NotFound	The specified VPC id does not exist in our records.
400	InvalidName	The specified value of Name not supported.
400	InvalidSpec.NotFound	The specified Spec does not exist in our records.
400	InvalidPeriod	The specified period is not valid
400	ChargeType.NotSupport	The specified charge type is not support.
400	InventoryNotEnough	The inventory is not enough.
400	UnnecessarySslConnection	The SSL connection is unnecessary for ssl vpn disabled.
400	InvalidVpnEnable	Either IPsec or SSL VPN must be set enable.
400	Resource.QuotaFull	The quota of resource is full
400	InvalidVSwitchId.NotFound	The specified vswitchId is not found.
400	OperationFailed.InventoryNotEnough	No enough available resource. Try another vswitch with different available zone.
400	Forbidden.OperateShareResource	Operating shared resources is forbidden.
400	OperationFailed.IpNotEnough	Operation failed because private ip address of the virtual switch is not enough.
400	Forbidden.NoSLRPermission	User not authorized to create service linked role.
400	OperationFailed.VSwitchConflict	The vswitch can't create vpn. Try another vswitch.
400	OperationFailed.AzNotSupport	Current available zone can't create vpn. Try another vswitch with different available zone.
400	OperationFailed.NetworkTypeNotMatch	Create NationalStandard vpn with private networkType is unsupported.
400	OperationFailed.SslNotSupport	Enable ssl vpn with private networkType is unsupported.	Gateway VPN jaringan pribadi tidak mendukung pengaktifan fitur SSL.
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	InvalidVSwitchId.FirstVswitchNotSupport	The available zone of vswitch1 not supported.	Zona tempat vSwitch primer berada tidak didukung.
400	InvalidVSwitchId.VswitchIdShouldDifferent	The VSwitch ids should be different.	Zona primer dan zona sekunder harus berbeda.
400	InvalidVSwitchId.FirstVswitchIpNotEnough	The ip of vswitch1 not enough.	Jumlah alamat IP aktif di vSwitch primer tidak mencukupi.
400	InvalidVSwitchId.SecondVswitchIpNotEnough	The ip of vswitch2 not enough.	Jumlah alamat IP yang tersedia di vSwitch sekunder tidak mencukupi.
400	InvalidVSwitchId.ZoneIdShouldDifferent	Two vSwitches should belong to different Availability Zones.	Dua vSwitch yang ditentukan saat membuat VPN dual-saluran data harus berada di zona yang berbeda.
400	MissingParam.VSwitchId	The parameter VSwitchId is missing.	Parameter VSwitchId tidak ada.
400	MissingParam.DisasterRecoveryVSwitchId	The parameter DisasterRecoveryVSwitchId is missing.	Parameter DisasterRecoveryVSwitchId tidak ada.
400	InvalidDisasterRecoveryVSwitchId.NotFound	The specified DisasterRecoveryVSwitchId does not exist in the specified region.	vSwitch yang ditentukan tidak ada di wilayah tersebut.
400	InvalidVSwitchId.SecondVswitchNotSupport	The zone of the DisasterRecoveryVSwitch does not support creating a ha-tunnel VPN.	Zona tempat vSwitch sekunder berada tidak didukung.
404	InvalidRegionId.NotFound	The specified region is not found during access authentication.	RegionId yang ditentukan tidak ada. Periksa apakah layanan ini tersedia di wilayah yang ditentukan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.