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

Setelah instance jaringan (VPC, VBR, atau koneksi IPsec) terhubung ke TransitRouter, Anda perlu membuat koneksi antar-wilayah untuk mengaktifkan komunikasi antara instance jaringan di wilayah yang berbeda. Anda dapat memanggil operasi CreateTransitRouterPeerAttachment untuk membuat koneksi antar-wilayah pada instance TransitRouter edisi perusahaan.

Deskripsi operasi

TransitRouter Edisi Perusahaan memungkinkan Anda mengalokasikan bandwidth ke koneksi antar-wilayah dengan metode berikut:
- From bandwidth plan:
  
  Anda harus membeli paket bandwidth, lalu mengalokasikan sumber daya bandwidth dari paket tersebut ke koneksi antar-wilayah. Untuk informasi selengkapnya tentang cara membeli paket bandwidth, lihat CreateCenBandwidthPackage.
- Pay-by-traffic:
  
  Anda dapat menetapkan nilai bandwidth maksimum untuk koneksi antar-wilayah. Biaya akan dikenakan berdasarkan jumlah data yang ditransfer melalui koneksi tersebut. Untuk informasi selengkapnya tentang penagihan, lihat Inter-region traffic.
Operasi CreateTransitRouterPeerAttachment bersifat asinkron. Setelah operasi ini dipanggil, sistem akan mengembalikan ID koneksi antar-wilayah, tetapi koneksi tersebut belum langsung dibuat. Proses pembuatan berjalan di latar belakang. Anda dapat memanggil operasi ListTransitRouterPeerAttachments untuk mengkueri status koneksi antar-wilayah.
- Jika koneksi antar-wilayah berada dalam status Attaching, artinya koneksi sedang dalam proses pembuatan. Dalam status ini, Anda hanya dapat mengkueri koneksi dan tidak dapat melakukan operasi lain.
- Jika koneksi antar-wilayah berada dalam status Attached, pembuatan koneksi telah selesai.

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 menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId sebagai ClientToken. RequestId 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 tempat instans router transit edisi perusahaan lokal ditempatkan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri 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 bersifat opsional. Jika Anda memasukkan deskripsi, panjangnya harus antara 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 tempat instans router transit peer ditempatkan.	cn-qingdao
AutoPublishRouteEnabled	boolean	No	Menentukan apakah router transit edisi perusahaan lokal diaktifkan untuk secara otomatis mengiklankan rute koneksi antar-wilayah ke router transit peer. Nilai yang valid: false (default): tidak. true: ya.	false
Bandwidth	integer	No	Nilai bandwidth koneksi antar-wilayah. Satuan: Mbps. Ketika BandwidthType diatur ke BandwidthPackage, parameter ini menentukan nilai bandwidth yang dapat digunakan oleh koneksi antar-wilayah. Ketika BandwidthType diatur ke DataTransfer, parameter ini menentukan nilai bandwidth maksimum koneksi antar-wilayah.	2
CenBandwidthPackageId	string	No	ID paket bandwidth yang ingin Anda kaitkan dengan koneksi antar-wilayah. Catatan Anda tidak perlu mengonfigurasi parameter ini ketika BandwidthType diatur ke DataTransfer.	cenbwp-3xrxupouolw5ou****
DryRun	boolean	No	Menentukan apakah akan melakukan dry run untuk memeriksa informasi seperti izin dan status instans. Nilai yang valid: false (default): mengirim permintaan normal. Setelah permintaan lolos pemeriksaan, sistem membuat koneksi antar-wilayah. true: mengirim permintaan pemeriksaan. Sistem memeriksa parameter yang diperlukan dan sintaks permintaan. Jika permintaan gagal dalam dry run, pesan kesalahan dikembalikan. Jika permintaan lolos dry run, ID permintaan dikembalikan.	false
BandwidthType	string	No	Metode yang digunakan untuk mengalokasikan bandwidth ke koneksi antar-wilayah. Nilai yang valid: BandwidthPackage: mengalokasikan bandwidth dari paket bandwidth. DataTransfer: tidak mengalokasikan bandwidth ke koneksi antar-wilayah dan menagih berdasarkan pay-by-traffic.	BandwidthPackage
Tag	array<object>	No	Informasi tag. Anda dapat menentukan maksimal 20 tag dalam setiap panggilan.
	object	No	Tag-tag tersebut.
Key	string	No	Kunci tag yang ingin Anda lampirkan. Anda tidak dapat menentukan string kosong sebagai kunci tag. 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 dalam setiap panggilan.	tag_A1
Value	string	No	Nilai tag yang ingin Anda lampirkan ke resource tertentu. Nilai tag dapat berupa string kosong atau string dengan panjang maksimal 128 karakter. Nilai tag tidak boleh diawali dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://` . Setiap pasangan kunci-nilai harus unik. Anda dapat menentukan maksimal 20 nilai tag dalam setiap panggilan.	value_A1
DefaultLinkType	string	No	Jenis jalur default. Nilai yang valid: Platinum dan Gold. Nilai default: Gold. Anda hanya dapat mengatur parameter ini ke Platinum ketika metode alokasi bandwidth adalah pay-by-traffic.	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.	The error message returned because you do not have the permissions to create the service-linked role whose role name is AliyunServiceRolePolicyForCEN and service name is cen.aliyuncs.com. You must acquire the ram:CreateServiceLinkedRole permission before you can create the service-linked role.
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	The error message returned because the ID of the transit router does not exist.
400	IllegalParam.PeerTransitRouterId	PeerTransitRouterId is illegal.	The error message returned because the ID of the peer transit router is invalid.
400	OperationUnsupported.TransitRouterId	TransitRouterId is unsupported.	The error message returned because Basic Edition transit routers do not support the operation.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	The error message returned because no bandwidth value is specified. You must specify a bandwidth value.
400	IllegalParam.Bandwidth	Bandwidth is illegal.	The error message returned because the specified bandwidth plan ID is invalid.
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.TransitRouterType	The specified TransitRouterType does not support the operation.	The error message returned because this operation is not supported by the specified type of transit router.
400	OperationUnsupported.BandwidthType	The specified BandwidthType does not support the operation.	The error message returned because this operation is not supported by the specified bandwidth type.
400	InvalidCenId.NotFound	CenId is not found.	The error message returned because the specified CEN instance does not exist.
400	IllegalParam.BandwidthType	BandwidthType is illegal.	The error message returned because the specified bandwidth plan type is invalid.
400	MissingParam.CenIdOrRegionId	Either CenId or RegionId must be specified.	The error message returned because the CenId or RegionId parameter is not set.
400	OperationUnsupported.BandwidthHS	This bandwidth limit can only be set in China-AsiaPacific-HS
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter	The error message returned because CEN instances of the Full type do not support Enterprise Edition transit routers.
400	OperationUnsupported.CloudDataTransferService	CCN region not support cloud data transfer service.	The error message returned because the Cloud Data Transfer (CDT) service is not supported in the region of the CCN instance.
400	InvalidPeerTransitRouterId.NotFound	The specified PeerTransitRouterId is not found.	The error message returned because the specified peer transit router ID (PeerTransitRouterId) does not exist.
400	IllegalParam.RegionId	RegionId is illegal.	The error message returned because the specified region is invalid.
400	IllegalParam.PeerRegionId	PeerRegionId is illegal.	The error message returned because the specified peer region ID (PeerRegionId) is invalid.
400	IllegalParam.TransitRouterRegionId	TransitRouterRegionId is illegal.	The error message returned because the specified transit router region ID (TransitRouterRegionId) is invalid.
400	InvalidOperation.CenInstanceStatus	The CEN instance is not in a valid state for the operation.
400	IncorrectStatus.TransitRouter	The status of TransitRouter is incorrect.	The error message returned because the status of the transit router does not support this operation. Try again later.
400	InvalidOperation.BwpNotAssociated	Operation is invalid because a bandwidth package corresponding to the geographic span is not associated.	The error message returned because this operation is not supported when no bandwidth plan is applied to the specified region.
400	InvalidOperation.BwpBusinessStatus	The CBN bandwidth package is not in a valid business state for the operation.	The error message returned because this operation is not supported when the specified bandwidth plan is in an unstable state.
400	IllegalParam.CenBandwidthPackageId	Parameter CenBandwidthPackageId is illegal.	The error message returned because the specified bandwidth plan ID (CenBandwidthPackageId) is invalid.
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.	DataTransfer only support Platinum and Gold.
400	ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold	Cen bandwidthPackage only support Gold.	Cen bandwidthPackage only support Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold	CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version.	CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version.
400	OperationNotAllowed.DefaultLinkTypeOnlySupportGold	Operation is not allowed because this user can only set default link type to Gold.	This user can only set the default link type to 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.	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.
400	OperationInvalid.IdentityRegistrationStatusNotSupport	Real name registration of enterprises required.	Since you have selected a certain region of "Mainland China" in the "Region" or "Opposite Region" , you must complete the enterprise real name registration before subscription. Please refer to the documentation on enterprise real name registration for details.
400	InvalidOperation.OnlyOneRegionSupportIpv6	Peer Attachment is only allowed when both regions support IPv6 or do not support IPv6 at all.	Peer Attachment is only allowed when both regions support IPv6 or do not support IPv6 at all.
400	InvalidOperation	Operation is invalid.	The error message returned because the operation is invalid.
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.	The transit router service of the account to which the resource belongs has been suspended. Please notify the other party to renew the service and try again.
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	OperationUnsupported.RegionId	The specified RegionId does not support the operation.	The error message returned because this operation is not supported in the specified region.
400	QuotaExceeded.Bandwidth	Bandwidth quota exceeded.	Bandwidth quota exceeded.
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.
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.	CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version.
400	ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver	Cen bandwidthPackage only support UnderlaySilver.	When the bandwidth allocation method is bandwidth package, the default link type supports only silver (UnderlaySilver)
400	OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver	This user can only set the default link type to UnderlaySilver.	This user can only set the default link type to UnderlaySilver.
400	OperationFailed.ValidateVbrInstanceFailedForLowLatencyCircuit	Operation failed when validate VBR instance for Low Latency Circuit.	Failed to verify the loaded VBR instance when creating a low latency link.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.