Queries the detailed information about a specified vSwitch.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeVSwitchAttributes

The operation that you want to perform. Set the value to DescribeVSwitchAttributes.

VSwitchId String Yes vsw-25naue4g****

The ID of the vSwitch.

RegionId String No cn-hangzhou

The region ID of the virtual private cloud (VPC) to which the route table belongs.

You can call the DescribeRegions operation to query the most recent region list.

DryRun Boolean No false

Specifies whether to perform a dry run. Valid values:

  • true: performs a dry run. The system checks the required parameters, request syntax, and limits. If the request fails the dry run, an error message is returned. If the request passes the dry run, the DryRunOperation error code is returned.
  • false (default): sends a request and performs a dry run. If the request passes the dry run, a 2xx HTTP status code is returned and the operation is performed.

Response parameters

Parameter Type Example Description
VpcId String vpc-257gq642n****

The ID of the VPC to which the vSwitch belongs.

Status String Pending

The status of the vSwitch. Valid values:

  • Pending
  • Available
CreationTime String 2021-08-22T10:40:25Z

The time when the vSwitch was created.

IsDefault Boolean false

Indicates whether the vSwitch is the default vSwitch. Valid values:

  • true: yes
  • false: no
AvailableIpAddressCount Long 12

The number of available IP addresses.

NetworkAclId String 1

The network access control list (ACL) rules.

OwnerId Long 287683832402436789

The ID of the Alibaba Cloud account to which the vSwitch belongs.

VSwitchId String vsw-25b7pv15t****

The ID of the vSwitch.

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

The ID of the request.

CidrBlock String

The CIDR block of the vSwitch.

Description String abc

The description of the vSwitch.

ResourceGroupId String rg-acfmxazb4ph****

The ID of the resource group.

ZoneId String cn-beijing-a

The ID of the zone to which the vSwitch belongs.

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

The IPv6 CIDR block of the vSwitch.

VSwitchName String test

The name of the vSwitch.

RouteTable Object

The information about the route table that is associated with the vSwitch.

RouteTableId String vtb-bp145q7glnuzdv****

The ID of the route table that is associated with the vSwitch.

RouteTableType String System

The type of the route table. Valid values:

  • System: system route table
  • Custom: custom route table
Tags Array of Tag

The tag list.

Key String FinanceDept

The tag key.

Value String FinanceJoshua

The tag value.


Sample requests

&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

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

Error codes

For a list of error codes, visit the API Error Center.