ModifyVSwitchAttribute - Virtual Private Cloud - Alibaba Cloud ドキュメントセンター

vSwitch の名前、説明、および IPv6 設定を変更します。

操作説明

ModifyVSwitchAttribute インターフェースは非同期インターフェースです。つまり、システムはリクエスト ID を返しますが、その時点で vSwitch の設定情報はまだ変更されておらず、バックグラウンドで変更タスクが実行中です。DescribeVSwitchAttributes を呼び出して、vSwitch の変更ステータスを確認できます。
- vSwitch のステータスが Pending の場合、vSwitch の設定情報が変更中であることを示します。
- vSwitch のステータスが Available の場合、vSwitch が利用可能であることを示します。
ModifyVSwitchAttribute インターフェースでは、同一の vSwitch の設定情報を並行して変更することはサポートされていません。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
VSwitchId	string	必須	vSwitch の ID です。	vsw-25nacdfvue4****
VSwitchName	string	任意	vSwitch の新しい名前です。名前の長さは 1～128 文字で、`http://` または `https://` で始まってはいけません。	VSwitch-1
RegionId	string	任意	vSwitch がデプロイされているリージョンの ID です。DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。	cn-hangzhou
Description	string	任意	vSwitch の新しい説明です。説明の長さは 1～256 文字で、`http://` または `https://` で始まってはいけません。	This is my vswitch.
Ipv6CidrBlock	integer	任意	vSwitch の IPv6 CIDR ブロックの下位 8 ビットです。有効値： 0～255。このパラメーターは、vSwitch が属する VPC で IPv6 機能が有効になっている場合にのみ設定できます。	10
EnableIPv6	boolean	任意	vSwitch の IPv6 機能を有効にするかどうかを指定します。有効値： true： IPv6 機能を有効にします。 false： IPv6 機能を無効にします。デフォルト値です。	false
VpcIpv6CidrBlock	string	任意	vSwitch が属する VPC の IPv6 CIDR ブロックです。このパラメーターは、VPC で IPv6 機能が有効になっている場合にのみ設定できます。	2408:XXXX:312:3e00::/56

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエストの ID です。	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	指定された 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.
400	OperationFailed.Ipv6InstanceExist	Operation failed because vswitch has ipv6 instance.
400	IncorrectStatus.VpcRouteEntry	The status of the specified routeEntry is invalid.
400	OperationFailed.IPv6Disabled	Operation failed because IPv6 is not enabled for the vSwitch.
400	ParamExclusive.DisableIpv6AndIpv6CidrBlock	DisableIpv6 and Ipv6Cidr are mutually exclusive.
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.
400	DependencyViolation.IPv6CidrReservation	The specified resource of [%s] depends on [%s], so the operation cannot be completed.
400	IllegalParam.VpcIpv6CidrBlock	The parameter of VpcIPv6CidrBlock is illegal.
400	OperationFailed.Ipv6AlreadyEnabled	Operation failed because the IPv6 is enabled already.
400	OperationFailed.Ipv6CidrBlockExisted	Operation failed because the specified IPv6 CIDR block is used already.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.
400	InvalidDescription.Malformed	The specified Description is wrongly formed.
400	OperationFailed.VpcIpv6Disabled	Operation failed because the VPC has not enabled IPv6.
400	IncorrectStatus.VSwitch	The specified vSwitch status is invalid.
400	OperationFailed.Ipv6CidrBlockUsed	Operation failed because the specified IPv6 CIDR block is used already.
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。