UpdateTransitRouterVpcAttachmentAttribute - Cloud Enterprise Network

Anda dapat memanggil operasi UpdateTransitRouterVpcAttachmentAttribute untuk mengubah nama dan deskripsi koneksi VPC pada Router transit edisi perusahaan, serta menentukan apakah router transit secara otomatis mengiklankan rute ke instans VPC.

Deskripsi operasi

UpdateTransitRouterVpcAttachmentAttribute adalah operasi asinkron. Setelah permintaan dikirim, sistem akan mengembalikan RequestId, tetapi modifikasi koneksi VPC tidak langsung diterapkan. Sistem menyelesaikan perubahan tersebut di latar belakang. Anda dapat memanggil operasi ListTransitRouterVpcAttachments untuk memeriksa status koneksi VPC.

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

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

Parameter permintaan

Parameter	Type	Required	Description	Example
ClientToken	string	No	Token client yang digunakan untuk memastikan idempotensi permintaan. Buat nilai unik dari client Anda untuk setiap permintaan. ClientToken hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan sebagai ClientToken. RequestId setiap permintaan berbeda-beda.	02fb3da4-130e-11e9-8e44-001****
TransitRouterAttachmentId	string	Yes	ID koneksi VPC.	tr-attach-nls9fzkfat8934****
TransitRouterAttachmentName	string	No	Nama koneksi VPC. Nama dapat kosong atau terdiri dari 1 hingga 128 karakter. Nama tidak boleh diawali dengan http:// atau https://.	testname
TransitRouterAttachmentDescription	string	No	Deskripsi koneksi VPC. Deskripsi dapat kosong atau terdiri dari 1 hingga 256 karakter. Deskripsi tidak boleh diawali dengan http:// atau https://.	testdesc
DryRun	boolean	No	Menentukan apakah akan melakukan dry run, yang memeriksa masalah seperti izin dan status instans. Nilai yang valid: false (default): mengirim permintaan normal. Setelah permintaan lolos pemeriksaan, sistem akan mengubah nama dan deskripsi koneksi VPC. true: mengirim permintaan pemeriksaan. Sistem memeriksa parameter yang diperlukan dan format permintaan. Sistem tidak mengubah nama atau deskripsi koneksi VPC. Jika pemeriksaan gagal, kesalahan yang sesuai dikembalikan. Jika pemeriksaan berhasil, ID permintaan yang sesuai dikembalikan.	false
TransitRouterVPCAttachmentOptions	object	No	Properti fitur koneksi VPC.
	string	No	Properti fitur koneksi VPC. ipv6Support: Menentukan apakah akan mengaktifkan fitur IPv6. enable: Mengaktifkan fitur IPv6. disable: Menonaktifkan fitur IPv6. Catatan Sebelum mengaktifkan fitur IPv6 untuk koneksi VPC, pastikan fitur IPv6 telah diaktifkan untuk VPC dan instans vSwitch terkaitnya. Untuk informasi selengkapnya, lihat AllocateVpcIpv6Cidr dan CreateVSwitchCidrReservation.	ipv6Support:enable
AutoPublishRouteEnabled	boolean	No	Menentukan apakah Router transit edisi perusahaan diizinkan untuk secara otomatis mengiklankan rute ke instans VPC. false: Tidak. true: Ya.	true

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
400	IncorrectStatus.TransitRouterAttachmentId	TransitRouterAttachmentId status is invalid.
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.
400	InvalidOperation.RegionNotSupport	The operation is not supported in this region.
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.
400	IllegalParam.Ipv6Support	Ipv6Support is illegal. Valid Values are [enable, disable].
400	OperationFailed.VSwitchNotFound	The specified vswitch not found.
400	OperationFailed.VSwitchIpv6CidrNotAllocated	The specified vswitch does not have IPv6 address allocated.
400	OperationInvalid.AttachmentReferencedIPv6RouteEntryExisted	Operation is failed because there is at least one route entry(IPv6) which next hop is the specified attachment.
400	OperationInvalid.AttachmentReferencedVpcIPv6RouteEntryExisted	The specified attachment is referenced by vpc route entry(IPv6).
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.
400	OperationUnsupported.VpcRoutePropagationSource	The operation on this VPC route propagation source is not supported.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.
400	InvalidParameter	Invalid parameter.
400	Unauthorized	The AccessKeyId is unauthorized.
400	INVALID_OPERATION_RESOURCE_NOT_SUPPORT_APPLIANCE_MODE	Only VPC attachment support appliance mode.
400	InvalidParameter.Ipv6Support	The specified parameter Ipv6Support is invalid.
400	InvalidParameter.ApplianceModeSupport	The specified parameter ApplianceModeSupport 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.
400	InvalidParameter.OrderType	The specified parameter OrderType is invalid.
400	InvalidOperation.OrderTypeMustMatchGrantCrossAccount	The OrderType must be the same as the OrderType in the grant cross-account record.
400	OperationFailed.GrantCrossAccountNotExist	Cross-account authorization does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.