All Products
Search
Document Center

Virtual Private Cloud:DeleteVSwitch

Last Updated:Jun 19, 2026

Menghapus vSwitch.

Deskripsi operasi

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

  • Sebelum menghapus vSwitch, Anda harus merilis atau memigrasikan semua sumber daya di VPC, termasuk vSwitch, instans layanan cloud, antarmuka router, dan sumber daya 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 akan mengembalikan ID permintaan, tetapi vSwitch belum dihapus. Tugas penghapusan 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 dapat 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 ingin Anda hapus.

vsw-asdfjlna****

RegionId

string

No

ID wilayah vSwitch yang ingin Anda hapus.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

cn-hangzhou

DryRun

boolean

No

Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual. Nilai valid:

  • true: Hanya menjalankan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk nilai parameter yang hilang, sintaks permintaan yang salah, dan batas layanan. Jika permintaan gagal dalam dry run, kode kesalahan akan dikembalikan. Jika permintaan berhasil dalam dry run, kode kesalahan DryRunOperation akan dikembalikan.

  • false (default): Menjalankan dry run dan menjalankan permintaan aktual. Jika permintaan berhasil dalam dry run, kode status HTTP 2xx akan dikembalikan dan vSwitch dihapus.

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 diproses.
400 IncorrectVSwitchStatus vpc subnet is in middle status.
400 DependencyViolation Resources deployed in the vSwitch have not been deleted. vSwitch tidak dapat dihapus karena masih ada sumber daya yang di-deploy di dalamnya.
400 IncorrectRouteEntryStatus Some route entry status blocked this operation.
400 DependencyViolation.HaVip VSwitch cannot be deleted when there are some HaVip dependent with it. vSwitch tidak dapat dihapus karena HAVIP terkait dengannya.
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. Silakan coba lagi nanti.
400 DependencyViolation.SNAT The vswitch cannot be deleted when used by snat. vSwitch tidak dapat dihapus karena sedang digunakan oleh SNAT.
400 DeleteVSwitch.IncorrectStatus.cbnStatus Current CBN status does not support this operation. Status CBN saat ini tidak mendukung operasi hapus 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 network ACL.
400 DependencyViolation.EnhancedNatgw VSwitch cannot be deleted when natgw exist. vSwitch tidak dapat dihapus karena terdapat NAT gateway.
400 DependencyViolation.ResourceShare VSwitch cannot be deleted when resource share exist.
400 OperationFailed.SystemBusy Operation failed because system is busy. Sistem sedang sibuk. Silakan coba lagi nanti.
400 DependencyViolation.MulticastDomain VSwitch cannot be deleted when associated with multicast domain. vSwitch tidak dapat dihapus karena terkait dengan multicast domain.
400 DependencyViolation.VSwitchCidrReservation VSwitch cannot be deleted when vswitch cidr reservation exist. vSwitch tidak dapat dihapus karena VSwitchCidrReservation sedang digunakan.
400 DependencyViolation.CloudService VSwitch cannot be deleted when uesd by cloud service. vSwitch tidak dapat dihapus karena sedang digunakan oleh layanan cloud. Konfirmasikan skenario penggunaan layanan cloud.
400 InvalidVSwitchId.NotFound VSwitch not exist.
400 OperationFailed.Ipv6InstanceExist Operation failed because vswitch has ipv6 instance. Terdapat instance IPv6 di vSwitch.
400 DependencyViolation.Ipv6Address The specified resource of %s depends on %s, so the operation cannot be completed. Sumber daya yang ditentukan bergantung pada sumber daya lain, sehingga 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 Anda operasikan bergantung pada [%s]. Hapus sumber daya yang bergantung terlebih dahulu, lalu coba lagi.
400 Forbidden.RegionNotFound Specified instance is not found during access authentication. Region 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. Region yang ditentukan tidak ada.
404 IncorrectVSwitchId Specified vSwtich instance is not found during access authentication. Instance vSwitch yang ditentukan tidak ditemukan selama autentikasi akses.
404 InvalidVSwitchId.NotFound VSwitch not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.