All Products
Search
Document Center

Virtual Private Cloud:DeleteVSwitch

Last Updated:Jul 14, 2026

Menghapus vSwitch.

Deskripsi operasi

Sebelum memanggil operasi ini untuk menghapus vSwitch, perhatikan hal-hal berikut:

  • Sebelum menghapus vSwitch, rilis atau pindahkan semua Sumber daya di VPC, termasuk vSwitch, instans layanan cloud, antarmuka router, dan HaVip.

  • Hanya vSwitch dalam status Available yang dapat dihapus.

  • vSwitch tidak dapat dihapus jika VPC tempat vSwitch berada sedang membuat atau menghapus vSwitch atau entri rute.

  • Operasi DeleteVSwitch bersifat asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID permintaan, tetapi vSwitch belum dihapus. Tugas penghapusan masih berjalan di latar belakang. Anda dapat memanggil DescribeVSwitchAttributes untuk mengkueri status penghapusan vSwitch:

    • Jika vSwitch berada dalam status Pending, vSwitch sedang dihapus.

    • Jika vSwitch yang ditentukan tidak ditemukan, vSwitch telah dihapus.

  • Operasi DeleteVSwitch tidak mendukung penghapusan konkuren untuk 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:DeleteVSwitch

delete

*VSwitch

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

VSwitchId

string

Yes

ID vSwitch yang akan dihapus.

vsw-asdfjlna****

RegionId

string

No

ID wilayah vSwitch yang akan dihapus.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

cn-hangzhou

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: Menjalankan dry run tanpa benar-benar menghapus vSwitch. Sistem memeriksa parameter wajib, format permintaan, dan batasan bisnis. Jika pemeriksaan gagal, kode kesalahan yang sesuai dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation dikembalikan.

  • false (default): Mengirim permintaan Normal. Setelah pemeriksaan berhasil, kode status HTTP 2xx dikembalikan dan operasi hapus vSwitch dijalankan.

false

Elemen respons

Element

Type

Description

Example

object

Parameter tanggapan.

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 OperationDenied.OtherSubnetProcessing other subnet is processing. vSwitch tidak dapat dihapus karena subnet lain sedang dioperasikan.
400 IncorrectVSwitchStatus vpc subnet is in middle status.
400 DependencyViolation Resources deployed in the vSwitch have not been deleted. Operasi tidak dapat dilakukan karena entri rute dalam tabel rute saat ini berada dalam status pending atau modifying.
400 IncorrectRouteEntryStatus Some route entry status blocked this operation.
400 DependencyViolation.HaVip VSwitch cannot be deleted when there are some HaVip dependent with it. Tidak dapat menghapus vSwitch karena memiliki elastic IP addresses (HaVips) ketersediaan tinggi yang terkait.
400 DependencyViolation.RouteTable VSwitch cannot be deleted when associated with route table
400 MissingParameter Miss mandatory parameter.
400 TaskConflict The operation is too frequent, TaskConflict. Operasi terlalu sering. Tunggu sebentar dan coba lagi.
400 DependencyViolation.SNAT The vswitch cannot be deleted when used by snat. vSwitch tidak dapat dihapus karena sedang digunakan oleh aturan SNAT.
400 DeleteVSwitch.IncorrectStatus.cbnStatus Current CBN status does not support this operation. Status CEN saat ini tidak mendukung operasi penghapusan vSwitch.
400 AttrMismatching.NaclAndBindInstance The network acl and resource not in same vpc.
400 InvalidResource.NotBinding The resource has not been binded.
400 DependencyViolation.SnatEntry VSwitch cannot be deleted when snat entry exist.
400 DependencyViolation.NetworkAcl VSwitch cannot be deleted when network acl exist. vSwitch tidak dapat dihapus karena terdapat ACL jaringan.
400 DependencyViolation.EnhancedNatgw VSwitch cannot be deleted when natgw exist. vSwitch tidak dapat dihapus karena terdapat NAT gerbang.
400 DependencyViolation.ResourceShare VSwitch cannot be deleted when resource share exist.
400 OperationFailed.SystemBusy Operation failed because system is busy. Sistem sibuk. Coba lagi nanti.
400 DependencyViolation.MulticastDomain VSwitch cannot be deleted when associated with multicast domain. vSwitch tidak dapat dihapus karena telah bergabung dengan domain multicast.
400 DependencyViolation.VSwitchCidrReservation VSwitch cannot be deleted when vswitch cidr reservation exist. vSwitch tidak dapat dihapus karena memiliki VSwitchCidrReservation yang sedang digunakan.
400 DependencyViolation.CloudService VSwitch cannot be deleted when uesd by cloud service. vSwitch tidak dapat dihapus karena sedang digunakan oleh layanan cloud. Konfirmasi skenario layanan cloud.
400 InvalidVSwitchId.NotFound VSwitch not exist.
400 OperationFailed.Ipv6InstanceExist Operation failed because vswitch has ipv6 instance. Instans IPv6 ada di vSwitch.
400 DependencyViolation.Ipv6Address The specified resource of %s depends on %s, so the operation cannot be completed. Sumber daya tertentu bergantung pada sumber daya lain. Operasi saat ini tidak diizinkan.
400 DependencyViolation.%s The specified resource of [%s] depends on [%s], so the operation cannot be completed. Sumber daya [%s] yang sedang dioperasikan bergantung pada [%s]. Hapus Sumber daya dependen sebelum melakukan operasi ini.
400 Forbidden.RegionNotFound Specified instance is not found during access authentication. Wilayah saat ini tidak didukung.
400 IncorrectStatus Vswtich status not stable.
400 DependencyViolation.RouterInterface Specified object has dependent resources RouterInterface.
400 InvalidRegionId.NotFound The specified region is not found. Parameter tidak valid.
400 DependencyViolation.NATGW Nat gateway exists in the VSwitch, so the VSwitch cannot be deleted. vSwitch tidak dapat dihapus karena masih berisi gerbang NAT yang belum dihapus. Hapus gerbang NAT yang terkait dengan vSwitch terlebih dahulu.
404 IncorrectVSwitchId Specified vSwtich instance is not found during access authentication. Instans virtual switch (vSwitch) yang ditentukan tidak ditemukan selama verifikasi izin.
404 InvalidVSwitchId.NotFound VSwitch not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.