Gunakan UpdateTransitRouter untuk memodifikasi nama dan deskripsi TransitRouter - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Mengubah nama dan deskripsi instans router transit.

Deskripsi operasi

UpdateTransitRouter adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan RequestId, tetapi modifikasi instans router transit belum selesai. Tugas modifikasi tetap berjalan di latar belakang. Anda dapat memanggil operasi ListTransitRouters untuk mengkueri status instans router transit.

Jika instans router transit berada dalam status Modifying, instans router transit sedang dimodifikasi. Dalam status ini, Anda hanya dapat mengkueri instans router transit. Anda tidak dapat melakukan operasi lain padanya.
Jika instans router transit berada dalam status Active, instans router transit telah dimodifikasi.

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

update

*TransitRouter.

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

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 tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem akan menggunakan RequestId sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	02fb3da4-130e-11e9-8e44-001****
DryRun	boolean	No	Apakah akan menjalankan dry run untuk permintaan modifikasi ini, termasuk pemeriksaan izin dan status instans. Nilai valid: false (default): Mengirim permintaan normal. Setelah permintaan lulus pemeriksaan, informasi instans router transit akan langsung dimodifikasi. true: Mengirim permintaan pemeriksaan. Hanya validasi yang dilakukan, dan informasi instans router transit tidak dimodifikasi. Item pemeriksaan mencakup apakah parameter wajib ditentukan dan format permintaan. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, ID permintaan yang sesuai akan dikembalikan.	false
RegionId	string	Yes	ID wilayah instans router transit. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-shanghai
TransitRouterId	string	Yes	ID instans router transit.	tr-uf654ttymmljlvh2x****
TransitRouterName	string	No	Nama baru instans router transit. Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak dapat diawali dengan http:// atau https://.	testname
TransitRouterDescription	string	No	Deskripsi baru instans router transit. Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak dapat diawali dengan http:// atau https://.	testdesc

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	E9963DD7-998B-4F92-892D-8293CB49EE81

Contoh

Respons sukses

JSONformat

{
  "RequestId": "E9963DD7-998B-4F92-892D-8293CB49EE81"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	OperationUnsupported.RegionId	The specified region ID is not supported.	Wilayah saat ini tidak mendukung operasi ini.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	Router transit berada dalam status tidak valid.
400	InvalidParameter	Invalid parameter.	Parameter tidak valid.
400	Unauthorized	The AccessKeyId is unauthorized.	Akun tidak memiliki izin untuk melakukan operasi ini.
400	OperationFailed.ZoneNotSupportJumbo	The following zones do not support Jumbo Frame: %s.	Gagal mengaktifkan frame jumbo. Zona %s yang digunakan oleh router transit saat ini tidak mendukung frame jumbo.
400	OperationFailed.TransitRouterNotSupportJumbo	This transit router does not support Jumbo Frame in available zones: %s. Please contact Alibaba Cloud support for assistance.	Router transit tidak mendukung frame jumbo di zona %s. Hubungi Alibaba Cloud untuk dukungan.
400	ParamExclusive.SupportJumboFrameAndSupportMulticast	Transit Router can not support JumboFrame and Multicast at the same time.	Router transit tidak mendukung pengaktifan frame jumbo dan multicast secara bersamaan.
400	OperationUnsupported.MulticastAndJumboFrameAreExclusive	The operation is not supported because the multicast and jumbo frame are exclusive.	Router transit tidak dapat mengaktifkan multicast dan frame jumbo secara bersamaan.
400	OperationUnsupported.SupportJumboFrame	JumboFrame is unsupported.	Fitur frame jumbo tidak didukung.
400	OperationUnsupported.DisableJumboFrame	Disable JumboFrame is not supported.	Penonaktifan fitur frame jumbo pada router transit tidak didukung.
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.
400	OperationUnsupported.TransitRouterType	The operation is not supported because of the wrong transitRouter type.	Operasi ini tidak didukung untuk tipe router transit saat ini.
404	Instance.NotExist	The instance is not exist.	Instans yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.