ModifyVSwitchAttribute - 修改指定交換器的配置資訊
調用ModifyVSwitchAttribute介面修改指定交換器的配置資訊。
介面說明
- ModifyVSwitchAttribute 介面屬於非同步介面，即系統會返回一個請求 ID，但該交換器的配置資訊尚未修改成功，系統背景修改任務仍在進行。您可以調用 DescribeVSwitchAttributes 查詢交換器的修改狀態：
當交換器的狀態處於 Pending 狀態時，表示交換器的配置資訊正在修改中。
當交換器狀態處於 Available 狀態時，表示交換器可用。
ModifyVSwitchAttribute 介面不支援並發修改同一個交換器的配置資訊。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| 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 時，您可以傳入此參數為交換器分配 IPv6 網段。IPv6 網段分配後，無法修改為其他網段。需確保與所屬 VPC 下其他交換器的網段不重疊。 |
10 |
| EnableIPv6 |
boolean |
否 |
交換器是否開啟 IPv6。取值：
|
false |
| VpcIpv6CidrBlock |
string |
否 |
交換器所在 VPC 的 IPv6 網段。 當交換器所屬 VPC 具有多個 IPv6 網段時，您可以傳入此參數指定交換器所屬的 IPv6 網段範圍。如不指定，將選擇 VPC 開啟 IPv6 時分配的 IPv6 網段。 |
2408:XXXX:312:3e00::/56 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
0ED8D006-F706-4D23-88ED-E11ED28DCAC0 |
樣本
正常返回樣本
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 | 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. | 虛擬交換器狀態異常。 |
| 400 | OperationFailed.Ipv6CidrBlockUsed | Operation failed because the specified IPv6 CIDR block is used already. | 操作失敗，該IPv6位址區段已被使用。 |
| 400 | TaskConflict | The operation is too frequent. Please wait a moment and try again. | 當前操作太頻繁，請稍後重試。 |
| 500 | SystemBusy | The system is busy. Please try again later. | 當前系統繁忙，請稍後重試。 |
| 404 | InvalidVSwitchId.NotFound | The specified virtual switch does not exists. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。