ModifyVSwitchAttribute - Virtual Private Cloud - Alibaba Cloud Documentation Center

Mengubah konfigurasi vSwitch tertentu.

Deskripsi operasi

ModifyVSwitchAttribute adalah operasi asinkron. Setelah Anda memanggil operasi ini, sistem akan mengembalikan ID permintaan, tetapi konfigurasi vSwitch belum diubah. Tugas modifikasi masih berjalan di latar belakang. Anda dapat memanggil DescribeVSwitchAttributes untuk mengkueri status modifikasi vSwitch:
- Jika vSwitch berada dalam status Pending, konfigurasi sedang dimodifikasi.
- Jika vSwitch berada dalam status Available, vSwitch tersedia.
ModifyVSwitchAttribute tidak mendukung modifikasi konkuren pada vSwitch yang sama.

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

vpc:ModifyVSwitchAttribute

update

*VSwitch.

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
VSwitchId	string	Yes	ID vSwitch.	vsw-25nacdfvue4****
VSwitchName	string	No	Nama baru vSwitch. Panjang nama harus 1 hingga 128 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	VSwitch-1
RegionId	string	No	ID wilayah vSwitch. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
Description	string	No	Deskripsi baru vSwitch. Panjang deskripsi harus 1 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	Ini adalah vSwitch saya
Ipv6CidrBlock	integer	No	8 bit terakhir dari Blok CIDR IPv6 vSwitch. Nilai valid: 0 hingga 255. Anda hanya dapat mengatur parameter ini ketika IPv6 diaktifkan untuk VPC tempat vSwitch berada. Parameter ini memungkinkan Anda mengalokasikan Blok CIDR IPv6 ke vSwitch. Setelah Blok CIDR IPv6 dialokasikan, blok tersebut tidak dapat diubah ke Blok CIDR lain. Pastikan bahwa Blok CIDR tidak tumpang tindih dengan vSwitch lain di VPC yang sama.	10
Ipv6CidrMask	integer	No	Masker Blok CIDR IPv6 vSwitch. Anda hanya dapat mengatur parameter ini ketika IPv6 diaktifkan untuk VPC tempat vSwitch berada. Catatan Hanya 64 yang didukung.	64
EnableIPv6	boolean	No	Apakah akan mengaktifkan IPv6 untuk vSwitch. Nilai valid: true: Mengaktifkan IPv6. IPv6 harus diaktifkan untuk VPC tempat vSwitch berada. Anda juga harus menentukan Ipv6CidrBlock untuk mengalokasikan Blok CIDR IPv6 ke vSwitch. false (default): Menonaktifkan IPv6. Sebelum menonaktifkan IPv6 untuk vSwitch, pastikan tidak ada alamat IPv6 yang sedang digunakan. Anda tidak dapat menentukan Ipv6CidrBlock secara bersamaan.	false
VpcIpv6CidrBlock	string	No	Blok CIDR IPv6 VPC tempat vSwitch berada. Jika VPC memiliki beberapa Blok CIDR IPv6, Anda dapat menentukan parameter ini untuk menunjukkan rentang Blok CIDR IPv6 untuk vSwitch. Jika Anda tidak menentukan parameter ini, Blok CIDR IPv6 yang ditetapkan saat IPv6 diaktifkan untuk VPC akan digunakan.	2408:XXXX:312:3e00::/56

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	Format nama vSwitch tidak valid. Periksa format nama vSwitch.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.	Deskripsi vSwitch tidak valid.
400	Forbidden.VRouterNotFound	specified virtual switch is not found during access authentication.	vSwitch yang ditentukan tidak ditemukan selama otentikasi akses.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	CloudBox tidak mendukung pembuatan IPv6.
400	OperationFailed.Ipv6InstanceExist	Operation failed because vswitch has ipv6 instance.	Terdapat instans IPv6 di vSwitch.
400	IncorrectStatus.VpcRouteEntry	The status of the specified routeEntry is invalid.	Status entri rute VPC salah.
400	OperationFailed.IPv6Disabled	Operation failed because IPv6 is not enabled for the vSwitch.	Operasi yang ditentukan gagal karena fitur IPv6 tidak diaktifkan.
400	ParamExclusive.DisableIpv6AndIpv6CidrBlock	DisableIpv6 and Ipv6Cidr are mutually exclusive.	Operasi konflik. Anda tidak dapat mengubah Ipv6Cidr dan menonaktifkan fitur IPv6 secara bersamaan.
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	Status CBN saat ini salah.
400	DependencyViolation.IPv6CidrReservation	The specified resource of [%s] depends on [%s], so the operation cannot be completed.	Sumber daya [%s] bergantung pada blok CIDR IPv6 yang dipesan. Hapus Sumber daya yang bergantung sebelum melakukan operasi ini.
400	IllegalParam.VpcIpv6CidrBlock	The parameter of VpcIPv6CidrBlock is illegal.	Parameter VpcIPv6CidrBlock tidak valid.
400	OperationFailed.Ipv6AlreadyEnabled	Operation failed because the IPv6 is enabled already.	Operasi gagal karena IPv6 sudah diaktifkan.
400	OperationFailed.Ipv6CidrBlockExisted	Operation failed because the specified IPv6 CIDR block is used already.	Operasi gagal karena blok CIDR IPv6 yang ditentukan sudah digunakan.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.	Blok CIDR IPv6 tidak valid.
400	InvalidDescription.Malformed	The specified Description is wrongly formed.	Format deskripsi Sumber daya yang ditentukan tidak valid. Deskripsi harus memiliki panjang 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.
400	OperationFailed.VpcIpv6Disabled	Operation failed because the VPC has not enabled IPv6.	Operasi saat ini tidak didukung karena IPv6 tidak diaktifkan untuk VPC.
400	IncorrectStatus.VSwitch	The specified vSwitch status is invalid.
400	OperationFailed.Ipv6CidrBlockUsed	Operation failed because the specified IPv6 CIDR block is used already.	Operasi gagal karena blok CIDR IPv6 yang ditentukan sudah digunakan.
400	TaskConflict	The operation is too frequent. Please wait a moment and try again.	Operasi EIP terlalu sering.
400	OperationDenied.HasSecondaryZone	The operation is not allowed because the VSwitch has a secondary zone.	Operasi IPv6 tidak diizinkan ketika vSwitch memiliki zona sekunder yang dikonfigurasi.
400	OperationDenied.VpcIpv6CidrBlockNotExist	The specified VpcIpv6CidrBlock does not exist in the VPC.	VpcIpv6CidrBlock yang ditentukan tidak ada di VPC.
400	OperationDenied.AvailableCidrInsufficient	Insufficient available CIDR blocks for allocation. This is either because the VPC has no remaining address space, or because the candidate CIDR contains destination networks of active non-system routes in the VPC.	Operasi ditolak karena sumber daya Blok CIDR yang tersedia tidak mencukupi.
400	OperationDenied.Ipv6CidrMaskInvalid	The specified Ipv6CidrMask is invalid, only %s is allowed.	Masker IPv6 yang ditentukan tidak valid. Hanya %s yang didukung.
400	MissingParam.Ipv6CidrBlockOrIpv6CidrMask	Ipv6CidrBlock or Ipv6CidrMask must be specified.	Setidaknya satu dari Ipv6CidrBlock atau Ipv6CidrMask harus ditentukan.
500	SystemBusy	The system is busy. Please try again later.	Sistem sedang sibuk. Coba lagi nanti.
404	InvalidVSwitchId.NotFound	The specified virtual switch does not exists.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.