Gunakan CreateTransitRouter untuk membuat transit router edisi enterprise - Cloud Enterprise Network

Anda dapat memanggil operasi CreateTransitRouter untuk membuat instans Router transit edisi perusahaan.

Deskripsi operasi

Anda dapat memanggil operasi CreateTransitRouter untuk membuat instans Router transit edisi perusahaan. Router transit edisi perusahaan hanya tersedia di beberapa wilayah. Untuk informasi selengkapnya mengenai wilayah yang didukung, lihat What is Cloud Enterprise Network?.
CreateTransitRouter adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID instans Router transit edisi perusahaan, tetapi instans tersebut masih dalam proses pembuatan di latar belakang. Anda dapat memanggil operasi ListTransitRouters untuk mengecek status instans Router transit edisi perusahaan.
- Jika instans Router transit edisi perusahaan berada dalam status Creating, Anda hanya dapat mengecek instans tersebut dan tidak dapat melakukan operasi lain.
- Jika instans Router transit edisi perusahaan berada dalam status Active, instans tersebut telah berhasil dibuat.
Anda hanya dapat membuat satu instans router transit di setiap wilayah untuk satu instans CEN.

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

cen:CreateTransitRouter

create

CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

TransitRouter

acs:cen:*:{#accountId}:centransitrouter/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Buat token klien yang unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan.	02fb3da4-130e-11e9-8e44-001****
CenId	string	Yes	ID instans CEN.	cen-j3jzhw1zpau2km****
RegionId	string	Yes	ID wilayah tempat Router transit edisi perusahaan ditempatkan. Anda dapat memanggil operasi DescribeChildInstanceRegions untuk menanyakan daftar wilayah terbaru.	cn-zhangjiakou
TransitRouterName	string	No	Nama instans Router transit edisi perusahaan. Nama bisa kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh diawali dengan http:// atau https://.	testname
TransitRouterDescription	string	No	Deskripsi instans Router transit edisi perusahaan. Deskripsi bisa kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh diawali dengan http:// atau https://.	testdesc
DryRun	boolean	No	Menentukan apakah akan melakukan dry run. Dry run memeriksa izin dan apakah parameter yang diperlukan telah ditentukan. Nilai yang valid: false (default): mengirim permintaan dan membuat instans setelah permintaan lolos pemeriksaan. true: mengirim permintaan dry run untuk memeriksa parameter tanpa membuat instans. Sistem memeriksa parameter yang diperlukan, format permintaan, dan izin. Jika permintaan gagal dalam dry run, pesan kesalahan dikembalikan. Jika permintaan lolos dry run, kode kesalahan `DryRunOperation` dikembalikan.	false
SupportMulticast	boolean	No	Menentukan apakah fitur multicast diaktifkan untuk Router transit edisi perusahaan. Nilai yang valid: false (default): menonaktifkan fitur multicast. true: mengaktifkan fitur multicast. Fitur multicast hanya didukung di beberapa wilayah. Anda dapat memanggil operasi ListTransitRouterAvailableResource untuk menanyakan wilayah yang mendukung multicast.	false
TransitRouterCidrList	array<object>	No	Blok CIDR router transit.
	object	No	Blok CIDR router transit. Anda dapat menambahkan maksimal lima blok CIDR. Untuk informasi selengkapnya mengenai blok CIDR router transit, lihat CIDR blocks of transit routers. Catatan Hanya Router transit edisi perusahaan yang mendukung blok CIDR.
Cidr	string	No	Blok CIDR router transit.	192.168.10.0/24
Name	string	No	Nama blok CIDR. Nama harus terdiri dari 1 hingga 128 karakter.	nametest
Description	string	No	Deskripsi blok CIDR. Deskripsi harus terdiri dari 1 hingga 256 karakter.	desctest
PublishCidrRoute	boolean	No	Menentukan apakah rute blok CIDR secara otomatis diiklankan ke tabel rute router transit. true (default): ya. Jika Anda memilih opsi ini, setelah membuat koneksi VPN yang menggunakan gerbang privat dan membuat korelasi pembelajaran rute untuk koneksi VPN tersebut, sistem secara otomatis menambahkan rute berikut ke tabel rute router transit yang terkait dengan koneksi VPN: Rute blackhole yang blok CIDR tujuannya adalah blok CIDR router transit. Blok CIDR router transit mengacu pada blok CIDR tempat alamat IP gerbang dialokasikan untuk koneksi IPsec. Rute blackhole ini hanya diiklankan ke tabel rute instans Virtual Border Router (VBR) yang terhubung ke router transit. false: tidak.	true
Tag	array<object>	No	Tag.
	object	No	Tag. Anda dapat menentukan maksimal 20 tag.
Key	string	No	Kunci tag. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 64 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci tag juga tidak boleh mengandung `http://` atau `https://` . Anda dapat menentukan maksimal 20 kunci tag.	tagtest
Value	string	No	Nilai tag. Nilai tag bisa kosong atau berupa string dengan panjang maksimal 128 karakter. Nilai tag tidak boleh diawali dengan `aliyun` atau `acs:` dan tidak boleh mengandung `http://` atau `https://` . Setiap kunci tag harus memiliki nilai tag yang unik. Anda dapat menentukan maksimal 20 nilai tag.	TagValue

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
TransitRouterId	string	ID instans Router transit edisi perusahaan.	tr-uf6llz2286805i44g****
RequestId	string	ID permintaan.	404DA7EC-F495-44B5-B543-6EDCDF90F3D1

Contoh

Respons sukses

JSONformat

{
  "TransitRouterId": "tr-uf6llz2286805i44g****",
  "RequestId": "404DA7EC-F495-44B5-B543-6EDCDF90F3D1"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	OperationUnsupported.RegionId	The specified Region is not supported.	The error message returned because this operation is not supported in the specified region.
400	InstanceExist.TransitRouterInstance	The instance already exists.	The error message returned because a transit router with the same ID already exists in the current region. Transit router IDs in the same region must be unique.
400	Forbbiden.TransitRouterServiceNotOpen	The user has not open transit router service.	The error message returned because the transit router is disabled. Enable the transit router and try again.
400	OperationUnsupported.SupportMulticast	The multicast is not supported in the specified region.	The error message returned because multicast is not supported in the specified region.
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter.
400	IllegalParam.Cidr	Cidr is illegal.	The error message returned because the specified CIDR block is invalid.
400	Illegal.TrType	The TransitRouter type is illegal.	The error message returned because the specified type of transit router does not support this operation.
400	OperationUnsupported.TransitRouterCidrList	The TransitRouterCidrList is not support in the specified Region.	The error message returned because this operation is not supported in the specified region.
400	OperationFailed.CidrConflict	Operation is invalid because the cidr conflict.	The error message returned because the specified CIDR block conflicts with another one.
400	IllegalParam.Region	The specified region is invalid.
400	OverLappingExist.Cidr	The cidr overlapping exist.	The error message returned because CIDR overlapping is already enabled.
400	IllegalParam.ServiceMode	The specified ServiceMode is invalid.	The error message returned because the specified service mode is invalid.
400	ParamExclusive.ServiceModeAndSupportMulticast	ServiceMode and SupportMulticast is mutually exclusive.	The error message returned because transit routers in the current mode do not support multicast.
400	ParamExclusive.ServiceModeAndTransitRouterCidrList	ServiceMode and TransitRouterCidrList is mutually exclusive.	The error message returned because transit routers in the current mode do not support CIDR blocks.
400	OperationUnsupported.Tag	The Tag is not supported in the specified region.	The error message returned because transit routers in the current region do not support tags.
400	IllegalParam.SupportMulticast	Basic Transit router is not support multicast.	The error message returned because Basic Edition transit routers do not support multicast.
400	ParamExclusive.BasicAndPrimaryStandby	Basic and PrimaryStandby is mutually exclusive.	The error message returned because Basic Edition transit routers do not support the PrimaryStandby mode.
400	ParamExclusive.BasicAndMultiPrimary	Basic and MultiPrimary is mutually exclusive.	The error message returned because Basic Edition transit routers do not support the MultiPrimary mode.
400	IllegalParam.RegionId	The Specified Parameter RegionId is illegal.	The region specified in the parameter is invalid.
400	OperationFailed.PostPay95BwpNotAllowEnterpriseTr	Cbn with post pay 95 bandwidth package does not allow enterprise tr.	Cbn with post pay 95 bandwidth package does not allow enterprise tr.
400	Forbidden.TransitRouterServiceExpired	The transit router service is out of service.	The transit router service has been suspended due for payment. Please renew the service and try again.
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.