All Products
Search
Document Center

Cloud Enterprise Network:CreateTransitRouterEcrAttachment

Last Updated:Jul 20, 2026

Membuat koneksi antara instans Express Connect Router (ECR) dan instans router transit di wilayah yang sama.

Deskripsi operasi

  • Hanya router transit Edisi Perusahaan yang mendukung koneksi ECR.

  • Anda dapat membuat koneksi ECR pada router transit Edisi Perusahaan dengan cara berikut:

    • Jika Anda telah membuat instans router transit Edisi Perusahaan di wilayah target, Anda dapat membuat koneksi ECR dengan menentukan EcrId, RegionId, dan TransitRouterId.

    • Jika Anda belum memiliki instans router transit Edisi Perusahaan di wilayah target, Anda dapat membuat koneksi ECR dengan menentukan EcrId, CenId, dan RegionId. Sistem akan melakukan pembuatan otomatis instans router transit Edisi Perusahaan saat koneksi ECR dibuat.

  • Operasi CreateTransitRouterEcrAttachment bersifat asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID koneksi ECR, tetapi koneksi ECR belum dibuat. Node pembuatan berjalan di latar belakang. Anda dapat memanggil operasi ListTransitRouterEcrAttachments untuk mengkueri status koneksi ECR.

    • Jika koneksi ECR berada dalam status Attaching, koneksi ECR sedang dibuat. Dalam status ini, Anda hanya dapat menjalankan operasi kueri pada koneksi ECR dan tidak dapat menjalankan operasi lain.

    • Jika koneksi ECR berada dalam status Attached, koneksi ECR telah dibuat.

  • Setelah koneksi ECR dibuat, secara default koneksi tersebut tidak membangun hubungan pembelajaran rute atau penerusan terkait dengan tabel rute router transit Edisi Perusahaan apa pun.

    Setelah koneksi ECR membangun hubungan pembelajaran rute dengan tabel rute router transit Edisi Perusahaan, sistem secara otomatis mempropagasikan entri rute instans ECR ke tabel rute router transit Edisi Perusahaan.

  • Setelah koneksi ECR dibuat, sistem secara otomatis mempropagasikan entri rute dalam tabel rute router transit Edisi Perusahaan yang terkait dengan koneksi ECR ke tabel rute instans ECR.

Sebelum memulai

  • Akun Alibaba Cloud yang memiliki router transit Edisi Perusahaan dan akun Alibaba Cloud yang memiliki instans ECR harus berada di bawah perusahaan yang sama.

  • Router transit Edisi Perusahaan mendukung koneksi ke instans ECR yang berada dalam akun yang sama atau akun berbeda. Sebelum membuat koneksi ECR lintas akun, dapatkan otorisasi dari instans ECR lintas akun. Untuk informasi lebih lanjut, lihat Otorisasi lintas akun untuk instans jaringan.

  • Sebelum memanggil operasi ini untuk membuat koneksi ECR, panggil operasi CreateExpressConnectRouterAssociation untuk mengasosiasikan instans ECR dengan instans router transit Edisi Perusahaan.

    Saat Anda memanggil operasi DeleteTransitRouterEcrAttachment untuk menghapus paksa koneksi ECR, sistem juga menghapus asosiasi antara instans ECR dan instans router transit Edisi Perusahaan. Anda tidak perlu menghapusnya secara terpisah.

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:CreateTransitRouterEcrAttachment

create

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

TransitRouter

acs:cen:*:{#accountId}:centransitrouter/{#TransitRouterId}

None 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 unik di antara berbagai permintaan. 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 mungkin berbeda untuk setiap permintaan API.

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

CenId

string

No

ID instans Cloud Enterprise Network (CEN).

cen-7qthudw0ll6jmc****

TransitRouterId

string

No

ID instans router transit.

tr-bp1su1ytdxtataupl****

RegionId

string

No

ID wilayah instans router transit.

Anda dapat memanggil operasi DescribeChildInstanceRegions untuk mengkueri ID wilayah.

eu-central-1

TransitRouterAttachmentName

string

No

Nama koneksi ECR.

Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh dimulai dengan http:// atau https://.

nametest.

TransitRouterAttachmentDescription

string

No

Deskripsi koneksi ECR.

Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh dimulai dengan http:// atau https://.

testdesc.

EcrId

string

Yes

ID instans Express Connect Router (ECR) yang terkait.

ecr-upyc0viial107r****

EcrOwnerId

integer

No

ID akun Alibaba Cloud dari akun Alibaba Cloud yang memiliki instans ECR. Nilai default adalah ID akun Alibaba Cloud dari akun yang sedang login.

Catatan

Parameter ini diperlukan jika Anda ingin memuat instans jaringan lintas akun.

1250123456123456

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: Menjalankan dry run. Sistem memeriksa parameter yang diperlukan, sintaks permintaan, dan batasan bisnis. Jika pemeriksaan gagal, kode kesalahan yang sesuai dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation dikembalikan.

  • false (default): Menjalankan dry run dan mengirim permintaan. Jika pemeriksaan berhasil, operasi dijalankan.

false.

Tag

array<object>

No

Daftar 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. Panjangnya dapat mencapai 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.

tagtest.

Value

string

No

Nilai tag Sumber daya.

Nilai tag tidak boleh kosong. Panjangnya dapat mencapai 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Nilai tag tidak boleh mengandung http:// atau https://.

Setiap kunci tag berkorespondensi dengan satu nilai tag. Anda dapat menentukan hingga 20 nilai tag sekaligus.

tagtest.

Elemen respons

Element

Type

Description

Example

object

TransitRouterAttachmentId

string

ID koneksi ECR.

tr-attach-qieks13jnt1cchy***

RequestId

string

ID permintaan.

C0245BEF-52AC-44A8-A776-EF96FD26A5CA.

Contoh

Respons sukses

JSONformat

{
  "TransitRouterAttachmentId": "tr-attach-qieks13jnt1cchy***",
  "RequestId": "C0245BEF-52AC-44A8-A776-EF96FD26A5CA"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

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 tertaut layanan. Nama peran: AliyunServiceRolePolicyForCEN. Nama layanan: cen.aliyuncs.com. Pastikan pengguna saat ini telah diberikan izin ram:CreateServiceLinkedRole.
400 OperationUnsupported.TransitRouterRegionId The specified TransitRouterRegion does not support the operation.
400 InvalidCenId.NotFound CenId is not found. CenId yang ditentukan dalam parameter tidak ada.
400 InvalidStatus.ResourceStatus The resource is not in a valid state for the attachment operation. Status Sumber daya saat ini tidak mendukung operasi ini. Coba lagi nanti.
400 InvalidTransitRouterId.NotFound TransitRouterId is not found. TransitRouterId yang ditentukan dalam permintaan tidak ada.
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 MissingParam.CenIdOrRegionId Either CenId or RegionId must be specified. CenId atau RegionId adalah parameter yang diperlukan.
400 IllegalParam.AssociateRouteTableId The specified AssociateRouteTableId is illegal. AssociateRouteTableId yang ditentukan dalam permintaan tidak valid.
400 Forbbiden.AttachChildInstanceAcrossBid Operation is invalid, please apply for cross-bid attaching.
400 IllegalParam.RegionId RegionId is illegal. Region yang ditentukan dalam permintaan tidak valid.
400 OperationUnsupported.CenFullLevel CEN full level does not support TransitRouter Instans CEN mode penuh tidak mendukung VPN BGP.
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 QuotaFull.ChildInstanceRelatedCen The childinstance has exceed the quota of the times that a childinstance can be attached as an attachment. Jumlah instans CEN yang dapat diasosiasikan dengan instans ini telah mencapai batas atas. Instans tidak dapat dimuat.
400 Forbidden.ResourceOwnerTransitRouterServiceNotOpen The resource owner user has not opened transit router service. Layanan router transit akun pemilik Sumber daya belum diaktifkan. Beri tahu pemilik akun untuk mengaktifkan layanan dan coba lagi.
400 OperationUnsupported.BandwidthType The specified BandwidthType does not support the operation. BandwidthType saat ini tidak mendukung operasi ini.
400 IllegalParam.BandwidthType BandwidthType is illegal. Tipe paket bandwidth tidak valid.
400 IncorrectStatus.EcrResource The ECR resource is not in a valid state for the attachment operation. Status Sumber daya ECR tidak valid.
400 QuotaExceeded.CenQuotaEcrAttachPerTransitRouter The maximum number of ECR attachment per Transit Router is exceeded. Jumlah koneksi ECR di bawah router transit telah melebihi batas.
400 OperationUnsupported.ECRAttachment ECR Attachment is not supported. Lampiran ECR tidak didukung.
400 InvalidTransitRouterMode.NeedUpgrade TransitRouter need to upgrade. Mode router transit saat ini tidak didukung.
400 ResourceNotFound The resource does not found. Sumber daya tidak ada.
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 Forbbiden.AttachAcrossBidEcr Attach cross bid ECR is unsupported. Please submit a ticket. Mengikat ECR di bawah akun bid yang berbeda tidak diizinkan. Kirim tiket untuk meminta operasi ini.
400 InvalidParameter Invalid parameter. Parameter tidak valid.
400 Unauthorized The AccessKeyId is unauthorized. Akun tidak memiliki izin untuk melakukan operasi ini.
400 InvalidParameter.ResourceType The specified parameter ResourceType is invalid.
400 SystemBusy The system is busy. Please try again later. Sistem sedang sibuk. Coba lagi nanti.
400 OperationDenied.AttachmentInCurrentRegionExisted The current operation is rejected. The Express Connect Router instance can only associate one Transit Router in the same region.
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.