All Products
Search

This Product

    Cloud Enterprise Network:CreateTransitRouterVpcAttachment

    Document Center

    Cloud Enterprise Network:CreateTransitRouterVpcAttachment

    Last Updated:Sep 15, 2026

    Memanggil operasi CreateTransitRouterVpcAttachment untuk menyambungkan instans Virtual Private Cloud (VPC) ke instans Router transit Edisi Perusahaan guna mengaktifkan peering jaringan pribadi. Setelah attachment dibuat, instans Router transit membantu Anda mengimplementasikan konektivitas jaringan pribadi melalui penerusan dan entri rute.

    Deskripsi operasi

    • Anda dapat membuat sambungan VPC untuk Router transit Edisi Perusahaan dengan dua cara:

      • Jika Anda telah membuat instans Router transit Edisi Perusahaan di wilayah target, tentukan VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, TransitRouterId, dan RegionId untuk membuat sambungan VPC.

      • Jika Anda belum membuat instans Router transit Edisi Perusahaan di wilayah target, tentukan VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, CenId, dan RegionId untuk membuat sambungan VPC. Sistem menggunakan pembuatan otomatis untuk membuat instans Router transit Edisi Perusahaan saat Anda membuat sambungan VPC.

    • CreateTransitRouterVpcAttachment adalah operasi asinkron. Sistem mengembalikan ID sambungan VPC sebelum sambungan VPC dibuat. Tugas pembuatan berjalan di latar belakang. Panggil ListTransitRouterVpcAttachments untuk mengkueri status sambungan VPC.

      • Saat sambungan VPC berada dalam status Attaching, sambungan VPC sedang dibuat. Dalam status ini, Anda hanya dapat mengkueri sambungan VPC dan tidak dapat menjalankan operasi lain.

      • Saat sambungan VPC berada dalam status Attached, sambungan VPC telah dibuat.

    • Setelah sambungan VPC dibuat, sambungan tersebut tidak diasosiasikan dengan tabel rute Router transit mana pun untuk pembelajaran rute atau penerusan rute secara default.

    Sebelum memulai

    Sebelum Anda memanggil operasi ini untuk membuat sambungan VPC, pastikan persyaratan berikut telah terpenuhi:

    • VPC memiliki setidaknya satu vSwitch dengan setidaknya satu alamat IP yang tersedia di zona yang didukung oleh Router transit Edisi Perusahaan. Untuk informasi mengenai wilayah dan zona yang didukung oleh Router transit Edisi Perusahaan, lihat Wilayah dan zona yang didukung Router transit Edisi Perusahaan.

    • Jika Anda ingin menghubungkan instans yang terhubung ke VPC milik akun yang berbeda, dapatkan otorisasi lintas akun terlebih dahulu. Untuk informasi selengkapnya, lihat Otorisasi lintas akun untuk instans yang terhubung ke VPC.

    • Pembuatan sambungan VPC dikenakan biaya. Pastikan Anda memahami aturan penagihan. Untuk informasi selengkapnya, lihat Penagihan.

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

    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.

    Buat nilai unik dari klien Anda untuk parameter ini. ClientToken hanya mendukung karakter ASCII.

    Catatan

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

    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.

    tr-bp1su1ytdxtataupl****
    RegionId

    string

    No

    ID wilayah tempat instans VPC diterapkan.

    Anda dapat memanggil DescribeChildInstanceRegions untuk mengkueri ID wilayah.

    cn-hangzhou
    TransitRouterAttachmentName

    string

    No

    Nama attachment VPC.

    Nama dapat dikosongkan atau berisi 1 hingga 128 karakter. Nama tidak boleh diawali dengan http:// atau https://.

    testname
    TransitRouterAttachmentDescription

    string

    No

    Deskripsi attachment VPC.

    Deskripsi dapat dikosongkan atau berisi 1 hingga 256 karakter. Deskripsi tidak boleh diawali dengan http:// atau https://.

    testname
    VpcId

    string

    Yes

    ID instans VPC.

    vpc-bp1kbjcre9vtsebo1****
    VpcOwnerId

    integer

    No

    ID akun Alibaba Cloud tempat instans VPC berada. Nilai default adalah ID akun Alibaba Cloud yang sedang masuk.

    Catatan

    Parameter ini wajib diisi jika Anda ingin menyambungkan instans jaringan milik akun yang berbeda.

    1250123456123456
    ChargeType

    string

    No

    Metode penagihan. Nilai default: POSTPAY, yang menunjukkan metode penagihan pay-as-you-go.

    POSTPAY
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run pada permintaan, termasuk pemeriksaan izin dan validasi status instans. Nilai valid:

    • false (default): Mengirimkan permintaan normal dan membuat attachment VPC setelah pemeriksaan berhasil. Gunakan nilai ini untuk membuat attachment VPC.

    • true: Mengirimkan permintaan dry run hanya untuk validasi tanpa membuat attachment VPC. Pemeriksaan mencakup apakah parameter yang diperlukan telah ditentukan dan apakah format permintaan valid. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan.

    false
    ZoneMappings

    array<object>

    Yes

    Pilih instans vSwitch di zona yang didukung oleh Router transit Edisi Perusahaan.

    Anda dapat menambahkan hingga 10 entri.

    object

    No

    Informasi mengenai zona yang didukung oleh Router transit Edisi Perusahaan dan instans vSwitch yang sesuai.

    VSwitchId

    string

    Yes

    Instans vSwitch di zona yang didukung oleh Router transit Edisi Perusahaan.

    Anda dapat memilih instans vSwitch untuk hingga 10 zona.

    vsw-bp1a214sbus8z3b54****
    ZoneId

    string

    Yes

    ID zona yang didukung oleh Router transit Edisi Perusahaan.

    Anda dapat memanggil DescribeZones untuk mengkueri ID zona.

    Anda dapat memilih hingga 10 zona.

    cn-hangzhou-h
    AutoPublishRouteEnabled

    boolean

    No

    Apakah Router transit Edisi Perusahaan secara otomatis memublikasikan entri rute ke instans VPC.

    • false (default): tidak memublikasikan entri rute secara otomatis.

    • true: memublikasikan entri rute secara otomatis.

    true
    TransitRouterVPCAttachmentOptions

    object

    No

    Daftar atribut fitur untuk attachment VPC (akan didepresiasi — gunakan parameter Options baru sebagai gantinya).

    string

    No

    Atribut fitur untuk attachment VPC (akan didepresiasi — gunakan parameter Options baru sebagai gantinya).

    ipv6Support: Apakah akan mengaktifkan IPv6.

    • enable: Mengaktifkan IPv6.

    • disable: Menonaktifkan IPv6. Menonaktifkan IPv6 untuk attachment.

    Catatan

    Sebelum mengaktifkan IPv6 untuk attachment VPC, pastikan instans VPC dan instans vSwitch terkait telah mengaktifkan IPv6. Untuk informasi selengkapnya, lihat AllocateVpcIpv6Cidr dan CreateVSwitchCidrReservation.

    disable
    Tag

    array<object>

    No

    Daftar tag.

    Anda dapat menentukan hingga 20 tag.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag resource.

    Jika parameter ini ditentukan, nilainya tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 64 karakter dan tidak boleh diawali dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.

    Anda dapat menentukan hingga 20 kunci tag.

    tagtest
    Value

    string

    No

    Nilai tag resource.

    Jika parameter ini ditentukan, nilainya tidak boleh kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh diawali 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 pasangan kunci-nilai tag.

    tagtest
    Options

    object

    No

    Kumpulan atribut fitur.

    ApplianceModeSupport

    string

    No

    Apakah akan mengaktifkan mode pengalihan trafik appliance jaringan.

    • disable (default): dinonaktifkan.

    • enable: diaktifkan.

    enable
    Ipv6Support

    string

    No

    Apakah akan mengaktifkan dukungan IPv6.

    • disable (default): dinonaktifkan.

    • enable: diaktifkan.

    enable

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Hasil respons.

    RequestId

    string

    ID permintaan.

    C087A369-82B9-43EF-91F4-4B63A9C6E6B6
    TransitRouterAttachmentId

    string

    ID attachment VPC.

    tr-attach-ia340z7xis7t5s****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "C087A369-82B9-43EF-91F4-4B63A9C6E6B6",
  "TransitRouterAttachmentId": "tr-attach-ia340z7xis7t5s****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 OperationUnsupported.TransitRouterRegionId The specified TransitRouterRegion does not support the operation.
    400 NoPermission.AliyunServiceRoleForCEN You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. Tidak diotorisasi.
    400 IllegalParam.RegionId The Specified Parameter RegionId is illegal Region yang ditentukan dalam permintaan tidak valid.
    400 MissingParam.CenIdOrRegionId Either CenId or RegionId must be specified. CenId atau RegionId adalah parameter yang diperlukan.
    400 IllegalParam.ZoneId The specified ZoneId is illegal. Zona yang ditentukan tidak valid.
    400 IllegalParam.ChargeType The specified ChargeType is illegal. Tipe penagihan tidak valid.
    400 InvalidTransitRouterId.NotFound The specified TransitRouterId is not found. TransitRouterId yang ditentukan dalam permintaan tidak ada.
    400 IncorrectStatus.VpcResource The resource is not in a valid state for the attachment operation. Sumber daya VPC tidak berada dalam status stabil. Tunggu hingga operasi terkait pada VPC saat ini selesai dan coba lagi.
    400 IncorrectStatus.Vpc The resource is not in a valid state for the attachment operation. Status saat ini dari VPC tidak mendukung operasi ini. Coba lagi nanti.
    400 IncorrectStatus.VpcOrVswitch The Vpc Or Vswith is not in a valid state for the attachment operation. Status saat ini dari VPC atau vSwitch tidak mendukung operasi ini. Coba lagi nanti.
    400 OperationNotSupport.VpcAutoRoutesPublish Auto publish vpc routes is not supported in this region. Wilayah saat ini tidak mendukung pengumuman rute VPC otomatis.
    400 InvalidOperation.VpnAssociated The operation is not supported because the VPC is associated with VPN. VPC saat ini menyambungkan ke VPN. Fitur sinkronisasi otomatis rute tidak dapat diaktifkan.
    400 Forbbiden.TransitRouterServiceNotOpen The user has not open transit router service. Layanan router transit belum diaktifkan. Aktifkan dan coba lagi.
    400 IllegalParam.ZoneMappings The Specified Parameter ZoneMappings is illegal ZoneMappings yang ditentukan dalam parameter tidak valid.
    400 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation. Operasi ini tidak didukung untuk tipe router transit saat ini.
    400 InvalidCenId.NotFound CenId is not found. CenId yang ditentukan dalam parameter tidak ada.
    400 IllegalParam.VSwitchId VSwitchId is illegal. VSwitchId yang ditentukan dalam parameter tidak valid.
    400 IncorrectStatus.TransitRouterInstance The status of TransitRouter is incorrect. Router transit berada dalam status tidak valid.
    400 OperationUnsupported.CenFullLevel CEN full level does not support TransitRouter Instans CEN dalam mode Full tidak mendukung VPN BGP.
    400 IllegalParam.ServiceMode ServiceMode is illegal. ServiceMode yang ditentukan dalam permintaan tidak valid.
    400 QuotaFull.ChildInstanceRelatedCen The childinstance has exceed the quota of the times that a childinstance can be attached as an attachment. Jumlah instans Cloud Enterprise Network (CEN) yang dapat diasosiasikan dengan instans ini telah mencapai batas atas. Instans tidak dapat dimuat.
    400 OperationUnsupported.CloudBoxVswNotSupport Cloud Box vsw does not support. vSwitch CloudBox tidak dapat dimuat.
    400 IncorrectStatus.TransitRouter The status of TransitRouter is incorrect. Status saat ini dari router transit tidak mendukung operasi ini. Coba lagi nanti.
    400 Duplicated.ZoneMapping The parameter ZoneMapping is duplicated. ZoneMapping berisi entri duplikat.
    400 QuotaExceeded.CenQuotaVpcAttachPerTransitRouter The maximum number of VPC attachment per Transit Router is exceeded. Jumlah virtual private cloud (VPC) yang dapat disambungkan ke setiap router transit telah melebihi batas.
    400 IncorrectStatus.VpcRouteTable The VPC route table is not in a desired state. Tabel rute VPC yang terkait dengan operasi ini tidak berada dalam status stabil. Coba lagi nanti.
    400 InvalidStatus.VpcAttachedFullModeCen The VPC has been attached to another CEN instance whose protection level is FULL. VPC yang ditentukan sudah terhubung dengan instans CEN lain yang memiliki tingkat perlindungan FULL dan tidak dapat terhubung dengan instans CEN lainnya.
    400 Forbbiden.AttachChildInstanceAcrossBid VPCs that belong to another BID cannot be associated. You need to apply for cross-BID attaching. Mengikat VPC di bawah akun bid yang berbeda tidak diizinkan.
    400 InvalidOperation.VpcAutoRoutesPublishInOtherCEN The specified VPC already has its routes synchronized with another CEN instance. VPC saat ini telah mengaktifkan sinkronisasi otomatis rute di CEN lain. Operasi ini tidak didukung.
    400 QuotaExceeded.VpcAutoRoutesPublishPerTransitRouter The number of VPCs that have route synchronization enabled has reached the upper limit. Jumlah VPC dengan sinkronisasi otomatis perutean diaktifkan telah mencapai batas atas.
    400 InsufficientIpAddr.vsw Insufficient available IP addresses in the vSwitch. Jumlah alamat IP aktif di vSwitch tidak mencukupi.
    400 Forbidden.ResourceOwnerTransitRouterServiceNotOpen The resource owner user has not opened transit router service. Layanan router transit dari akun pemilik Sumber daya belum diaktifkan. Beri tahu pemilik akun untuk mengaktifkan layanan dan coba lagi.
    400 IllegalParam.TransitRouterRegionId TransitRouterRegionId is illegal. TransitRouterRegionId tidak valid.
    400 InvalidTransitRouterMode.NeedUpgrade TransitRouter need to upgrade. Mode router transit saat ini tidak didukung.
    400 IllegalParam.Ipv6Support Ipv6Support is illegal. Valid Values are [enable, disable]. Nilai parameter permintaan Ipv6Support tidak valid. Nilai valid: enable dan disable.
    400 OperationFailed.VSwitchNotFound The specified vswitch not found. VSwitchId yang ditentukan tidak ada. Pastikan vSwitch tersedia atau tentukan vSwitch lain yang tersedia.
    400 OperationFailed.VSwitchIpv6CidrNotAllocated The specified vswitch does not have IPv6 address allocated. IPv6 tidak diaktifkan untuk vSwitch yang ditentukan. Aktifkan IPv6 sebelum melakukan operasi ini.
    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 dari 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. Lakukan perpanjangan layanan dan coba lagi.
    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 ParamExclusive.TransitRouterVPCAttachmentOptionsAndOptions When creating or modifying a VPC attachment, the input parameter TransitRouterVPCAttachmentOptions and Options cannot be used at the same time. Saat membuat atau memodifikasi konektivitas jaringan VPC, parameter TransitRouterVPCAttachmentOptions dan Options tidak dapat digunakan secara bersamaan.
    400 InvalidParameter.ApplianceModeSupport The specified parameter ApplianceModeSupport is invalid. Nilai parameter ApplianceModeSupport tidak valid.
    400 InvalidParameter.Ipv6Support The specified parameter Ipv6Support is invalid. Nilai parameter Ipv6Support tidak valid.
    400 INVALID_OPERATION_RESOURCE_NOT_SUPPORT_APPLIANCE_MODE Only VPC attachment support appliance mode. Hanya konektivitas jaringan VPC yang mendukung pola pengalihan trafik otomatis.
    400 InvalidParameter.TagValue The specified parameter TagValue is invalid. Parameter Nilai Tag tidak valid.
    400 InvalidParameter.CenBandwidthPackageId The specified parameter CenBandwidthPackageId is invalid.
    400 InvalidParameter.CenId The specified parameter CenId is invalid.
    400 InvalidParameter.TransitRouterId The specified parameter TransitRouterId is invalid.
    400 InvalidParameter.AssociateRouteTableId The specified parameter AssociateRouteTableId is invalid.
    400 OperationFailed.PostPay95BwpNotAllowEnterpriseTr Cbn with post pay 95 bandwidth package does not allow enterprise tr. Instans Cloud Enterprise Network (CEN) yang menggunakan paket bandwidth persentil ke-95 warisan tidak diizinkan membuat router transit Edisi Perusahaan.
    400 OperationUnsupported.VpcRoutePropagationSource The operation on this VPC route propagation source is not supported. Operasi pada sumber propagasi rute VPC ini tidak didukung.
    404 InvalidVSwitchId.NotFound The specified VSwitchId is not found. VSwitchId tidak ada.
    409 InvalidOperation.CenInstanceStatus The CEN instance is not in a valid state for the operation. Status CEN saat ini tidak mendukung operasi ini. Coba lagi nanti.
    409 IncorrectStatus.VpcSwitch The resource is not in a valid state for the attachment operation.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.