All Products
Search
Document Center

Express Connect:CreateExpressConnectRouterAssociation

Last Updated:Sep 24, 2026

Mengaitkan virtual private cloud (VPC) atau Router transit (TR) dengan Express Connect Router (ECR).

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

expressconnectrouter:CreateExpressConnectRouterAssociation

none

*ExpressConnectRouter.

acs:expressconnectrouter::{#accountId}:expressconnectrouter/{#EcrId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

EcrId

string

Yes

ID instans Express Connect Router (ECR).

ecr-mezk2idmsd0vx2****

AssociationRegionId

string

Yes

ID wilayah tempat Sumber daya yang dikaitkan berada.

cn-hangzhou

TransitRouterOwnerId

integer

No

ID akun Alibaba Cloud dari akun yang memiliki instans Router transit. Nilai default: ID akun Alibaba Cloud dari akun yang sedang masuk.

Catatan

Parameter ini wajib diisi jika Anda ingin memuat instans jaringan yang dimiliki oleh akun lain.

189159362009****

TransitRouterId

string

No

ID Router transit. Parameter TransitRouterId dan VpcId saling eksklusif. Anda harus menentukan salah satunya. Buat Router transit dengan memanggil API CreateTransitRouter dari produk Cbn(2017-09-12) dan dapatkan TransitRouterId.

tr-2ze4i71c6be454e2l****

CenId

string

No

ID instans Cloud Enterprise Network (CEN).

Catatan

CenId wajib diisi ketika TransitRouterId ditentukan. Buat instans CEN dengan memanggil API CreateCen dari produk Cbn(2017-09-12) dan dapatkan CenId.

cen-of3o1the3i4gwb****

VpcOwnerId

integer

No

ID akun Alibaba Cloud dari akun yang memiliki instans yang terhubung ke VPC. Nilai default: ID akun Alibaba Cloud dari akun yang sedang masuk.

Catatan

Parameter ini wajib diisi jika Anda ingin memuat instans jaringan yang dimiliki oleh akun lain.

132193271328****

VpcId

string

No

ID instans yang terhubung ke VPC.

Catatan

Parameter VpcId dan TransitRouterId saling eksklusif. Anda harus menentukan salah satunya. Buat VPC dengan memanggil API CreateVpc dari produk Vpc(2016-04-28) dan dapatkan VpcId.

vpc-bp1h37fchc6jmfyln****

AllowedPrefixes

array

No

Daftar entri rute awalan yang diizinkan.

string

No

Entri rute awalan yang diizinkan.

192.0.20.0/24

CreateAttachment

boolean

No

Apakah akan memulai pengaitan saat ECR dilampirkan ke TR. Nilai valid:

  • true: Pengaitan tidak perlu dimulai dari sisi Router transit.

  • false: Pengaitan perlu dimulai dari sisi Router transit.

true

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: Menjalankan dry run. Sistem memeriksa permintaan untuk potensi masalah tanpa mengubah Sumber daya EPS apa pun.

  • false (default): Mengirim permintaan seperti biasa.

false

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Buat nilai parameter dari klien Anda untuk memastikan keunikan di berbagai permintaan. ClientToken hanya mendukung karakter ASCII.

Catatan

Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.

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

AllowedPrefixesMode

string

No

Mode entri rute awalan. Nilai valid:

  • MatchMode: mode pencocokan. Hanya Blok CIDR entri rute yang dikonfigurasi yang diiklankan ke IDC, dan entri rute spesifik yang sebelumnya diiklankan ditarik kembali.

  • IncrementalMode: mode inkremental. Blok CIDR entri rute yang dikonfigurasi diiklankan ke IDC. Entri rute spesifik yang sebelumnya diiklankan dan berada dalam Blok CIDR yang dikonfigurasi ditarik kembali, sedangkan entri rute spesifik yang tidak berada dalam Blok CIDR yang dikonfigurasi tetap diiklankan.

MatchMode

Description

string

No

Deskripsi Sumber daya yang dikaitkan. Deskripsi harus memiliki panjang 0 hingga 128 karakter.

test

Tag

array<object>

No

Daftar tag.

Anda dapat mengikat hingga 20 tag.

object

No

Key

string

No

Kunci tag Sumber daya. Jika Anda menentukan parameter ini, nilainya tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 128 karakter dan tidak boleh diawali dengan aliyun atau acs:. Tidak boleh mengandung http:// atau https://.

TestKey

Value

string

No

Nilai tag Sumber daya. Nilai tag dapat berupa string kosong dan dapat memiliki panjang hingga 128 karakter. Tidak boleh mengandung http:// atau https://.

TestValue

Elemen respons

Element

Type

Description

Example

object

RpcResponse

AccessDeniedDetail

string

Detail tentang penolakan akses.

Authentication is failed for ****

AssociationId

string

ID pengaitan antara Express Connect Router (ECR) dan VPC atau TR.

ecr-assoc-9p2qxx5phpca2m****

Code

string

Kode tanggapan. Nilai 200 menunjukkan bahwa pengaitan berhasil. Nilai lain menunjukkan kegagalan. Untuk informasi lebih lanjut, lihat kode kesalahan.

200

DynamicCode

string

Kode kesalahan dinamis.

IllegalParamFormat.EcrId

DynamicMessage

string

Paket kesalahan dinamis, yang digunakan untuk mengganti placeholder %s dalam parameter ErrMessage.

Catatan

Jika ErrMessage mengembalikan The Value of Input Parameter %s is not valid dan DynamicMessage mengembalikan DtsJobId, nilai parameter permintaan DtsJobId tidak valid.

The param format of EcrId **** is illegal

HttpStatusCode

integer

Kode status HTTP.

200

Message

string

Paket yang dikembalikan.

OK

RequestId

string

ID permintaan.

05130E79-588D-5C40-A718-C4863A59****

Success

boolean

Apakah panggilan berhasil. Nilai valid:

  • True: Panggilan berhasil.

  • False: Panggilan gagal.

True

Contoh

Respons sukses

JSONformat

{
  "AccessDeniedDetail": "Authentication is failed for ****",
  "AssociationId": "ecr-assoc-9p2qxx5phpca2m****",
  "Code": "200",
  "DynamicCode": "IllegalParamFormat.EcrId",
  "DynamicMessage": "The param format of EcrId **** is illegal",
  "HttpStatusCode": 200,
  "Message": "OK",
  "RequestId": "05130E79-588D-5C40-A718-C4863A59****",
  "Success": true
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IncorrectStatus.Ecr Ecr Status does not allow current operation. Status instans Express Connect Router (ECR) tidak mengizinkan operasi ini. Operasi lain sedang dijalankan atau instans Express Connect Router (ECR) sedang dihapus. Coba lagi nanti.
400 OperationDenied.ForceDeleting The current instance is being deleted. Operasi ditolak. Instans Express Connect Router (ECR) sedang dihapus secara paksa. Coba lagi nanti.
400 UnsupportedRegion Feature not supported in specified region. Wilayah tertentu tidak mendukung fitur Express Connect Router (ECR).
400 QuotaExceeded.VpcCountPerEcr The number of VPC bound to the ECR exceeds the quota. Jumlah VPC yang dapat dikaitkan ke satu instans Express Connect Router (ECR) telah mencapai batas kuota. Hubungi manajer akun Anda untuk meminta peningkatan kuota.
400 QuotaExceeded.TrCountPerEcr The number of TR bound to the ECR exceeds the quota. Jumlah Router transit (TR) yang dapat dikaitkan ke satu instans Express Connect Router (ECR) telah mencapai batas kuota. Hubungi manajer akun Anda untuk meminta peningkatan kuota.
400 IllegalParamFormat.AllowedPrefixes The prefix parameter format is invalid. Procedure. Format blok CIDR awalan entri rute yang ditentukan tidak valid.
400 OperationDenied.NotGrantedByNodeOwner The node owner is not authorized. Operasi Anda ditolak. Produk Express Connect Router (ECR) tidak diotorisasi.
400 OperationFailed.CdtNotOpened The Cdt function is disabled. Operasi gagal karena fitur transfer data Alibaba Cloud tidak diaktifkan.
400 OperationFailed.CdtCrossBoarderNotOpened The Cdt cross-border transmission function is disabled. Operasi gagal karena fitur transfer data lintas batas Alibaba Cloud tidak diaktifkan.
400 OperationFailed.CrossBorderNotAllowed There is no qualification for creating cross-border links. Operasi gagal. Perusahaan saat ini tidak memiliki izin untuk membuat koneksi lintas batas. Hubungi manajer akun Anda untuk menambahkan izin ini.
400 ResourceNotFound.CenId CenId not found. Instans CEN tidak ada.
400 ResourceNotFound.TrId TRId not found. Instans TR tidak ada.
400 Conflict.ASNOfVBR ASN already used by other VBR. localAsn dari VBR BgpGroup tidak konsisten dengan ASN ECR. Sesuaikan agar konsisten dan ikat ulang.
400 MissingParam.%s The param of %s is missing. Parameter permintaan yang diperlukan tidak ada. Verifikasi parameter dan coba lagi.
400 IllegalParamFormat.%s The param format of %s is illegal. Format parameter tidak valid.
400 IllegalParamFormat.CenId The format of the entered Cen instance ID is incorrect. Format ID instans CEN yang ditentukan tidak valid.
400 OperationDenied.CrossBidAssociating Cross-border binding of resources is subject to compliance constraints. Pengikatan melibatkan interkoneksi antara sumber daya di situs Tiongkok dan sumber daya di situs internasional. Karena batasan kepatuhan, hubungi manajer akun Anda untuk bantuan.
400 ExclusiveParam.TransitRouterIdAndVpcId A private network instance cannot be bound to a forwarding router instance at the same time. Instans VPC dan instans entri rute transit tidak dapat diikat pada waktu yang sama. Ikat hanya salah satunya.
400 IllegalParamSize.AllowedPrefixes The number of prefix routes exceeded the quota. Jumlah awalan entri rute melebihi kuota. Ajukan peningkatan kuota.
400 OperationDenied.CrossAccountAttaching If the forwarding router is bound to another account, perform this operation on the same account. Operasi ditolak. Untuk mengikat entri rute transit yang merupakan milik akun lain, lakukan operasi ini di bawah akun tersebut.
400 OperationDenied.AttachmentInCurrentRegionExisted Only one forwarding router can be bound to an area. Operasi ditolak. Instans Express Connect Router (ECR) hanya dapat menyambungkan satu entri rute transit dalam area yang sama untuk perutean dan penerusan.
400 Conflict.Lock There are other unfinished operations. Operasi lain sedang berlangsung. Coba lagi nanti.
400 OperationFailed.CallingVpcYaochi The system is abnormal. Please try again later. Operasi gagal karena kesalahan sistem internal. Coba lagi nanti. Jika masalah berlanjut, hubungi manajer akun Anda untuk mendapatkan bantuan.
400 ResourceAlreadyExist.TransitRouterId The specified resource of transit router already exists. Sumber daya TR tertentu sudah dikaitkan dengan Express Connect Router (ECR). Verifikasi sumber daya dan coba lagi.
400 ResourceAlreadyExist.VpcId The specified resource of VpcId already exists. Sumber daya VPC tertentu sudah dikaitkan dengan Express Connect Router (ECR). Verifikasi sumber daya dan coba lagi.
400 Conflict.AllowedPrefixes The allowed route prefixes [%s] is conflict. Awalan entri rute yang ditentukan sudah ada. Verifikasi konfigurasi dan kirim ulang permintaan.
400 UnsupportedFeature.JumboFrame The region where the sub-instance is located does not support the jumbo frame feature and cannot be attached to the express connect router. Wilayah instans anak tidak mendukung fitur frame jumbo dan tidak dapat dimuat ke Express Connect Router (ECR).
400 InternalErrorTemp The request processing has failed due to some unknown error. Terjadi error internal. Coba lagi. Jika error tetap muncul setelah beberapa kali percobaan ulang, ajukan tiket.
400 OperationFailed.AlreadyExistPropagationSource The operation failed because an existing propagation source is already configured for the instance. Sumber propagasi entri rute sudah ada untuk instans ini. Instans tidak dapat disambungkan ke Express Connect Router (ECR) lagi.
400 OperationFailed.CloudBoxVSwitchExist The operation failed because the VPC contains a CloudBox vSwitch. VPC berisi vSwitch CloudBox dan tidak dapat disambungkan ke Express Connect Router (ECR).
400 OperationFailed.CloudBoxVbrExist The operation is not allowed because a CloudBox VBR already exists on this ECR association. CloudBox VBR sudah ada pada asosiasi ini. Operasi tidak dapat dilanjutkan.
400 OperationFailed.NoRouteTableInVpc The operation failed because no system route table is found in the VPC. Tidak ditemukan tabel rute sistem di VPC. Asosiasi tidak dapat dibuat.
400 OperationFailed.TrServiceNotOpened The operation is not allowed because the Transit Router service is not opened. Layanan Router transit (TR) belum diaktifkan. Aktifkan layanan dan coba lagi.
400 OperationFailed.TrServiceExpired The operation is not allowed because the Transit Router service has expired. Layanan Router transit (TR) telah kedaluwarsa atau memiliki pembayaran tertunda. Lakukan perpanjangan layanan dan coba lagi.
400 IncorrectStatus.Vpc The status of the VPC is incorrect. Status VPC saat ini tidak mendukung operasi ini. Tunggu hingga VPC kembali ke status stabil dan coba lagi.
400 IncorrectStatus.VpcOperating The VPC is operating and does not support this operation. Operasi lain sedang dilakukan pada VPC. Tunggu hingga operasi selesai dan coba lagi.
400 IncorrectStatus.Vswitch The status of the vSwitch is incorrect. Status vSwitch saat ini tidak mendukung operasi ini. Tunggu hingga vSwitch kembali ke status stabil dan coba lagi.
400 IncorrectStatus.RouteEntry The status of the route entry is incorrect. Status entri rute saat ini tidak mendukung operasi ini. Tunggu hingga entri rute kembali ke status stabil dan coba lagi.
400 OperationDenied.ViolateRegionMutuallyExclusive The operation is not allowed because the region violates the mutually exclusive constraint. Batasan saling eksklusif wilayah dilanggar. Wilayah ini tidak dapat menyambungkan ke Express Connect Router (ECR) yang sama bersama dengan wilayah yang sudah terasosiasi.
404 ResourceNotFound.EcrId EcrId not found. Instans ECR tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.