调用ModifyVSwitchAttribute接口修改指定交换机的名称和描述信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyVSwitchAttribute

系统规定参数。取值：ModifyVSwitchAttribute。

VSwitchId String 是 vsw-25nacdfvue4****

交换机的ID。

VSwitchName String 否 VSwitch-1

交换机要修改的名称。

名称长度为2~128个字符，必须以字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-）。但不能以http://或https://开头。

RegionId String 否 cn-hangzhou

交换机所属的地域ID。您可以通过调用DescribeRegions接口获取地域ID。

Description String 否 This is my vswitch.

交换机要修改的描述信息。

描述长度为2~256个字符，必须以字母或中文开头，但不能以http://或https://开头。

Ipv6CidrBlock Integer 否 10

交换机IPv6网段的最后8比特位，取值：0~255。

该参数仅当交换机所属的VPC开通IPv6功能支持配置。
EnableIPv6 Boolean 否 false

交换机是否开通IPv6功能。取值：

  • true：开通IPv6功能。
  • false（默认值）：未开通IPv6功能。
VpcIpv6CidrBlock String 否 2408:XXXX:312:3e00::/56

交换机所在VPC的IPv6网段。

该参数仅当VPC开通IPv6功能时支持配置。

返回数据

名称 类型 示例值 描述
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyVSwitchAttribute
&VSwitchId=vsw-25nacdfvue4****
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyVSwitchAttributeResponse>
<RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</ModifyVSwitchAttributeResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidVSwitchName.Malformed Specified virtual switch name is not valid. 该vSwitch名字格式不正确，请您确认vSwitch名字格式。
400 InvalidVSwitchDiscription.Malformed Specified virtual switch description is not valid. 该vSwitch描述信息格式不正确。
400 InvalidVSwitchDiscription.Malformed Specified virtual switch description is not valid. 交换机描述不合法。
400 UnsupportedFeature.CloudBoxIpv6 The IPv6 feature is not supported by cloud box. 云盒不支持创建IPv6。
400 IncorrectStatus.VpcRouteEntry The status of the specified routeEntry is invalid. VPC路由条目状态不正确。
400 OperationFailed.IPv6Disabled Operation failed because IPv6 is not enabled for the vSwitch. 指定操作失败，因为IPv6功能未打开。
404 InvalidVSwitchId.NotFound The specified virtual switch does not exists. 该交换机不存在，请您检查输入的交换机是否正确。

访问错误中心查看更多错误码。