調用ModifyVSwitchAttribute接口修改指定交換機的名稱和描述信息。
接口說明
- ModifyVSwitchAttribute 接口屬于異步接口，即系統會返回一個請求 ID，但該交換機的名稱和描述信息尚未修改成功，系統后臺的修改任務仍在進行。您可以調用 DescribeVSwitchAttributes 查詢交換機的修改狀態：
- 當交換機的狀態處于 Pending 狀態時，表示交換機的名稱和描述信息正在修改中。
- 當交換機狀態處于 Available 狀態時，表示交換機可用。
- ModifyVSwitchAttribute 接口不支持并發修改同一個交換機的名稱和描述信息。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vpc:ModifyVSwitchAttribute | update | *VSwitch acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| VSwitchId | string | 是 | 交換機的 ID。 | vsw-25nacdfvue4**** |
| VSwitchName | string | 否 | 交換機要修改的名稱。 名稱長度為 1～128 個字符，不能以 | VSwitch-1 |
| RegionId | string | 否 | 交換機所屬的地域 ID。您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
| Description | string | 否 | 交換機要修改的描述信息。 描述長度為 1～256 個字符，不能以 | This is my vswitch. |
| Ipv6CidrBlock | integer | 否 | 交換機 IPv6 網段的最后 8 比特位，取值：0~255。 該參數僅當交換機所屬的 VPC 開通 IPv6 功能支持配置。 | 10 |
| EnableIPv6 | boolean | 否 | 交換機是否開通 IPv6 功能。取值：
| false |
| VpcIpv6CidrBlock | string | 否 | 交換機所在 VPC 的 IPv6 網段。 該參數僅當 VPC 開通 IPv6 功能時支持配置。 | 2408:XXXX:312:3e00::/56 |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 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 | Forbidden.VRouterNotFound | specified virtual switch is not found during access authentication. | 在訪問鑒權時未找到指定的虛擬交換機 |
| 400 | UnsupportedFeature.CloudBoxIpv6 | The IPv6 feature is not supported by cloud box. | 云盒不支持創建IPv6。 |
| 400 | OperationFailed.Ipv6InstanceExist | Operation failed because vswitch has ipv6 instance. | 交換機中存在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功能未打開。 |
| 400 | ParamExclusive.DisableIpv6AndIpv6CidrBlock | DisableIpv6 and Ipv6Cidr are mutually exclusive. | 操作沖突，不允許同時修改Ipv6Cidr和DisableIpv6功能。 |
| 400 | IncorrectStatus.cbnStatus | Current CBN status does not support this operation. | CBN當前狀態不正確 |
| 400 | DependencyViolation.IPv6CidrReservation | The specified resource of [%s] depends on [%s], so the operation cannot be completed. | 操作的資源[%s]依賴了IPv6預留網段，請先刪除依賴資源后再操作。 |
| 400 | IllegalParam.VpcIpv6CidrBlock | The parameter of VpcIPv6CidrBlock is illegal. | 參數VpcIPv6CidrBlock非法。 |
| 400 | OperationFailed.Ipv6AlreadyEnabled | Operation failed because the IPv6 is enabled already. | 操作失敗，已開啟IPv6。 |
| 400 | OperationFailed.Ipv6CidrBlockExisted | Operation failed because the specified IPv6 CIDR block is used already. | 操作失敗，該IPv6地址段已被使用。 |
| 400 | IllegalParam.Ipv6CidrBlock | The parameter of Ipv6CidrBlock is illegal. | 參數Ipv6CidrBlock非法。 |
| 400 | InvalidDescription.Malformed | The specified Description is wrongly formed. | 入參Description無效 |
| 400 | OperationFailed.VpcIpv6Disabled | Operation failed because the VPC has not enabled IPv6. | 當前操作不支持因為VPC尚未開啟IPv6。 |
| 400 | IncorrectStatus.VSwitch | The specified vSwitch status is invalid. | 虛擬交換機狀態異常。 |
| 404 | InvalidVSwitchId.NotFound | The specified virtual switch does not exists. | 該交換機不存在，請您檢查輸入的交換機是否正確。 |
| 500 | SystemBusy | The system is busy. Please try again later. | 當前系統繁忙，請稍后重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-11-07 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2024-10-08 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-08-24 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-06-30 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |