All Products
Search
Document Center

Express Connect:CreateExpressConnectRouterAssociation

Last Updated:Dec 19, 2025

Menghubungkan Express Connect Router (ECR) dengan virtual private cloud (VPC) atau TransitRouter.

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

create

*ExpressConnectRouter

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

EcrId

string

Yes

ID ECR.

ecr-mezk2idmsd0vx2****

AssociationRegionId

string

Yes

ID wilayah resource yang akan disambungkan.

cn-hangzhou

TransitRouterOwnerId

integer

No

ID Akun Alibaba Cloud tempat transit router berada. Nilai default adalah ID Akun Alibaba Cloud saat ini.

Catatan

Parameter TransitRouterOwnerId wajib ditentukan jika Anda ingin menyambungkan instance jaringan yang dimiliki oleh akun lain.

189159362009****

TransitRouterId

string

No

ID transit router.

tr-2ze4i71c6be454e2l****

CenId

string

No

ID Cloud Enterprise Network (CEN).

cen-of3o1the3i4gwb****

VpcOwnerId

integer

No

ID Akun Alibaba Cloud tempat VPC berada. Nilai default adalah ID Akun Alibaba Cloud saat ini.

Catatan

Parameter ini wajib ditentukan jika Anda ingin menyambungkan instance jaringan yang dimiliki oleh akun lain.

132193271328****

VpcId

string

No

ID VPC.

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

Menentukan apakah akan membuat attachment saat Anda menyambungkan instance ECR dengan transit router. Nilai yang valid:

  • true: Anda tidak perlu membuat attachment pada transit router.

  • false: Anda perlu membuat attachment pada transit router.

true

DryRun

boolean

No

Menentukan apakah akan melakukan dry run. Nilai yang valid:

  • true: Mengirim permintaan pemeriksaan tanpa mengubah sumber daya layanan.

  • false (Default): Mengirim permintaan normal.

false

ClientToken

string

No

Token client yang digunakan untuk memastikan idempotensi permintaan.

Pastikan token client unik untuk setiap permintaan. Token hanya boleh berisi karakter ASCII.

Catatan

Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan sebagai ClientToken. RequestId dapat berbeda untuk setiap permintaan.

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

AllowedPrefixesMode

string

No

Pola entri rute awalan. Nilai yang valid:

  • MatchMode: Hanya CIDR yang dikonfigurasi yang diiklankan ke pusat data. Entri rute yang lebih spesifik yang sebelumnya diiklankan akan ditarik.

  • IncrementalMode: CIDR yang dikonfigurasi diiklankan ke pusat data. Entri rute yang lebih spesifik yang berada dalam blok CIDR yang dikonfigurasi akan ditarik. Entri rute yang lebih spesifik yang berada di luar rentang tersebut tetap diiklankan.

MatchMode

Description

string

No

Deskripsi instance yang disambungkan. Panjang deskripsi harus antara 0 hingga 128 karakter.

test

Elemen respons

Element

Type

Description

Example

object

RpcResponse

RequestId

string

ID permintaan.

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

Success

boolean

Menunjukkan apakah panggilan berhasil. Nilai yang valid:

  • True: Panggilan berhasil.

  • False: Panggilan gagal.

True

Code

string

Menunjukkan apakah panggilan berhasil. Nilai kembali 200 menunjukkan bahwa panggilan berhasil. Nilai lain menunjukkan bahwa panggilan gagal. Lihat bagian Kode Kesalahan.

200

Message

string

Pesan yang dikembalikan untuk operasi tersebut.

OK

HttpStatusCode

integer

Kode status HTTP.

200

DynamicCode

string

Kode kesalahan dinamis.

IllegalParamFormat.EcrId

DynamicMessage

string

Pesan kesalahan dinamis yang digunakan untuk menggantikan placeholder %s dalam parameter ErrMessage.

Catatan

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

The param format of EcrId **** is illegal.

AccessDeniedDetail

string

Detail penolakan akses.

Authentication is failed for ****

AssociationId

string

ID asosiasi antara instance ECR dan VPC atau transit router.

ecr-assoc-9p2qxx5phpca2m****

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IncorrectStatus.Ecr Ecr Status does not allow current operation. The status of the express connect gateway instance does not allow the current operation. Currently, other operations are being performed or the express connect gateway instance is being deleted. Please try again later.
400 OperationDenied.ForceDeleting The current instance is being deleted. Your current operation is rejected and the leased line gateway instance is being forcibly deleted. Please try again later.
400 UnsupportedRegion Feature not supported in specified region. The specified region does not support the leased line gateway function.
400 QuotaExceeded.VpcCountPerEcr The number of VPC bound to the ECR exceeds the quota. The number of VPCs that can be bound to a dedicated gateway instance has reached the quota limit. Please contact your business manager to apply for a larger quota.
400 QuotaExceeded.TrCountPerEcr The number of TR bound to the ECR exceeds the quota. The number of TRs that can be bound to a dedicated gateway instance has reached the quota limit. Please contact your business manager to apply for a larger quota.
400 IllegalParamFormat.AllowedPrefixes The prefix parameter format is invalid. Procedure. The format of the specified prefix route segment is incorrect.
400 OperationDenied.NotGrantedByNodeOwner The node owner is not authorized. Your current operation is rejected, and the leased line gateway product is not authorized.
400 OperationFailed.CdtNotOpened The Cdt function is disabled. The current operation fails, and the Alibaba Cloud data transmission function is not enabled.
400 OperationFailed.CdtCrossBoarderNotOpened The Cdt cross-border transmission function is disabled. The current operation fails. The cross-border data transmission function of Alibaba Cloud is not enabled.
400 OperationFailed.CrossBorderNotAllowed There is no qualification for creating cross-border links. The operation failed. The current enterprise does not have the permission to create cross-border links. Please contact your business manager to add this permission.
400 ResourceNotFound.CenId CenId not found. Cen instance does not exist
400 ResourceNotFound.TrId TRId not found. TR instance does not exist
400 Conflict.ASNOfVBR ASN already used by other VBR. The current VBR BgpGroup localAsn is inconsistent with the ECR asn. Adjust the consistency and rebind.
400 MissingParam.%s The param of %s is missing. The request parameters are not specified. Please check the corresponding parameters and try again.
400 IllegalParamFormat.%s The param format of %s is illegal. Illegal parameter format
400 IllegalParamFormat.CenId The format of the entered Cen instance ID is incorrect. The format of the currently entered Cen instance ID is incorrect
400 OperationDenied.CrossBidAssociating Cross-border binding of resources is subject to compliance constraints. Your current binding resources involve cross-Chinese site resources and overseas site resources. Due to compliance constraints, please contact your business manager for communication and handling.
400 ExclusiveParam.TransitRouterIdAndVpcId A private network instance cannot be bound to a forwarding router instance at the same time. The VPC instance and the forwarding router instance cannot be bound at the same time, please select one of the instances to bind after adjustment.
400 IllegalParamSize.AllowedPrefixes The number of prefix routes exceeded the quota. The number of prefix routes you have entered exceeds the quota. Please apply for expansion.
400 OperationDenied.CrossAccountAttaching If the forwarding router is bound to another account, perform this operation on the same account. The current operation is rejected. When you bind another account to the forwarding router, you need to do this operation under this account.
400 OperationDenied.AttachmentInCurrentRegionExisted Only one forwarding router can be bound to an area. The current operation is rejected. The leased line gateway instance can only bind one forwarding router in the same region.
400 Conflict.Lock There are other unfinished operations. You currently have other unfinished operations, please try again later
400 OperationFailed.CallingVpcYaochi The system is abnormal. Please try again later. The operation failed and the system is abnormal. Please try again later. If the retry still fails, please contact your business manager for help.
400 ResourceAlreadyExist.TransitRouterId The specified resource of transit router already exists. The specified TR resource has been associated with the leased line gateway ECR. Check and try again.
400 ResourceAlreadyExist.VpcId The specified resource of VpcId already exists. The specified VPC resource has been associated with the leased line gateway ECR. Please check and try again.
400 Conflict.AllowedPrefixes The allowed route prefixes [%s] is conflict. The currently configured AllowedPrefixes already exists. Please confirm and submit it again.
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.
400 InternalErrorTemp The request processing has failed due to some unknown error. The request processing has failed due to some unknown error.
404 ResourceNotFound.EcrId EcrId not found. ECR instance does not exist

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.