Panggil UpdateTransitRouterPeerAttachmentAttribute untuk mengubah atribut koneksi antar wilayah - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Mengubah konfigurasi koneksi antarwilayah pada router transit Edisi Perusahaan.

Deskripsi operasi

UpdateTransitRouterPeerAttachmentAttribute adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan RequestId, tetapi koneksi antarwilayah belum diubah. Tugas modifikasi terus berjalan di latar belakang. Anda dapat memanggil ListTransitRouterPeerAttachments untuk mengkueri status koneksi antarwilayah.

Jika koneksi antarwilayah berada dalam status Modifying, koneksi antarwilayah sedang dimodifikasi. Dalam status ini, Anda hanya dapat mengkueri koneksi antarwilayah dan tidak dapat melakukan operasi lain padanya.
Jika koneksi antarwilayah berada dalam status Attached, koneksi antarwilayah 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:UpdateTransitRouterPeerAttachmentAttribute

update

*TransitRouterPeerAttachment

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

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 berbagai permintaan. Token klien hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId sebagai ClientToken. RequestId dari setiap permintaan API mungkin berbeda.	02fb3da4-130e-11e9-8e44-001****
TransitRouterAttachmentId	string	Yes	ID koneksi antarwilayah.	tr-attach-ft94dcrbc3e5taun3x.
TransitRouterAttachmentName	string	No	Nama baru koneksi antarwilayah. Nama dapat kosong atau memiliki panjang 1 hingga 128 karakter, dan tidak boleh dimulai dengan http:// atau https://.	testname.
TransitRouterAttachmentDescription	string	No	Deskripsi baru koneksi antarwilayah. Deskripsi dapat kosong atau memiliki panjang 1 hingga 256 karakter, dan tidak boleh dimulai dengan http:// atau https://.	testdesc.
AutoPublishRouteEnabled	boolean	No	Apakah akan mengizinkan router transit Edisi Perusahaan untuk secara otomatis mengiklankan rute koneksi antarwilayah ke wilayah peer. false (default): tidak. true: ya.	false.
DryRun	boolean	No	Apakah akan menjalankan dry run, termasuk verifikasi izin dan status instans. Nilai valid: false (default): mengirim permintaan normal dan langsung mengubah konfigurasi koneksi antarwilayah setelah permintaan lulus pemeriksaan. true: mengirim permintaan pemeriksaan. Hanya pemeriksaan yang dilakukan dan konfigurasi koneksi antarwilayah tidak diubah. Item pemeriksaan mencakup apakah parameter wajib ditentukan dan format permintaan. Jika pemeriksaan gagal, error yang sesuai dikembalikan. Jika pemeriksaan berhasil, ID permintaan yang sesuai dikembalikan.	false.
Bandwidth	integer	No	Nilai bandwidth koneksi antarwilayah. Unit: Mbit/s. Jika BandwidthType diatur ke BandwidthPackage, parameter ini menentukan bandwidth yang dapat digunakan oleh koneksi antarwilayah. Jika BandwidthType diatur ke DataTransfer, parameter ini menentukan batas bandwidth koneksi antarwilayah.	2
CenBandwidthPackageId	string	No	ID paket bandwidth yang akan diasosiasikan dengan koneksi antarwilayah. Catatan Jika BandwidthType diatur ke DataTransfer, Anda tidak perlu mengonfigurasi parameter ini.	cenbwp-3xrxupouolw5ou****
BandwidthType	string	No	Metode alokasi bandwidth. Nilai valid: BandwidthPackage: mengalokasikan bandwidth dari paket bandwidth. DataTransfer: tidak mengalokasikan bandwidth ke koneksi antarwilayah. Penagihan didasarkan pada volume trafik.	BandwidthPackage.
DefaultLinkType	string	No	Tipe tautan default. Nilai valid: Platinum dan Gold. Nilai default: Gold. Nilai hanya dapat diatur ke Platinum ketika metode alokasi bandwidth adalah bayar-per-transfer-data.	Gold.

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	A01FEDD7-7D69-4EB3-996D-CF79F6F885CA.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "A01FEDD7-7D69-4EB3-996D-CF79F6F885CA"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.	TransitRouterAttachmentId yang ditentukan dalam permintaan tidak ada.
400	OperationUnsupported.BandwidthType	The specified BandwidthType does not support the operation.	BandwidthType saat ini tidak mendukung operasi ini.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	Parameter nilai bandwidth diperlukan.
400	IncorrectStatus.Attachment	The resource is not in a valid state for the attachment operation.	Status attachment saat ini tidak mendukung operasi ini. Coba lagi nanti.
400	IllegalParam.BandwidthType	BandwidthType is illegal.	Tipe paket bandwidth tidak valid.
400	IllegalParam.Bandwidth	Bandwidth is illegal.	ID paket bandwidth tidak valid.
400	ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold	Cen bandwidthPackage only support Gold.	Ketika metode alokasi bandwidth diatur ke paket bandwidth, tipe tautan default hanya mendukung Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold	DataTransfer only support Platinum and Gold.	Ketika metode alokasi bandwidth adalah bayar per transfer data, tipe tautan default hanya mendukung Platinum dan Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold	CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version.	Ketika router transit di kedua ujung koneksi antar-wilayah tidak semuanya Edisi Perusahaan dan metode alokasi bandwidth adalah bayar per transfer data, tipe tautan default hanya mendukung Gold.
400	OperationNotAllowed.DefaultLinkTypeOnlySupportGold	Operation is not allowed because this user can only set default link type to Gold.	Pengguna ini hanya dapat menetapkan jenis tautan default ke Gold.
400	OperationUnsupported.TransitRouterAttachment	The specified TransitRouterAttachment has configured TransitRegion. Please remove the configuration first.	Konfigurasi multiplexing bandwidth ada. Hapus dan coba lagi.
400	IllegalParam.BandwidthLessThanQosPolicyBandwidth	The input bandwidth value is less than the sum of the Qos policy bandwidth.	Nilai bandwidth yang ditentukan kurang dari total batas laju yang dialokasikan oleh bandwidth QoS.
400	IllegalParam.BandwidthPackageStatus	The status of the bandwidth package is incorrect.	Paket bandwidth berada dalam status yang salah.
400	QuotaExceeded.Bandwidth	Bandwidth quota exceeded.	Nilai bandwidth melebihi batas kuota.
400	ParamExclusive.BandwidthTypeAndCenBandwidthPackageId	DataTransfer and CenBandwidthPackageId is mutually exclusive.	Ketika metode alokasi bandwidth adalah CDT, bidang CenBandwidthPackageId tidak dapat diatur.
400	OperationUnsupported.CloudDataTransferService	CCN region not support cloud data transfer service.	Layanan Cloud Data Transfer tidak didukung di wilayah CCN.
400	InvalidParameter	Invalid parameter.	Parameter tidak valid.
400	Unauthorized	The AccessKeyId is unauthorized.	Akun tidak memiliki izin untuk melakukan operasi ini.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportUnderlaySilver	CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version.	Ketika router transit di kedua ujung koneksi antar-wilayah tidak semuanya Edisi Perusahaan dan metode alokasi bandwidth adalah bayar-per-transfer-data, tipe tautan default hanya mendukung Silver (UnderlaySilver).
400	ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver	Cen bandwidthPackage only support UnderlaySilver.	Ketika metode alokasi bandwidth adalah paket bandwidth, tipe tautan default hanya mendukung Silver (UnderlaySilver).
400	OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver	This user can only set the default link type to UnderlaySilver.	Pengguna ini hanya dapat mengatur tipe tautan default ke Silver (UnderlaySilver).
400	InvalidOperation.QueueLinkTypeNotEqualsAttachmentLinkType	The operation is invalid because the link type of an existing QoS queue does not match the link type of the attachment.	Dalam Kebijakan QoS yang dikonfigurasi, tipe tautan antrian berbeda dari tipe tautan koneksi lintas wilayah.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.