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

Membuat koneksi antarwilayah untuk instans router transit Edisi Perusahaan.

Deskripsi operasi

Router transit Edisi Perusahaan mendukung dua metode alokasi bandwidth berikut:
- Alokasi dari paket bandwidth:
  
  Untuk menggunakan metode ini, beli paket bandwidth terlebih dahulu, lalu mengalokasikan bandwidth dari paket bandwidth ke koneksi antarwilayah. Untuk informasi lebih lanjut tentang cara membeli paket bandwidth, lihat CreateCenBandwidthPackage.
- Bayar berdasarkan transfer data:
  
  Untuk menggunakan metode ini, tetapkan batas bandwidth untuk koneksi antarwilayah. Sistem akan menagih Anda berdasarkan transfer data aktual dari koneksi antarwilayah. Untuk informasi lebih lanjut tentang penagihan, lihat Transfer data antarwilayah.
CreateTransitRouterPeerAttachment adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID koneksi antarwilayah, tetapi koneksi antarwilayah belum dibuat. Tugas pembuatan masih berjalan di latar belakang. Anda dapat memanggil ListTransitRouterPeerAttachments untuk mengkueri status koneksi antarwilayah.
- Jika koneksi antarwilayah berada dalam status Attaching, koneksi antarwilayah sedang dibuat. Dalam status ini, Anda hanya dapat mengkueri koneksi antarwilayah dan tidak dapat melakukan operasi lain.
- Jika koneksi antarwilayah berada dalam status Attached, koneksi antarwilayah telah 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 menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut 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 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 DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
TransitRouterAttachmentName	string	No	Nama koneksi antarwilayah. Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh dimulai dengan http:// atau https://.	testname
TransitRouterAttachmentDescription	string	No	Deskripsi koneksi antarwilayah. Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh dimulai 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	Apakah akan mengizinkan router transit Edisi Perusahaan untuk secara otomatis mengiklankan rute koneksi antarwilayah ke wilayah peer. false (default): tidak. true: ya.	false
Bandwidth	integer	No	Nilai bandwidth koneksi antarwilayah. Unit: Mbit/s. Jika BandwidthType diatur ke BandwidthPackage, parameter ini menentukan bandwidth yang dapat digunakan oleh koneksi antarwilayah. Jika BandwidthType diatur ke DataTransfer, parameter ini menentukan batas bandwidth koneksi antarwilayah.	2
CenBandwidthPackageId	string	No	ID paket bandwidth yang akan diasosiasikan dengan koneksi antarwilayah. Catatan Parameter ini tidak diperlukan jika BandwidthType diatur ke DataTransfer.	cenbwp-3xrxupouolw5ou****
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 antarwilayah dibuat. true: mengirim permintaan pemeriksaan. Hanya pemeriksaan yang dilakukan. Koneksi antarwilayah tidak dibuat. Sistem memeriksa apakah parameter yang diperlukan telah diatur dan memvalidasi format permintaan. Jika pemeriksaan gagal, error yang sesuai dikembalikan. Jika pemeriksaan berhasil, ID permintaan yang sesuai dikembalikan.	false
BandwidthType	string	No	Metode alokasi bandwidth koneksi antarwilayah. Nilai valid: BandwidthPackage: mengalokasikan bandwidth dari paket bandwidth. DataTransfer: tidak mengalokasikan bandwidth ke koneksi antarwilayah. Penagihan didasarkan pada transfer data aktual.	BandwidthPackage
Tag	array<object>	No	Informasi tag. Anda dapat menentukan hingga 20 tag sekaligus.
	object	No
Key	string	No	Kunci tag Sumber daya. Kunci tag tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 64 karakter, dan tidak boleh dimulai dengan `aliyun` atau `acs:`. Kunci tag tidak boleh mengandung `http://` atau `https://`. Anda dapat menentukan hingga 20 kunci tag sekaligus.	tag_A1
Value	string	No	Nilai tag Sumber daya. Nilai tag dapat kosong atau memiliki panjang hingga 128 karakter. Nilai tag tidak boleh dimulai dengan `aliyun` atau `acs:`, dan tidak boleh mengandung `http://` atau `https://`. Setiap kunci tag memiliki nilai tag yang unik. Anda dapat menentukan hingga 20 nilai tag sekaligus.	value_A1
DefaultLinkType	string	No	Tipe tautan default. Nilai valid: Platinum dan Gold. Nilai default: Gold. Tipe tautan Platinum hanya dapat dikonfigurasi ketika metode alokasi bandwidth adalah bayar berdasarkan transfer data.	Gold

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
TransitRouterAttachmentId	string	ID koneksi antarwilayah.	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 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	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.	Parameter CenId atau RegionId 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 mode lengkap 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 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 menetapkan 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.	Karena persyaratan operator serta hukum dan peraturan di 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.	Karena Anda memilih wilayah di Tiongkok Daratan untuk wilayah atau wilayah peer, Anda harus menjadi pengguna perusahaan yang telah menyelesaikan verifikasi nama asli perusahaan untuk melanjutkan pembelian. Untuk informasi tentang cara menyelesaikan verifikasi nama asli perusahaan, lihat Dokumentasi verifikasi nama asli.
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 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	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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.