All Products
Search
Document Center

Cloud Enterprise Network:CreateTransitRouter

Last Updated:Jul 15, 2026

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 lebih lanjut tentang wilayah, lihat Apa itu Cloud Enterprise Network?.

  • CreateTransitRouter adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID instans router transit Edisi Perusahaan, tetapi instans belum dibuat. Tugas pembuatan masih berjalan di latar belakang. Anda dapat memanggil operasi ListTransitRouters untuk mengkueri status instans router transit Edisi Perusahaan.
    • Jika instans router transit Edisi Perusahaan berada dalam status Creating, instans sedang dibuat. Dalam status ini, Anda hanya dapat mengkueri instans dan tidak dapat melakukan operasi lain pada instans tersebut.

    • Jika instans router transit Edisi Perusahaan berada dalam status Active, instans telah dibuat.

  • Hanya satu instans router transit yang dapat dibuat di setiap wilayah dalam sebuah instans Cloud Enterprise Network (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 None

Parameter permintaan

Parameter

Type

Required

Description

Example

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token unik di antara berbagai permintaan. Token hanya dapat 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.

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

CenId

string

Yes

ID instans CEN.

cen-j3jzhw1zpau2km****

RegionId

string

Yes

ID wilayah instans router transit Edisi Perusahaan.

Anda dapat memanggil operasi DescribeChildInstanceRegions untuk mengkueri ID wilayah.

cn-zhangjiakou

TransitRouterName

string

No

Nama instans router transit Edisi Perusahaan.

Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh dimulai dengan http:// atau https://.

testname

TransitRouterDescription

string

No

Deskripsi instans router transit Edisi Perusahaan.

Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh dimulai dengan http:// atau https://.

testdesc

DryRun

boolean

No

Apakah akan menjalankan dry run, termasuk verifikasi izin dan status instans. Nilai valid:

  • false (default): Mengirim permintaan normal dan membuat instans router transit Edisi Perusahaan setelah permintaan lulus pemeriksaan.

  • true: Mengirim permintaan pemeriksaan tanpa membuat instans router transit Edisi Perusahaan. Sistem memeriksa parameter yang diperlukan, format permintaan, dan kondisi lainnya. Jika pemeriksaan gagal, kode kesalahan yang sesuai dikembalikan. Jika pemeriksaan lulus, kode kesalahan DryRunOperation dikembalikan.

false

SupportMulticast

boolean

No

Apakah akan mengaktifkan fitur multicast untuk router transit Edisi Perusahaan. Nilai valid:

  • false (default): Dinonaktifkan.

  • true: Diaktifkan.

Hanya router transit Edisi Perusahaan di beberapa wilayah yang mendukung fitur multicast. Anda dapat memanggil operasi ListTransitRouterAvailableResource untuk mengkueri wilayah yang mendukung fitur multicast.

false

TransitRouterCidrList

array<object>

No

Daftar Blok CIDR router transit.

object

No

Daftar Blok CIDR router transit.

Anda dapat menambahkan hingga lima Blok CIDR router transit sekaligus. Untuk informasi lebih lanjut tentang Blok CIDR router transit, lihat Blok CIDR router transit.

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 router transit.

Nama harus memiliki panjang 1 hingga 128 karakter.

nametest

Description

string

No

Deskripsi Blok CIDR router transit.

Deskripsi harus memiliki panjang 1 hingga 256 karakter.

desctest

PublishCidrRoute

boolean

No

Apakah akan mengizinkan sistem untuk secara otomatis menambahkan rute untuk Blok CIDR router transit ke tabel rute router transit.

  • true (default): Diizinkan.

    Jika Anda memilih opsi ini, setelah Anda membuat koneksi VPN tipe gerbang privat dan membuat hubungan pembelajaran rute untuk koneksi VPN, sistem secara otomatis menambahkan entri rute ke tabel rute router transit yang memiliki hubungan pembelajaran rute dengan koneksi VPN:

    Rute blackhole yang blok CIDR tujuannya adalah Blok CIDR router transit tempat alamat IP gerbang dialokasikan untuk koneksi IPsec.

    Rute blackhole hanya dipropagasikan ke tabel rute instans virtual border router (VBR) yang terkait dengan router transit.

  • false: Tidak diizinkan.

true

Tag

array<object>

No

Informasi tag.

object

No

Informasi tag.

Anda dapat menentukan hingga 20 tag sekaligus.

Key

string

No

Kunci tag Sumber daya.

Setelah ditentukan, kunci tag tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 64 karakter, dan tidak boleh dimulai dengan aliyun atau acs:, atau mengandung http:// atau https://.

Anda dapat menentukan hingga 20 kunci tag sekaligus.

tagtest

Value

string

No

Nilai tag Sumber daya.

Nilai tag dapat kosong atau memiliki panjang hingga 128 karakter, dan tidak boleh dimulai dengan aliyun atau acs:, atau mengandung http:// atau https://.

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

TagValue

Elemen respons

Element

Type

Description

Example

object

Parameter tanggapan.

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. Wilayah saat ini tidak mendukung operasi ini.
400 InstanceExist.TransitRouterInstance The instance already exists. Instans TransitRouter sudah ada di wilayah saat ini. Anda tidak dapat membuat instans duplikat di wilayah yang sama.
400 Forbbiden.TransitRouterServiceNotOpen The user has not open transit router service. Layanan router transit belum diaktifkan. Aktifkan layanan dan coba lagi.
400 OperationUnsupported.SupportMulticast The multicast is not supported in the specified region. Multicast tidak didukung di wilayah saat ini.
400 OperationUnsupported.CenFullLevel CEN full level does not support TransitRouter.
400 IllegalParam.Cidr Cidr is illegal. Blok CIDR yang ditentukan dalam permintaan tidak valid.
400 Illegal.TrType The TransitRouter type is illegal. Tipe router transit tidak mendukung operasi ini.
400 OperationUnsupported.TransitRouterCidrList The TransitRouterCidrList is not support in the specified Region. Wilayah saat ini tidak mendukung operasi ini.
400 OperationFailed.CidrConflict Operation is invalid because the cidr conflict. Blok CIDR berkonflik dengan blok yang sudah ada.
400 IllegalParam.Region The specified region is invalid.
400 OverLappingExist.Cidr The cidr overlapping exist. Tumpang tindih Blok CIDR sudah ada.
400 IllegalParam.ServiceMode The specified ServiceMode is invalid. ServiceMode yang ditentukan dalam permintaan tidak valid.
400 ParamExclusive.ServiceModeAndSupportMulticast ServiceMode and SupportMulticast is mutually exclusive. Router transit dalam mode ini tidak mendukung pengaktifan fitur multicast.
400 ParamExclusive.ServiceModeAndTransitRouterCidrList ServiceMode and TransitRouterCidrList is mutually exclusive. Router transit dalam mode ini tidak mendukung pengaktifan fitur CIDR.
400 OperationUnsupported.Tag The Tag is not supported in the specified region. Fitur tag router transit tidak didukung di wilayah ini.
400 IllegalParam.SupportMulticast Basic Transit router is not support multicast. Router transit Edisi Dasar tidak mendukung fitur multicast.
400 ParamExclusive.BasicAndPrimaryStandby Basic and PrimaryStandby is mutually exclusive. Router transit Edisi Dasar tidak mendukung pengaturan mode ke PrimaryStandby.
400 ParamExclusive.BasicAndMultiPrimary Basic and MultiPrimary is mutually exclusive. Router transit Edisi Dasar tidak mendukung pengaturan mode ke MultiPrimary.
400 IllegalParam.RegionId The Specified Parameter RegionId is illegal. Region yang ditentukan dalam permintaan tidak valid.
400 OperationFailed.PostPay95BwpNotAllowEnterpriseTr Cbn with post pay 95 bandwidth package does not allow enterprise tr. Instans Cloud Enterprise Network (CEN) yang menggunakan paket bandwidth persentil ke-95 warisan tidak diizinkan membuat router transit Edisi Perusahaan.
400 Forbidden.TransitRouterServiceExpired The transit router service is out of service. Layanan router transit telah ditangguhkan karena pembayaran tertunda. Perpanjang layanan dan coba lagi.
400 InvalidParameter Invalid parameter. Parameter tidak valid.
400 Unauthorized The AccessKeyId is unauthorized. Akun tidak memiliki izin untuk melakukan operasi ini.
400 IllegalParam.TagValue The tag values are not valid. Nilai tag yang ditentukan dalam permintaan tidak valid.
400 IllegalParam.TagKey The tag keys are not valid. Kunci tag yang ditentukan dalam permintaan tidak valid.
400 InvalidParameter.TagValue The specified parameter TagValue is invalid. Parameter Nilai Tag tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.