Gunakan CreateTransitRouterVbrAttachment untuk menghubungkan VBR ke Transit Router - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Memanggil operasi CreateTransitRouterVbrAttachment untuk menghubungkan instans jaringan Virtual Border Router (VBR) ke instans router transit di wilayah yang sama. Setelah koneksi terbentuk, router transit dapat membantu Anda mencapai peering jaringan pribadi.

Deskripsi operasi

Untuk informasi tentang wilayah dan zona yang didukung oleh router transit Edisi Perusahaan, lihat Apa itu Cloud Enterprise Network?.
Anda dapat membuat koneksi VBR pada router transit Edisi Perusahaan dengan cara berikut:
- Jika Anda telah membuat instans router transit Edisi Perusahaan di wilayah target, Anda dapat membuat koneksi VBR dengan menentukan VbrId, RegionId, dan TransitRouterId.
- Jika Anda belum memiliki instans router transit Edisi Perusahaan di wilayah target, Anda dapat membuat koneksi VBR dengan menentukan VbrId, CenId, dan RegionId. Sistem akan secara otomatis membuat instans router transit Edisi Perusahaan saat koneksi VBR dibuat.
CreateTransitRouterVbrAttachment adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID koneksi VBR tetapi koneksi VBR belum dibuat. Tugas pembuatan berjalan di latar belakang. Anda dapat memanggil ListTransitRouterVbrAttachments untuk mengkueri status koneksi VBR.
- Jika koneksi VBR berada dalam status Attaching, koneksi VBR sedang dibuat. Dalam status ini, Anda hanya dapat mengkueri koneksi VBR dan tidak dapat melakukan operasi lain.
- Jika koneksi VBR berada dalam status Attached, koneksi VBR telah dibuat.
Akun Alibaba Cloud yang memiliki router transit dan akun Alibaba Cloud yang memiliki instans VBR harus berasal dari perusahaan yang sama.
Router transit mendukung koneksi ke instans VBR yang dimiliki oleh akun yang sama atau akun yang berbeda. Sebelum membuat koneksi VBR lintas akun, dapatkan otorisasi dari Pemilik instans VBR. Untuk informasi lebih lanjut, lihat Memberikan izin untuk instans jaringan lintas akun.
Setelah koneksi VBR dibuat, koneksi VBR tidak membentuk hubungan pembelajaran entri rute atau penerusan asosiasi dengan tabel rute router transit apa pun secara default.

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

create

CenInstance

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

TransitRouter

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

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 tersebut unik di antara berbagai permintaan. Token klien hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem akan secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	02fb3da4-130e-11e9-8e44-001****
CenId	string	No	ID instans Cloud Enterprise Network (CEN).	cen-j3jzhw1zpau2km****
TransitRouterId	string	No	ID instans router transit Edisi Perusahaan.	tr-bp1su1ytdxtataupl****
RegionId	string	No	ID wilayah instans VBR. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou.
TransitRouterAttachmentName	string	No	Nama koneksi VBR. Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh dimulai dengan http:// atau https://.	testname.
TransitRouterAttachmentDescription	string	No	Deskripsi koneksi VBR. Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh dimulai dengan http:// atau https://.	testdesc.
VbrId	string	Yes	ID instans VBR.	vbr-bp1svadp4lq38janc****
VbrOwnerId	integer	No	ID akun Alibaba Cloud dari akun Alibaba Cloud yang memiliki instans VBR. Nilai defaultnya adalah ID akun Alibaba Cloud dari akun yang sedang login. Catatan Parameter ini diperlukan jika Anda ingin memuat instans jaringan yang dimiliki oleh akun yang berbeda.	1250123456123456
AutoPublishRouteEnabled	boolean	No	Apakah akan mengizinkan router transit Edisi Perusahaan untuk secara otomatis menerbitkan entri rute ke instans VBR. false (default): tidak. true: ya.	false.
DryRun	boolean	No	Apakah akan menjalankan dry run, termasuk verifikasi izin dan status instans. Nilai valid: false (default): mengirim permintaan normal. Jika permintaan lulus pemeriksaan, koneksi VBR akan dibuat. true: mengirim permintaan pemeriksaan. Hanya verifikasi yang dilakukan tanpa membuat koneksi VBR. Sistem memeriksa apakah parameter yang diperlukan telah ditentukan dan apakah format permintaan valid. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, ID permintaan yang sesuai akan dikembalikan.	false.
Tag	array<object>	No	Informasi tag. Anda dapat menentukan hingga 20 tag sekaligus.
	object	No
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.	TagKey.
Value	string	No	Nilai tag Sumber daya. Setelah ditentukan, nilai tag tidak boleh kosong. Nilai tag dapat 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.
TransitRouterAttachmentId	string	ID koneksi VBR.	tr-attach-ia340z7xis7t5s****
RequestId	string	ID permintaan.	C087A369-82B9-43EF-91F4-4B63A9C6E6B6

Contoh

Respons sukses

JSONformat

{
  "TransitRouterAttachmentId": "tr-attach-ia340z7xis7t5s****",
  "RequestId": "C087A369-82B9-43EF-91F4-4B63A9C6E6B6"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	NoPermission.AliyunServiceRolePolicyForCEN	You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.	Anda tidak memiliki izin untuk membuat peran tertaut layanan. Nama peran: AliyunServiceRolePolicyForCEN. Nama layanan: cen.aliyuncs.com. Pastikan pengguna saat ini telah diberikan izin ram:CreateServiceLinkedRole.
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.
400	InvalidCenId.NotFound	CenId is not found.	CenId yang ditentukan dalam parameter tidak ada.
400	InvalidStatus.ResourceStatus	The resource is not in a valid state for the attachment operation.	Status Sumber daya saat ini tidak mendukung operasi ini. Coba lagi nanti.
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	TransitRouterId yang ditentukan dalam permintaan tidak ada.
400	Forbbiden.TransitRouterServiceNotOpen	The user has not open transit router service.	Layanan router transit belum diaktifkan. Aktifkan layanan dan coba lagi.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	Operasi ini tidak didukung untuk tipe router transit saat ini.
400	MissingParam.CenIdOrRegionId	Either CenId or RegionId must be specified.	CenId atau RegionId adalah parameter yang diperlukan.
400	IncorrectStatus.Vpc	The resource is not in a valid state for the attachment operation.	Status saat ini dari VPC tidak mendukung operasi ini. Coba lagi nanti.
400	Forbidden.VbrDeviceModel	Attach VBR on some access device models are forbidden.	Mode akses VBR saat ini tidak mendukung operasi ini.
400	IllegalParam.AssociateRouteTableId	The specified AssociateRouteTableId is illegal.	AssociateRouteTableId yang ditentukan dalam permintaan tidak valid.
400	Forbbiden.AttachChildInstanceAcrossBid	Operation is invalid, please apply for cross-bid attaching.
400	IllegalParam.RegionId	RegionId is illegal.	Region yang ditentukan dalam permintaan tidak valid.
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter	Instans CEN mode penuh tidak mendukung VPN BGP.
400	OperationUnsupported.VbrAttachment	This region not support vbr attachment.	Wilayah ini tidak mendukung pemuatan lampiran VBR.
400	InvalidOperation.CenInstanceStatus	The CEN instance is not in a valid state for the operation.
400	OperationUnsupported.CloudBoxVbrNotSupport	Cloud Box Vbr does not support.	Instans CloudBox tidak dapat dimuat.
400	IncorrectStatus.VbrResource	The resource is not in a valid state for the attachment operation.	Sumber daya VBR tidak dalam keadaan stabil. Tunggu hingga operasi terkait pada VBR saat ini selesai dan coba lagi.
400	IncorrectStatus.TransitRouter	The status of TransitRouter is incorrect.	Status saat ini dari router transit tidak mendukung operasi ini. Coba lagi nanti.
400	QuotaExceeded.CenQuotaVbrAttachPerTransitRouter	The maximum number of VBR attachment per Transit Router is exceeded.	Jumlah virtual border router (VBR) yang dapat disambungkan ke setiap router transit telah melebihi batas. Ajukan Tiket untuk meningkatkan kuota.
400	QuotaFull.ChildInstanceRelatedCen	The childinstance has exceed the quota of the times that a childinstance can be attached as an attachment.	Jumlah instans CEN yang dapat diasosiasikan dengan instans ini telah mencapai batas atas. Instans tidak dapat dimuat.
400	Forbidden.ResourceOwnerTransitRouterServiceNotOpen	The resource owner user has not opened transit router service.	Layanan router transit akun pemilik Sumber daya belum diaktifkan. Beri tahu pemilik akun untuk mengaktifkan layanan dan coba lagi.
400	InvalidOperation.VbrAttachedToEcr	VBR has alreay attached to ECR.	VBR sudah terhubung dengan ECR.
400	Forbidden.ResourceOwnerTransitRouterServiceExpired	The transit router service of the account to which the resource belongs has been suspended due to arrears. Please notify the other party to renew the service and try again.	Layanan router transit akun pemilik Sumber daya telah ditangguhkan karena pembayaran tertunda. Beri tahu pemilik akun untuk melakukan perpanjangan layanan dan coba lagi.
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	InvalidParameter.ResourceType	The specified parameter ResourceType is invalid.
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	Parameter Nilai Tag tidak valid.
403	Forbidden.VbrDeviceModel	The attached VBR on some access device models are not supported. Please submit a ticket to continue using this VBR on CEN.	Mode akses VBR saat ini tidak mendukung operasi ini.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.