All Products
Search
Document Center

Virtual Private Cloud:ModifyVSwitchAttribute

Last Updated:Jun 12, 2026

Mengubah konfigurasi vSwitch tertentu dengan memanggil operasi ModifyVSwitchAttribute.

Deskripsi operasi

  • ModifyVSwitchAttribute adalah operasi asinkron. Setelah Anda memanggil operasi ini, sistem akan mengembalikan ID permintaan, tetapi konfigurasi vSwitch tidak langsung diubah. Sistem menjalankan tugas modifikasi di latar belakang. Anda dapat memanggil operasi DescribeVSwitchAttributes untuk mengkueri status modifikasi vSwitch:
    • Jika vSwitch berada dalam status Pending, konfigurasi vSwitch sedang dimodifikasi.

    • Jika vSwitch berada dalam status Available, vSwitch tersedia.

  • Operasi ModifyVSwitchAttribute tidak mengizinkan modifikasi konkuren pada konfigurasi 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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

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 operasi 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://.

This is my vswitch.

Ipv6CidrBlock

integer

No

8 bit terakhir dari Blok CIDR IPv6 vSwitch. Nilai valid: 0 hingga 255.

Anda dapat menentukan parameter ini untuk mengalokasikan Blok CIDR IPv6 ke vSwitch hanya jika IPv6 diaktifkan untuk VPC tempat vSwitch berada. Setelah Blok CIDR IPv6 dialokasikan ke vSwitch, Blok CIDR tidak dapat diubah. Pastikan bahwa Blok CIDR tidak tumpang tindih dengan Blok CIDR vSwitch lain di VPC.

10

EnableIPv6

boolean

No

Apakah akan mengaktifkan IPv6 untuk vSwitch. Nilai valid:

  • true: Mengaktifkan IPv6. IPv6 harus diaktifkan untuk VPC tempat vSwitch berada, dan Anda harus menentukan Ipv6CidrBlock untuk mengalokasikan Blok CIDR IPv6 ke vSwitch.

  • false (default): Menonaktifkan IPv6. Sebelum Anda menonaktifkan IPv6 untuk vSwitch, pastikan tidak ada alamat IPv6 yang sedang digunakan, dan Anda tidak dapat menentukan Ipv6CidrBlock pada pengatur waktu yang sama.

false

VpcIpv6CidrBlock

string

No

Blok CIDR IPv6 VPC tempat vSwitch berada. Jika VPC tempat vSwitch berada memiliki beberapa Blok CIDR IPv6, Anda dapat menentukan parameter ini untuk menentukan Blok CIDR IPv6 tempat vSwitch berada. Jika Anda tidak menentukan parameter ini, Blok CIDR IPv6 yang mengalokasikan 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.
400 InvalidVSwitchDiscription.Malformed Specified virtual switch description is not valid.
400 Forbidden.VRouterNotFound specified virtual switch is not found during access authentication.
400 UnsupportedFeature.CloudBoxIpv6 The IPv6 feature is not supported by cloud box.
400 OperationFailed.Ipv6InstanceExist Operation failed because vswitch has ipv6 instance.
400 IncorrectStatus.VpcRouteEntry The status of the specified routeEntry is invalid.
400 OperationFailed.IPv6Disabled Operation failed because IPv6 is not enabled for the vSwitch.
400 ParamExclusive.DisableIpv6AndIpv6CidrBlock DisableIpv6 and Ipv6Cidr are mutually exclusive.
400 IncorrectStatus.cbnStatus Current CBN status does not support this operation.
400 DependencyViolation.IPv6CidrReservation The specified resource of [%s] depends on [%s], so the operation cannot be completed.
400 IllegalParam.VpcIpv6CidrBlock The parameter of VpcIPv6CidrBlock is illegal.
400 OperationFailed.Ipv6AlreadyEnabled Operation failed because the IPv6 is enabled already.
400 OperationFailed.Ipv6CidrBlockExisted Operation failed because the specified IPv6 CIDR block is used already.
400 IllegalParam.Ipv6CidrBlock The parameter of Ipv6CidrBlock is illegal.
400 InvalidDescription.Malformed The specified Description is wrongly formed.
400 OperationFailed.VpcIpv6Disabled Operation failed because the VPC has not enabled IPv6.
400 IncorrectStatus.VSwitch The specified vSwitch status is invalid.
400 OperationFailed.Ipv6CidrBlockUsed Operation failed because the specified IPv6 CIDR block is used already.
400 TaskConflict The operation is too frequent. Please wait a moment and try again.
500 SystemBusy The system is busy. Please try again later.
404 InvalidVSwitchId.NotFound The specified virtual switch does not exists.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.