All Products
Search
Document Center

Cloud Firewall:DescribeAccessInstanceVSwitchList

Last Updated:Nov 12, 2025

Queries the vSwitches for synchronization nodes.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionNo

string

Yes

The region ID.

cn-hangzhou

VpcId

string

No

The ID of the VPC.

vpc-uf6b5lyul0x******

ZoneId

string

No

The zone ID.

cn-hangzhou-i

VSwitchId

string

No

The ID of the vSwitch.

vsw-qzeaol304m***

MemberUid

integer

No

The UID of the Alibaba Cloud account to which the resource belongs.

135809047715****

PageNo

integer

No

The page number.

1

PageSize

integer

No

The number of entries per page.

10

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The request ID.

450D47F5-956E-543E-8502-2F71C8C54E72

TotalCount

integer

The total number of entries.

1

PageNo

integer

The page number.

1

PageSize

integer

The number of entries per page.

10

Zones

array<object>

The list of zones.

array<object>

A zone.

ZoneId

string

The zone ID.

cn-hangzhou-i

VSwitchList

array<object>

The list of vSwitches.

object

A vSwitch.

VpcId

string

The ID of the VPC to which the vSwitch belongs.

vpc-uf6b5lyul0x******

VSwitchId

string

The ID of the vSwitch.

vsw-qzeaol304m***

VSwitchName

string

The name of the vSwitch.

ManagedVSW

CidrBlock

string

The IPv4 CIDR block of the vSwitch.

192.168.0.0/16

AvailableIpAddressCount

integer

The number of available IP addresses in the vSwitch.

254

FirewallVSwitch

boolean

Indicates whether the vSwitch is in a VPC that is managed by Cloud Firewall.

false

Examples

Success response

JSON format

{
  "RequestId": "450D47F5-956E-543E-8502-2F71C8C54E72",
  "TotalCount": 1,
  "PageNo": 1,
  "PageSize": 10,
  "Zones": [
    {
      "ZoneId": "cn-hangzhou-i",
      "VSwitchList": [
        {
          "VpcId": "vpc-uf6b5lyul0x******",
          "VSwitchId": "vsw-qzeaol304m***",
          "VSwitchName": "ManagedVSW",
          "CidrBlock": "192.168.0.0/16",
          "AvailableIpAddressCount": 254,
          "FirewallVSwitch": false
        }
      ]
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.