All Products
Search
Document Center

Cloud Enterprise Network:UpdateTransitRouterVpcAttachmentAttribute

Last Updated:Aug 13, 2026

Operasi UpdateTransitRouterVpcAttachmentAttribute digunakan untuk mengubah nama dan deskripsi koneksi VPC pada router transit Edisi Perusahaan, serta menentukan apakah router transit Edisi Perusahaan secara otomatis memublikasikan entri rute ke instans yang terhubung ke VPC.

Deskripsi operasi

UpdateTransitRouterVpcAttachmentAttribute adalah operasi asinkron. Setelah permintaan dikirim, sistem akan mengembalikan RequestId, namun modifikasi koneksi VPC belum segera diterapkan. Proses modifikasi berjalan di latar belakang. Anda dapat memanggil ListTransitRouterVpcAttachments untuk memeriksa status koneksi VPC.

  • Jika koneksi VPC berada dalam status Modifying, artinya proses modifikasi sedang berlangsung. Dalam status ini, Anda hanya dapat memeriksa koneksi VPC dan tidak dapat melakukan operasi lainnya.

  • Jika koneksi VPC berada dalam status Attached, artinya modifikasi telah selesai diterapkan.

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

update

*TransitRouterVpcAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

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 tersebut, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. 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****

TransitRouterAttachmentId

string

Yes

ID koneksi VPC.

tr-attach-nls9fzkfat8934****

TransitRouterAttachmentName

string

No

Nama koneksi VPC.

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

testname

TransitRouterAttachmentDescription

string

No

Deskripsi koneksi VPC.

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

testdesc

DryRun

boolean

No

Menentukan apakah akan menjalankan dry run, termasuk verifikasi izin dan status instans. Nilai yang valid:

  • false (default): Mengirim permintaan normal. Jika permintaan lolos pemeriksaan, nama dan deskripsi koneksi VPC akan dimodifikasi.

  • true: Mengirim permintaan pemeriksaan. Hanya verifikasi yang dilakukan, dan nama serta deskripsi koneksi VPC tidak dimodifikasi. Sistem memeriksa apakah parameter yang diperlukan telah ditentukan dan apakah format permintaan valid. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, ID permintaan yang sesuai akan dikembalikan.

false

TransitRouterVPCAttachmentOptions

object

No

Daftar atribut fitur koneksi VPC (akan ditinggalkan. Gunakan parameter baru Options sebagai gantinya).

string

No

Properti fitur koneksi VPC (akan ditinggalkan. Gunakan parameter baru Options sebagai gantinya).

ipv6Support: menentukan apakah IPv6 diaktifkan.

  • enable: mengaktifkan IPv6.

  • disable: menonaktifkan IPv6.

Catatan

Sebelum mengaktifkan IPv6 untuk koneksi VPC, pastikan instans yang terhubung-VPC dan instans vSwitch terkait telah mengaktifkan IPv6. Untuk informasi selengkapnya, lihat AllocateVpcIpv6Cidr dan CreateVSwitchCidrReservation.

ipv6Support:enable

AutoPublishRouteEnabled

boolean

No

Menentukan apakah router transit Edisi Perusahaan diizinkan untuk secara otomatis memublikasikan entri rute ke instans yang terhubung-VPC.

  • false: tidak.

  • true: ya.

true

Options

object

No

Kumpulan atribut fitur.

Ipv6Support

string

No

Menentukan apakah IPv6 didukung.

  • disable (default): tidak.

  • enable: ya.

enable

ApplianceModeSupport

string

No

Menentukan apakah mode appliance untuk pengalihan traffic diaktifkan.

  • disable (default): tidak.

  • enable: ya.

enable

OrderType

string

No

Pihak yang membayar instans jaringan.

Valid values:

  • PayByResourceOwner :

    Akun yang memiliki instans jaringan membayar biaya tersebut.

  • PayByCenOwner :

    Akun yang memiliki instans Cloud Enterprise Network (CEN) membayar biaya tersebut.

PayByCenOwner

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

7E61D334-4025-41EF-9145-FC327B35301D

Contoh

Respons sukses

JSONformat

{
  "RequestId": "7E61D334-4025-41EF-9145-FC327B35301D"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IncorrectStatus.TransitRouterAttachmentId TransitRouterAttachmentId status is invalid. Sambungan tidak berada dalam status stabil dan tidak mendukung operasi ini.
400 InvalidTransitRouterAttachmentId.NotFound TransitRouterAttachmentId is not found. TransitRouterAttachmentId yang ditentukan dalam permintaan tidak ada.
400 InvalidOperation.RegionNotSupport The operation is not supported in this region. Wilayah saat ini tidak mendukung operasi ini.
400 InvalidOperation.VpcAutoRoutesPublishInOtherCEN The operation is not supported because the VPC is already set autoRoutesPublish in other CEN.
400 QuotaExceeded.VpcAutoRoutesPublishPerTransitRouter The count of VPC instance which set autoRoutesPublish in transitRouter is over limit.
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 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 OperationInvalid.AttachmentReferencedIPv6RouteEntryExisted Operation is failed because there is at least one route entry(IPv6) which next hop is the specified attachment. Operasi tidak dapat dilakukan karena terdapat entri rute IPv6 yang mengarah ke attachment.
400 OperationInvalid.AttachmentReferencedVpcIPv6RouteEntryExisted The specified attachment is referenced by vpc route entry(IPv6). Operasi tidak didukung karena entri rute IPv6 di VPC mengarah ke attachment. Lakukan purge entri rute dari VPC terlebih dahulu, lalu jalankan operasi ini.
400 OperationInvalid.EniReferencedIPv6RouteEntryExisted Operation is failed because there is at least one route entry(IPv6) which next hop is network interface that the specified attachment referenced. Operasi tidak didukung karena entri rute IPv6 di VPC mengarah ke ENI yang terkait dengan attachment. Lakukan purge entri rute terlebih dahulu, lalu jalankan operasi ini.
400 OperationUnsupported.VpcRoutePropagationSource The operation on this VPC route propagation source is not supported. Operasi pada sumber propagasi rute VPC ini tidak didukung.
400 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation. Operasi ini tidak didukung untuk tipe router transit saat ini.
400 InvalidParameter Invalid parameter. Parameter tidak valid.
400 Unauthorized The AccessKeyId is unauthorized. Akun tidak memiliki izin untuk melakukan operasi ini.
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.Ipv6Support The specified parameter Ipv6Support is invalid. Nilai parameter Ipv6Support tidak valid.
400 InvalidParameter.ApplianceModeSupport The specified parameter ApplianceModeSupport is invalid. Nilai parameter ApplianceModeSupport tidak valid.
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.OrderType The specified parameter OrderType is invalid. Parameter permintaan OrderType tidak valid.
400 InvalidOperation.OrderTypeMustMatchGrantCrossAccount The OrderType must be the same as the OrderType in the grant cross-account record. Pembayar untuk koneksi instans jaringan yang diperbarui harus sama dengan pembayar yang ditentukan dalam catatan otorisasi lintas akun.
400 OperationFailed.GrantCrossAccountNotExist Cross-account authorization does not exist. Otorisasi lintas akun tidak ada.
400 InvalidParameter.CenBandwidthPackageId The specified parameter CenBandwidthPackageId is invalid.
400 InvalidParameter.TransitRouterAttachmentId The specified parameter TransitRouterAttachmentId is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.