PublishVpnRouteEntry - VPN Gateway - Alibaba Cloud Documentation Center

Memanggil operasi PublishVpnRouteEntry untuk menerbitkan entri rute tujuan atau entri rute kebijakan ke tabel rute sistem VPC, atau menarik entri rute tujuan atau entri rute kebijakan yang telah diterbitkan dari tabel rute sistem VPC.

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

update

*VpnGateway

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah instans Gateway VPN. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Nilai parameter ini dihasilkan oleh klien. Pastikan nilai tersebut unik di antara permintaan yang berbeda. Panjang maksimum adalah 64 karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dari setiap permintaan API berbeda.	d7d24a21-f4ba-4454-9173-b382****
VpnGatewayId	string	Yes	ID instans Gateway VPN.	vpn-bp1a3kqjiiq9legfx****
RouteDest	string	Yes	Blok CIDR tujuan entri rute Gateway VPN.	10.0.0.0/24
NextHop	string	Yes	Lompatan berikutnya entri rute Gateway VPN.	vco-bp15oes1py4i66rmd****
RouteType	string	Yes	Tipe entri rute Gateway VPN. Nilai valid: pbr: Rute berbasis kebijakan. dbr: Rute berbasis tujuan.	pbr
PublishVpc	boolean	Yes	Apakah akan menerbitkan atau menarik rute. Nilai valid: true: Menerbitkan rute. Jika parameter ini diatur ke true, rute tujuan atau rute kebijakan diterbitkan ke tabel rute sistem VPC. false: Menarik rute. Jika parameter ini diatur ke false, rute tujuan atau rute kebijakan yang telah diterbitkan ditarik dari tabel rute sistem VPC. Catatan Jika tabel rute kebijakan dan tabel rute tujuan berisi entri rute dengan blok CIDR tujuan yang sama, dan kedua entri rute diterbitkan ke VPC yang sama, saat Anda menarik entri rute dari tabel rute kebijakan, entri rute di tabel rute tujuan juga akan ditarik. Saat Anda menarik entri rute dari tabel rute tujuan, entri rute di tabel rute kebijakan juga akan ditarik.	true

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	5BE01CD7-5A50-472D-AC14-CA181C5C03BE

Contoh

Respons sukses

JSONformat

{
  "RequestId": "5BE01CD7-5A50-472D-AC14-CA181C5C03BE\t"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Resource.QuotaFull	The quota of resource is full
400	VpnGateway.Configuring	The specified service is configuring.
400	VpnGateway.FinancialLocked	The specified service is financial locked.
400	VpnRouteEntry.AlreadyExists	The specified route entry is already exist.	Rute sudah ada.
400	VpnRouteEntry.Conflict	The specified route entry has conflict.	Entri rute saling bertentangan.
400	InvalidVpnRouteEntry.NotFound	The specified route entry does not exist.	Entri rute yang ditentukan tidak ada.
400	OperationFailed.InvalidStatus	Route entry is not allowed to operate in current status.	Entri rute tidak dapat dioperasikan dalam status saat ini.
400	OperationFailed.RouteConflict	Operation failed because there is already a route in VPC route table to another VPN on the same network block.	Rute yang mengarah ke gateway VPN lain pada blok CIDR yang sama sudah ada di tabel rute VPC.
400	OperationFailed.InvalidCidrBlock	Operation failed because the specified network block is invalid.	Blok CIDR tidak valid.
400	QuotaExceeded.VpnRouteEntry	The number of route entries to the VPN gateway in the VPC routing table has reached the quota limit.	Jumlah entri rute yang mengarah ke gateway VPN di tabel rute VPC telah mencapai batas kuota.
400	TaskConflict	The operation is too frequent, please wait a moment and try again.	Operasi terlalu sering. Tunggu sebentar dan coba lagi.
400	IllegalParam.CidrBlock	The specified CidrBlock is illegal.	Parameter CidrBlock tidak valid.
400	QuotaExceeded	Route entry quota exceeded in this route table.
400	MissingParameter	Miss mandatory parameter.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	InvalidCIDRBlock.Duplicate	Specified CIDR block is already exists.
400	IncorrectVpcStatus	Current VPC status does not support this operation.
400	IncorrectInstanceStatus	Current instance status does not support this operation.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	IncorrectVSwitchStatus	The current virtual switch status does not support this operation.	vSwitch dalam status pending dan tidak dapat dihapus.
400	InvalidCidrBlock	Specified CIDR block is not valid.	Kemungkinan penyebab: 1. Anda tidak berada dalam daftar putih blok CIDR rute 10.0.0.0/8 dan tidak dapat menggunakan blok CIDR ini. 2. Blok CIDR tujuan dari rute kustom yang Anda tambahkan tidak boleh termasuk dalam blok CIDR semua vSwitch di VPC yang sama. 3. 100.64.0.0/10 adalah alamat layanan cloud. Oleh karena itu, Anda tidak dapat menambahkan blok CIDR ini untuk mengarah ke pusat data on-premises. 4. Kecuali 100.64.0.0/10, blok CIDR rute yang lebih spesifik seperti 100.64.0.0/11 dan 100.96.0.0/11 tidak dapat digunakan di pusat data on-premises.
400	InvalidNextHopType	Specified parameter "NextHopType" is not valid
400	InvalidNextHop.NotFound	Specified next hop does not exist.
400	InvalidVRouter.NotFound	vRouter not exists.
400	InvalidVPC.NotFound	vpc not exists.
400	InvalidNexthopTypeAndList.BothNull	both nexthopType and nextHopList are null.
400	InvalidNexthopTypeAndList.BothNotNull	both nexthopType and nextHopList are not null.
400	InvalidRouterInterface	invalid router interface.
400	InvalidOppositeRouterType	nexthop list cannot only contain router interface whose opposite router interface is on vbr.
400	InvalidNexthopListSize	nexthop size is illegal. Must be between 2 and 4.	Anda harus menentukan 2 hingga 4 antarmuka router sebagai hop berikutnya.
400	InvalidEntryRuleQuota.NotFound	Route entry quota rule not exists.
400	Forbidden.CheckEntryRuleQuota	Route entry quota rule check error.
400	InvalidVBRStatus	invalid virtual border router status.
400	InvalidPhysicalConnectionBusinessStatus	invalid physical connection business status.
400	IncorrectHaVipStatus	This operation is denied because satus of the specified HaVip is neither Available nor InUse.	Operasi tidak dapat dilakukan karena status HaVip bukan Available maupun InUse.
400	CountLimitExceed.HaVipRouteEntry	There can be 5 route entry to HaVip at most in one route table.	Jumlah entri rute yang mengarah ke instans HaVip telah mencapai batas atas.
400	InvalidRouteEntry.Duplicate	The route entry already exist.
400	INVALID_WEIGHT_PARAM	Specified value of weight invalid
400	FORBIDDEN_USE_VPC_AS_INTERNET_GATEWAY	The Specified CIDR must be in vpc CIDR.
400	INVALID_VPC_ID	The Specified VpcId not match.	VPC tidak ada. Periksa apakah ID VPC valid.
400	InvalidRouteEntrySize	The Specified routerEntry size not legal.	Anda harus menentukan 2 hingga 4 antarmuka router sebagai hop berikutnya dari rute ECMP.
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.	Terdapat konflik rute di tabel rute.
400	InvalidRouteEntryName.Malformed	Specified RouteEntry name is not valid.	Modifikasi gagal karena nama entri rute yang ditentukan tidak valid.
400	Duplicated.VpcNextHop	Route entry nexthop duplicate.	Hop berikutnya dari entri rute adalah duplikat.
400	InvalidNexthop.DirectEni	The direct Eni cannot be nexthop.	ENI langsung tidak dapat digunakan sebagai hop berikutnya.
400	InvalidAttachment.NotFound	The attachment is not found.	Lampiran tidak ada.
400	OperationFailed.ActiveNetworkInterfaceNotFound	No active network interface is found on the attachment.	Tidak ada ENI yang tersedia pada lampiran.
400	InvalidNetworkInterface.NotFound	The network interface is not found on the attachment.	ENI pada lampiran tidak ada.
400	OperationFailed.QueryAttachmentInfo	Failed to query attachment information.	Gagal mengkueri informasi lampiran.
400	IllegalParam.AttachmentId	The attachment is invalid.	Lampiran tidak valid.
400	OperationFailed.NotSupportIPV6	The specified next hop does not support IPv6.	Hop berikutnya yang ditentukan tidak mendukung IPv6.
400	IncorrectStatus.Ipv6Address	The IPv6 address of the specified next hop is being assigned or deleted.	Alamat IPv6 dari hop berikutnya yang ditentukan sedang dibuat atau dihapus.
400	OperationUnsupported.Ipv6EntryOnPrimaryNetworkInterface	You cannot create IPv6 route entries on a primary network interface.	Anda tidak dapat membuat entri rute IPv6 yang hop berikutnya adalah ENI utama.
400	OperationUnsupported.SpecifyIpOnIpv6Entry	You cannot specify the private IP address when you create IPv6 route entries.	Anda tidak dapat menentukan parameter IP privat saat membuat rute IPv6.
400	OperationUnsupported.MutipleIpv6Address	You cannot specify a next hop that has bound multiple IPv6 addresses.	Anda tidak dapat menentukan hop berikutnya yang terikat dengan beberapa alamat IPv6.
400	OperationDenied.Ipv6EntryOnCustomTable	You cannot create any IPv6 route entry on a custom route table.	Anda tidak dapat membuat entri rute IPv6 pada tabel rute kustom.
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 mengelola sumber daya yang ditentukan. Ajukan permohonan izin dan coba lagi.
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.