UpdateTransitRouterPeerAttachmentAttribute - Cloud Enterprise Network

Memodifikasi koneksi antar-wilayah pada Router transit edisi perusahaan.

Deskripsi operasi

UpdateTransitRouterPeerAttachmentAttribute adalah operasi asinkron. Setelah mengirim permintaan, sistem akan mengembalikan request ID dan menjalankan tugas di latar belakang. Anda dapat memanggil operasi ListTransitRouterPeerAttachments untuk mengecek status koneksi antar-wilayah.

Jika koneksi antar-wilayah berada dalam status Modifying, koneksi tersebut sedang dalam proses modifikasi. Anda dapat mengecek statusnya, tetapi tidak dapat melakukan operasi lain.
Jika koneksi antar-wilayah berada dalam status Attached, 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: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 permintaan yang berbeda. Token hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak mengatur parameter ini, ClientToken akan diatur ke nilai RequestId. Nilai RequestId untuk setiap permintaan API mungkin berbeda.	02fb3da4-130e-11e9-8e44-001****
TransitRouterAttachmentId	string	Yes	ID koneksi antar-wilayah.	tr-attach-ft94dcrbc3e5taun3x
TransitRouterAttachmentName	string	No	Nama baru koneksi antar-wilayah. Nama dapat kosong atau terdiri dari 1 hingga 128 karakter, dan tidak boleh diawali dengan http:// atau https://.	testname
TransitRouterAttachmentDescription	string	No	Deskripsi baru koneksi antar-wilayah. Parameter ini bersifat opsional. Jika Anda memasukkan deskripsi, panjangnya harus antara 1 hingga 256 karakter, dan tidak boleh diawali dengan http:// atau https://.	testdesc
AutoPublishRouteEnabled	boolean	No	Menentukan apakah router transit edisi perusahaan lokal diaktifkan untuk secara otomatis mengiklankan rute koneksi antar-wilayah ke router transit peer. Nilai yang valid: false (default): tidak true: ya	false
DryRun	boolean	No	Menentukan apakah akan melakukan dry run untuk memeriksa informasi seperti izin dan status instans. Nilai default: false (default): melakukan dry run dan mengirim permintaan. true: melakukan dry run. Sistem memeriksa parameter yang diperlukan dan sintaks permintaan. Jika permintaan gagal dalam dry run, pesan error dikembalikan. Jika permintaan lolos dry run, sistem mengembalikan ID permintaan.	false
Bandwidth	integer	No	Nilai bandwidth koneksi antar-wilayah. Satuan: Mbit/s. Parameter ini menentukan nilai bandwidth maksimum untuk koneksi antar-wilayah jika Anda mengatur BandwidthType ke BandwidthPackage. Parameter ini menentukan ambang batas pembatasan bandwidth untuk koneksi antar-wilayah jika Anda mengatur BandwidthType ke DataTransfer.	2
CenBandwidthPackageId	string	No	ID paket bandwidth yang digunakan untuk mengalokasikan bandwidth ke koneksi antar-wilayah. Catatan Jika Anda mengatur BandwidthType ke DataTransfer, Anda tidak perlu mengatur parameter ini.	cenbwp-3xrxupouolw5ou****
BandwidthType	string	No	Metode alokasi bandwidth. Nilai yang valid: BandwidthPackage: mengalokasikan bandwidth dari paket bandwidth. DataTransfer: bandwidth ditagih berdasarkan metode pengukuran bayar-berdasarkan-transfer-data.	BandwidthPackage
DefaultLinkType	string	No	Jenis jalur default. Nilai yang valid: Platinum dan Gold. Platinum hanya didukung ketika BandwidthType diatur ke DataTransfer.	Gold

Elemen respons

Element	Type	Description	Example
	object	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.	The error message returned because the ID of the network instance does not exist.
400	OperationUnsupported.BandwidthType	The specified BandwidthType does not support the operation.	The error message returned because this operation is not supported by the specified bandwidth type.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	The error message returned because no bandwidth value is specified. You must specify a bandwidth value.
400	IncorrectStatus.Attachment	The resource is not in a valid state for the attachment operation.	The error message returned because the operation is not allowed when the network instance is being processed. Try again later.
400	IllegalParam.BandwidthType	BandwidthType is illegal.	The error message returned because the specified bandwidth plan type is invalid.
400	IllegalParam.Bandwidth	Bandwidth is illegal.	The error message returned because the specified bandwidth plan ID is invalid.
400	ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold	Cen bandwidthPackage only support Gold.	Cen bandwidthPackage only support Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold	DataTransfer only support Platinum and Gold.	DataTransfer only support Platinum and Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold	CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version.	CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version.
400	OperationNotAllowed.DefaultLinkTypeOnlySupportGold	Operation is not allowed because this user can only set default link type to Gold.	This user can only set the default link type to Gold.
400	OperationUnsupported.TransitRouterAttachment	The specified TransitRouterAttachment has configured TransitRegion. Please remove the configuration first.	The error message returned because bandwidth multiplexing is enabled. Disable bandwidth multiplexing and try again.
400	IllegalParam.BandwidthLessThanQosPolicyBandwidth	The input bandwidth value is less than the sum of the Qos policy bandwidth.	The input bandwidth value is less than the sum of the Qos policy bandwidth.
400	IllegalParam.BandwidthPackageStatus	The status of the bandwidth package is incorrect.	The status of the bandwidth package is incorrect.
400	QuotaExceeded.Bandwidth	Bandwidth quota exceeded.	Bandwidth quota exceeded.
400	ParamExclusive.BandwidthTypeAndCenBandwidthPackageId	DataTransfer and CenBandwidthPackageId is mutually exclusive.	When the value of bandwidthType is DataTransfer, the CenBandwidthPackageId field cannot be set.
400	OperationUnsupported.CloudDataTransferService	CCN region not support cloud data transfer service.	The error message returned because the Cloud Data Transfer (CDT) service is not supported in the region of the CCN instance.
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportUnderlaySilver	CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version.	CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version.
400	ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver	Cen bandwidthPackage only support UnderlaySilver.	When the bandwidth allocation method is bandwidth package, the default link type supports only silver (UnderlaySilver)
400	OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver	This user can only set the default link type to UnderlaySilver.	This user can only set the default link type to UnderlaySilver.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.