ModifyVSwitchAttribute - Virtual Private Cloud

呼叫 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 個字元，不能以 `http://` 或 `https://` 開頭。	VSwitch-1
RegionId	string	否	交換器所屬的地域 ID。您可以透過呼叫 DescribeRegions 介面取得地域 ID。	cn-hangzhou
Description	string	否	交換器要修改的描述資訊。描述長度為 1～256 個字元，不能以 `http://` 或 `https://` 開頭。	This is my vswitch.
Ipv6CidrBlock	integer	否	交換器 IPv6 網段的最後 8 個位元，取值：0~255。僅當交換器所屬 VPC 已開啟 IPv6 時，您可以傳入此參數為交換器配置 IPv6 網段。IPv6 網段配置後，無法修改為其他網段。需確保與所屬 VPC 下其他交換器的網段不重疊。	10
Ipv6CidrMask	integer	否	交換器的 IPv6 網段遮罩。僅當交換器所屬 VPC 已開啟 IPv6 時，您可以傳入此參數為交換器配置 IPv6 網段。說明僅支援 64。	64
EnableIPv6	boolean	否	交換器是否開啟 IPv6。取值： true：開啟 IPv6。需所屬 VPC 已開啟 IPv6，並同時傳入 Ipv6CidrBlock 為交換器配置 IPv6 網段。 false（預設值）：關閉。為交換器關閉 IPv6 時，需確保 IPv6 位址未被使用，且不可同時傳入 Ipv6CidrBlock。	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.	交換器描述不合法。
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.	IPv6 網段無效。
400	InvalidDescription.Malformed	The specified Description is wrongly formed.	指定的資源描述格式不合法。長度為 2～256 個字元，不能以 http:// 和 https:// 開頭。
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.	EIP 操作太頻繁。
400	OperationDenied.HasSecondaryZone	The operation is not allowed because the VSwitch has a secondary zone.	交換器存在備用可用區時不允許操作 IPv6。
400	OperationDenied.VpcIpv6CidrBlockNotExist	The specified VpcIpv6CidrBlock does not exist in the VPC.	指定的 VpcIpv6CidrBlock 不存在於 VPC 中。
400	OperationDenied.AvailableCidrInsufficient	Insufficient available CIDR blocks for allocation. This is either because the VPC has no remaining address space, or because the candidate CIDR contains destination networks of active non-system routes in the VPC.	操作被拒絕，原因是可用的 CIDR 資源不足。
400	OperationDenied.Ipv6CidrMaskInvalid	The specified Ipv6CidrMask is invalid, only %s is allowed.	指定的 IPv6 遮罩無效，僅支援 %s。
400	MissingParam.Ipv6CidrBlockOrIpv6CidrMask	Ipv6CidrBlock or Ipv6CidrMask must be specified.	必須至少指定 Ipv6CidrBlock 或 Ipv6CidrMask 其中一項。
500	SystemBusy	The system is busy. Please try again later.	目前系統繁忙，請稍後重試。
404	InvalidVSwitchId.NotFound	The specified virtual switch does not exists.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。