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

Mengubah koneksi antar-wilayah pada router transit Edisi Perusahaan.

Deskripsi operasi

UpdateTransitRouterPeerAttachmentAttribute is an asynchronous operation. After you send a request, the system returns a request ID and runs the task in the background. You can call the ListTransitRouterPeerAttachments operation to query the status of an inter-region connection.

If an inter-region connection is in the Modifying state, the inter-region connection is being modified. You can query the inter-region connection but cannot perform other operations.
If an inter-region connection is in the Attached state, the inter-region connection is modified.

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 menetapkan parameter ini, ClientToken ditetapkan 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 memiliki panjang 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 1 hingga 256 karakter, dan tidak boleh diawali dengan http:// atau https://.	testdesc
AutoPublishRouteEnabled	boolean	No	Apakah akan mengaktifkan Router transit Edisi Perusahaan lokal untuk secara otomatis mengiklankan rute koneksi antar-wilayah ke router transit peer. Nilai valid: false (default): tidak true: ya.	false
DryRun	boolean	No	Apakah akan menjalankan dry run untuk memeriksa informasi seperti izin dan status Instans. Nilai default: false (default): menjalankan dry run dan mengirim permintaan. true: menjalankan dry run. Sistem memeriksa parameter yang diperlukan dan sintaks permintaan. Jika permintaan gagal dalam dry run, Paket error akan dikembalikan. Jika permintaan berhasil dalam dry run, sistem mengembalikan ID permintaan.	false
Bandwidth	integer	No	Nilai bandwidth dari koneksi antar-wilayah. Unit: Mbit/s. Parameter ini menentukan nilai bandwidth maksimum untuk koneksi antar-wilayah jika Anda menetapkan BandwidthType ke BandwidthPackage. Parameter ini menentukan ambang batas Pembatasan bandwidth untuk koneksi antar-wilayah jika Anda menetapkan BandwidthType ke DataTransfer.	2
CenBandwidthPackageId	string	No	ID Paket bandwidth yang digunakan untuk mengalokasikan bandwidth ke koneksi antar-wilayah. Catatan Jika Anda menetapkan BandwidthType ke DataTransfer, Anda tidak perlu menetapkan parameter ini.	cenbwp-3xrxupouolw5ou****
BandwidthType	string	No	Metode Alokasi bandwidth. Nilai valid: BandwidthPackage: mengalokasikan bandwidth dari Paket bandwidth. DataTransfer: bandwidth ditagih berdasarkan metode pengukuran pay-by-data-transfer.	BandwidthPackage
DefaultLinkType	string	No	Jenis jalur default. Nilai valid: Platinum dan Gold. Platinum hanya didukung ketika BandwidthType ditetapkan ke DataTransfer.	Gold

Elemen respons

Element	Type	Description	Example
	object	The response.
RequestId	string	The ID of the request.	A01FEDD7-7D69-4EB3-996D-CF79F6F885CA

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.
400	OperationUnsupported.BandwidthType	The specified BandwidthType does not support the operation.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.
400	IncorrectStatus.Attachment	The resource is not in a valid state for the attachment operation.
400	IllegalParam.BandwidthType	BandwidthType is illegal.
400	IllegalParam.Bandwidth	Bandwidth is illegal.
400	ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold	Cen bandwidthPackage only support Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold	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.
400	OperationNotAllowed.DefaultLinkTypeOnlySupportGold	Operation is not allowed because this user can only set default link type to Gold.
400	OperationUnsupported.TransitRouterAttachment	The specified TransitRouterAttachment has configured TransitRegion. Please remove the configuration first.
400	IllegalParam.BandwidthLessThanQosPolicyBandwidth	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.
400	QuotaExceeded.Bandwidth	Bandwidth quota exceeded.
400	ParamExclusive.BandwidthTypeAndCenBandwidthPackageId	DataTransfer and CenBandwidthPackageId is mutually exclusive.
400	OperationUnsupported.CloudDataTransferService	CCN region not support cloud data transfer service.
400	InvalidParameter	Invalid parameter.
400	Unauthorized	The AccessKeyId is unauthorized.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportUnderlaySilver	CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version.
400	ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver	Cen bandwidthPackage only support UnderlaySilver.
400	OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver	This user can only set the default link type to 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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.