All Products
Search
Document Center

Virtual Private Cloud:DescribeVSwitchAttributes

Last Updated:Jun 12, 2026

Mengkueri informasi konfigurasi vSwitch tertentu dengan memanggil operasi DescribeVSwitchAttributes.

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 yang akan dikueri.

vsw-25naue4g****

RegionId

string

No

ID wilayah VPC tempat tabel rute berada.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

cn-hangzhou

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: menjalankan dry run tanpa mengkueri konfigurasi vSwitch. Sistem memeriksa parameter wajib, format permintaan, dan batas layanan. Jika permintaan gagal dalam dry run, error yang sesuai akan dikembalikan. Jika permintaan berhasil dalam dry run, kode kesalahan DryRunOperation akan dikembalikan.

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

false

Elemen respons

Element

Type

Description

Example

object

Detail vSwitch.

VpcId

string

ID VPC tempat vSwitch berada.

vpc-257gq642n****

Status

string

Status vSwitch. Nilai valid:

  • Pending: sedang dikonfigurasi.

  • Available: aktif.

Pending

CreationTime

string

Waktu pembuatan vSwitch.

2021-08-22T10:40:25Z

IsDefault

boolean

Apakah vSwitch merupakan vSwitch default. Nilai valid:

  • true: vSwitch merupakan vSwitch default.

  • false: vSwitch bukan vSwitch default.

false

AvailableIpAddressCount

integer

Jumlah alamat IP yang tersedia.

12

NetworkAclId

string

Aturan ACL jaringan.

1

OwnerId

integer

ID akun Alibaba Cloud pemilik sumber daya.

Penting Nilai ini bertipe Long. Loss Presisi dapat terjadi pada bahasa pemrograman tertentu. Gunakan nilai ini dengan hati-hati.
.

28768383240243****

VSwitchId

string

ID vSwitch.

vsw-25b7pv15t****

RequestId

string

ID permintaan.

7B48B4B9-1EAD-469F-B488-594DAB4B6A1A

CidrBlock

string

Rentang Titik akhir pribadi vSwitch.

192.168.0.1/24

Description

string

Deskripsi vSwitch.

abc

ResourceGroupId

string

ID kelompok sumber daya.

rg-acfmxazb4ph****

ZoneId

string

Zona tempat vSwitch berada.

cn-beijing-a

Ipv6CidrBlock

string

Blok CIDR IPv6 vSwitch.

2408:XXXX:3c5:44e::/64

VSwitchName

string

Nama vSwitch.

test

ShareType

string

Tipe berbagi vSwitch.

  • Jika nilai kosong, vSwitch merupakan vSwitch pribadi.

  • Jika nilai Shared, vSwitch merupakan vSwitch bersama.

  • Jika nilai Sharing, vSwitch sedang dibagikan ke akun lain.

Shared

EnabledIpv6

boolean

Apakah Blok CIDR IPv6 diaktifkan untuk vSwitch. Nilai valid:

  • true: Diaktifkan.

  • false: Tidak diaktifkan.

true

RouteTable

object

Informasi tabel rute vSwitch.

RouteTableId

string

ID tabel rute yang terkait dengan vSwitch.

vtb-bp145q7glnuzdv****

RouteTableType

string

Tipe tabel rute. Nilai valid:

  • System: tabel rute sistem.

  • Custom: tabel rute kustom.

System

Tags

object

Tag

array<object>

Daftar tag.

object

Daftar tag.

Key

string

The key of tag N added to the resource.

FinanceDept

Value

string

The value of tag N added to the resource.

FinanceJoshua

Contoh

Respons sukses

JSONformat

{
  "VpcId": "vpc-257gq642n****",
  "Status": "Pending",
  "CreationTime": "2021-08-22T10:40:25Z",
  "IsDefault": false,
  "AvailableIpAddressCount": 12,
  "NetworkAclId": "1",
  "OwnerId": 0,
  "VSwitchId": "vsw-25b7pv15t****",
  "RequestId": "7B48B4B9-1EAD-469F-B488-594DAB4B6A1A",
  "CidrBlock": "192.168.0.1/24",
  "Description": "abc",
  "ResourceGroupId": "rg-acfmxazb4ph****",
  "ZoneId": "cn-beijing-a",
  "Ipv6CidrBlock": "2408:XXXX:3c5:44e::/64",
  "VSwitchName": "test",
  "ShareType": "Shared",
  "EnabledIpv6": true,
  "RouteTable": {
    "RouteTableId": "vtb-bp145q7glnuzdv****",
    "RouteTableType": "System"
  },
  "Tags": {
    "Tag": [
      {
        "Key": "FinanceDept",
        "Value": "FinanceJoshua"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidVSwitchId.NotFound Specified VSwitch can not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.