Panggil API CreateTransitRouterPeerAttachment untuk membuat koneksi antar wilayah - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Setelah instance jaringan (VPC, VBR, dan koneksi IPsec) terhubung ke router transit, Anda perlu membuat koneksi antar-wilayah antara router transit agar instance jaringan di wilayah berbeda dapat berkomunikasi. Anda dapat memanggil operasi CreateTransitRouterPeerAttachment untuk membuat koneksi antar-wilayah pada instance Router transit edisi perusahaan.

Deskripsi operasi

Router transit edisi perusahaan mendukung dua metode alokasi bandwidth berikut:
- Allocate from bandwidth package:
  
  Untuk menggunakan metode ini, Anda harus terlebih dahulu membeli paket bandwidth dan mengalokasikan bandwidth dari paket tersebut ke koneksi antar-wilayah. Untuk informasi selengkapnya tentang cara membeli paket bandwidth, lihat CreateCenBandwidthPackage.
- Pay-by-data-transfer:
  
  Untuk menggunakan metode ini, Anda harus menetapkan batas bandwidth untuk koneksi antar-wilayah. Sistem akan menagih Anda berdasarkan traffic aktual koneksi tersebut. Untuk informasi selengkapnya tentang penagihan, lihat Inter-region data transfer.
CreateTransitRouterPeerAttachment adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID koneksi antar-wilayah, tetapi koneksi tersebut belum dibuat. Tugas pembuatan masih berjalan di latar belakang. Anda dapat memanggil operasi ListTransitRouterPeerAttachments untuk memeriksa status koneksi antar-wilayah.
- Jika koneksi antar-wilayah berada dalam status Attaching, koneksi tersebut sedang dalam proses pembuatan. Dalam status ini, Anda hanya dapat memeriksa koneksi antar-wilayah tetapi tidak dapat melakukan operasi lain padanya.
- Jika koneksi antar-wilayah berada dalam status Attached, koneksi tersebut telah berhasil 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

cen:CreateTransitRouterPeerAttachment

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 menghasilkan token ini di sisi klien, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token klien hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dapat 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 lokal.	tr-bp1su1ytdxtataupl****
RegionId	string	No	ID wilayah instans router transit edisi perusahaan lokal. Anda dapat memanggil operasi DescribeRegions untuk mengecek ID wilayah.	cn-hangzhou.
TransitRouterAttachmentName	string	No	Nama koneksi antar-wilayah. Nama dapat kosong atau terdiri dari 1 hingga 128 karakter, dan tidak boleh diawali dengan http:// atau https://.	testname.
TransitRouterAttachmentDescription	string	No	Deskripsi koneksi antar-wilayah. Deskripsi dapat kosong atau terdiri dari 1 hingga 256 karakter, dan tidak boleh diawali dengan http:// atau https://.	testdesc.
PeerTransitRouterId	string	Yes	ID instans router transit peer.	tr-m5eq27g6bndum7e88****
PeerTransitRouterRegionId	string	No	ID wilayah instans router transit peer.	cn-qingdao.
AutoPublishRouteEnabled	boolean	No	Menentukan apakah router transit edisi perusahaan diizinkan untuk secara otomatis mengiklankan rute koneksi antar-wilayah ke wilayah peer. false (default): tidak. true: ya.	false.
Bandwidth	integer	No	Nilai bandwidth koneksi antar-wilayah. Satuan: Mbit/s. Jika BandwidthType diatur ke BandwidthPackage, parameter ini menentukan bandwidth yang dapat digunakan oleh koneksi antar-wilayah. Jika BandwidthType diatur ke DataTransfer, parameter ini menentukan batas bandwidth koneksi antar-wilayah.	2
CenBandwidthPackageId	string	No	ID paket bandwidth yang akan dikaitkan dengan koneksi antar-wilayah. Catatan Jika BandwidthType diatur ke DataTransfer, Anda tidak perlu mengonfigurasi parameter ini.	cenbwp-3xrxupouolw5ou****
DryRun	boolean	No	Menentukan apakah akan menjalankan dry run, termasuk verifikasi izin dan status instans. Nilai yang valid: false (default): mengirim permintaan normal. Jika permintaan lolos verifikasi, koneksi antar-wilayah akan dibuat. true: mengirim permintaan pemeriksaan. Hanya verifikasi yang dilakukan. Tidak ada koneksi antar-wilayah yang dibuat. Sistem memeriksa apakah parameter yang diperlukan telah ditentukan dan memvalidasi format permintaan. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, ID permintaan yang sesuai akan dikembalikan.	false.
BandwidthType	string	No	Metode alokasi bandwidth koneksi antar-wilayah. Nilai yang valid: BandwidthPackage: mengalokasikan bandwidth dari paket bandwidth. DataTransfer: tidak mengalokasikan bandwidth ke koneksi antar-wilayah. Sistem menagih Anda berdasarkan traffic aktual.	BandwidthPackage.
Tag	array<object>	No	Informasi tag. Anda dapat menentukan hingga 20 tag sekaligus.
	object	No
Key	string	No	Kunci tag resource. Jika ditentukan, 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 hingga 20 kunci tag sekaligus.	tag_A1
Value	string	No	Nilai tag resource. Jika ditentukan, nilai tag tidak boleh kosong. Panjang nilai tag maksimal 128 karakter, dan tidak boleh diawali dengan aliyun atau acs:. Nilai tag juga tidak boleh mengandung http:// atau https://. Setiap kunci tag memiliki satu nilai tag yang sesuai. Anda dapat menentukan hingga 20 nilai tag sekaligus.	value_A1
DefaultLinkType	string	No	Tipe tautan default. Nilai yang valid: Platinum dan Gold. Nilai default: Gold. Tipe tautan hanya dapat diatur ke Platinum jika metode alokasi bandwidth adalah pay-by-data-transfer.	Gold.

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
TransitRouterAttachmentId	string	ID koneksi antar-wilayah.	tr-attach-nwkiqfvw22qesz****
RequestId	string	ID permintaan.	59422BF5-BAAD-4CFD-9019-9557BD3ACFA3

Contoh

Respons sukses

JSONformat

{
  "TransitRouterAttachmentId": "tr-attach-nwkiqfvw22qesz****",
  "RequestId": "59422BF5-BAAD-4CFD-9019-9557BD3ACFA3"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.
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 terkait layanan. Nama peran: AliyunServiceRolePolicyForCEN. Nama layanan: cen.aliyuncs.com. Pastikan izin ram:CreateServiceLinkedRole telah diberikan kepada pengguna saat ini.
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	TransitRouterId yang ditentukan dalam permintaan tidak ada.
400	IllegalParam.PeerTransitRouterId	PeerTransitRouterId is illegal.	ID entri rute router transit peer untuk koneksi antar-wilayah tidak valid.
400	OperationUnsupported.TransitRouterId	TransitRouterId is unsupported.	Operasi ini tidak didukung ketika router transit adalah router transit Edisi Dasar.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	Parameter nilai bandwidth diperlukan.
400	IllegalParam.Bandwidth	Bandwidth is illegal.	ID paket bandwidth tidak valid.
400	Forbbiden.TransitRouterServiceNotOpen	The user has not open transit router service.	Layanan router transit belum diaktifkan. Aktifkan 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	OperationUnsupported.BandwidthType	The specified BandwidthType does not support the operation.	BandwidthType saat ini tidak mendukung operasi ini.
400	InvalidCenId.NotFound	CenId is not found.	CenId yang ditentukan dalam parameter tidak ada.
400	IllegalParam.BandwidthType	BandwidthType is illegal.	Tipe paket bandwidth tidak valid.
400	MissingParam.CenIdOrRegionId	Either CenId or RegionId must be specified.	CenId atau RegionId adalah parameter yang diperlukan.
400	OperationUnsupported.BandwidthHS	This bandwidth limit can only be set in China-AsiaPacific-HS
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter	Instans CEN dalam mode Full tidak mendukung VPN BGP.
400	OperationUnsupported.CloudDataTransferService	CCN region not support cloud data transfer service.	Layanan Cloud Data Transfer tidak didukung di wilayah CCN.
400	InvalidPeerTransitRouterId.NotFound	The specified PeerTransitRouterId is not found.	PeerTransitRouterId yang ditentukan dalam permintaan tidak ada.
400	IllegalParam.RegionId	RegionId is illegal.	Region yang ditentukan dalam permintaan tidak valid.
400	IllegalParam.PeerRegionId	PeerRegionId is illegal.	PeerRegionId yang ditentukan dalam permintaan tidak valid.
400	IllegalParam.TransitRouterRegionId	TransitRouterRegionId is illegal.	TransitRouterRegionId tidak valid.
400	InvalidOperation.CenInstanceStatus	The CEN instance is not in a valid state for the operation.
400	IncorrectStatus.TransitRouter	The status of TransitRouter is incorrect.	Status saat ini dari router transit tidak mendukung operasi ini. Coba lagi nanti.
400	InvalidOperation.BwpNotAssociated	Operation is invalid because a bandwidth package corresponding to the geographic span is not associated.	Paket bandwidth tidak terkait dengan wilayah yang sesuai. Operasi tidak dapat dilakukan.
400	InvalidOperation.BwpBusinessStatus	The CBN bandwidth package is not in a valid business state for the operation.	Paket bandwidth tidak dalam status stabil dan tidak dapat dioperasikan.
400	IllegalParam.CenBandwidthPackageId	Parameter CenBandwidthPackageId is illegal.	CenBandwidthPackageId yang ditentukan dalam parameter permintaan tidak valid.
400	InvalidOperation.BwpBandwidthExceeded	Operation is invalid because the total bandwidth limit has exceeded that of the bandwidth package.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold	DataTransfer only support Platinum and Gold.	Ketika metode alokasi bandwidth adalah bayar per transfer data, tipe tautan default hanya mendukung Platinum dan Gold.
400	ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold	Cen bandwidthPackage only support Gold.	Ketika metode alokasi bandwidth diatur ke paket bandwidth, tipe tautan default hanya mendukung Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold	CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version.	Ketika router transit di kedua ujung koneksi antar-wilayah tidak semuanya Edisi Perusahaan dan metode alokasi bandwidth adalah bayar per transfer data, tipe tautan default hanya mendukung Gold.
400	OperationNotAllowed.DefaultLinkTypeOnlySupportGold	Operation is not allowed because this user can only set default link type to Gold.	Pengguna ini hanya dapat mengatur jenis tautan default ke Gold.
400	OperationInvalid.UserCanNotBuyCrossBorderBwp	According to the laws and regulations of the operator and mainland China, you are currently not eligible to purchase or renew a cross-border bandwidth package. Please contact online customer service or your business manager for consultation.	Berdasarkan persyaratan operator dan hukum serta peraturan Tiongkok daratan, Anda saat ini tidak memenuhi syarat untuk membeli atau perpanjangan paket bandwidth lintas batas. Hubungi layanan pelanggan online atau manajer akun Anda untuk bantuan.
400	OperationInvalid.IdentityRegistrationStatusNotSupport	Real name registration of enterprises required.	Wilayah yang Anda pilih melibatkan komunikasi antara Tiongkok daratan dan luar Tiongkok daratan. Anda harus memenuhi kondisi berikut sebelum dapat melanjutkan pembelian:
400	InvalidOperation.OnlyOneRegionSupportIpv6	Peer Attachment is only allowed when both regions support IPv6 or do not support IPv6 at all.	Koneksi lintas wilayah hanya dapat dibuat ketika kedua wilayah mendukung IPv6 atau kedua wilayah tidak mendukung IPv6.
400	InvalidOperation	Operation is invalid.	Operasi tidak valid.
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 dari 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. Lakukan perpanjangan layanan dan coba lagi.
400	OperationUnsupported.RegionId	The specified RegionId does not support the operation.	Wilayah saat ini tidak mendukung operasi ini.
400	QuotaExceeded.Bandwidth	Bandwidth quota exceeded.	Nilai bandwidth melebihi batas kuota.
400	InvalidParameter	Invalid parameter.	Parameter tidak valid.
400	Unauthorized	The AccessKeyId is unauthorized.	Akun tidak memiliki izin untuk melakukan operasi ini.
400	InvalidParameter.PeerTransitRouterId	The specified parameter PeerTransitRouterId is invalid.
400	InvalidParameter.ResourceType	The specified parameter ResourceType is invalid.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportUnderlaySilver	CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version.	Ketika router transit di kedua ujung koneksi antar-wilayah tidak semuanya Edisi Perusahaan dan metode alokasi bandwidth adalah bayar-per-transfer-data, tipe tautan default hanya mendukung Silver (UnderlaySilver).
400	ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver	Cen bandwidthPackage only support UnderlaySilver.	Ketika metode alokasi bandwidth adalah paket bandwidth, tipe tautan default hanya mendukung Silver (UnderlaySilver).
400	OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver	This user can only set the default link type to UnderlaySilver.	Pengguna ini hanya dapat mengatur tipe tautan default ke Silver (UnderlaySilver).
400	OperationFailed.ValidateVbrInstanceFailedForLowLatencyCircuit	Operation failed when validate VBR instance for Low Latency Circuit.	Validasi instans VBR yang dimuat gagal saat membuat tautan latensi rendah.
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	Parameter Nilai Tag tidak valid.
400	InvalidParameter.CenBandwidthPackageId	The specified parameter CenBandwidthPackageId is invalid.
400	InvalidParameter.CenId	The specified parameter CenId is invalid.
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.