Modifies the attributes of a vSwitch.
Operation description
API rate limit: 100 calls per second.
Rate limit per user: 5 calls per second.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ens:ModifyVSwitchAttribute |
update |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| VSwitchId |
string |
Yes |
The vSwitch ID. |
n-**** |
| VSwitchName |
string |
No |
The vSwitch name.
|
Test-switch |
| Description |
string |
No |
The description.
|
this is my first vswitch |
| EnableIPv6 |
boolean |
No |
Specifies whether to enable IPv6 for the vSwitch. Valid values:
|
false |
| Ipv6CidrBlock |
string |
No |
The IPv6 CIDR block of the vSwitch. Note
You can specify this parameter to assign an IPv6 CIDR block to the vSwitch only when IPv6 is enabled for the VPC to which the vSwitch belongs. After the IPv6 CIDR block is assigned, it cannot be changed. Make sure that the IPv6 CIDR block does not overlap with the CIDR blocks of other vSwitches in the same VPC. |
2408:XXXX:0:a600::/110 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
The request ID. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
Examples
Success response
JSON format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | NoPermission | Permission denied. | |
| 400 | Invalid%s | The specified parameter %s is invalid. | |
| 400 | Missing%s | You must specify the parameter %s. | |
| 400 | IncorrectVSwitchStatus | The current status of virtual switch does not support this operation. | The specified virtual switch is not available and cannot operate. |
| 400 | InvalidVSwitchId.NotFound | Specified virtual switch does not exist. | The specified virtual switch ID does not exist. |
| 400 | CallInterface | Call Interface Happen Error. | An error occurred when you call the operation. |
| 400 | Network.SecondaryCidrNotFound | The network secondary CIDR is not found. | The network secondary CIDR block does not exist. |
| 400 | VSwitch.Ipv6AlreadyEnabled | IPv6 is already enabled on the vSwitch. | The IPv6 feature of the switch is enabled. |
| 400 | VSwitch.Ipv6CidrBlockOverlapped | The specified IPv6 CIDR block overlaps with existing vSwitches. | The specified IPv6 CIDR block overlaps with the existing VSwitch. |
| 400 | VSwitch.CidrHasUsedIps | Unreleased IP addresses exist in the CIDR block. | The CIDR block contains unreleased IP addresses. |
| 400 | VSwitch.InvalidIpv6CidrBlock | Invalid IPv6 CIDR value. | The specified IPv6 CIDR segment value is invalid. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.