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

指定された vSwitch の属性を変更します。

操作説明

ModifyVSwitchAttribute は非同期操作です。この操作を呼び出すと、システムはリクエスト ID を返しますが、vSwitch の属性はまだ変更済みではありません。変更タスクは引き続きバックグラウンドで実行中です。 DescribeVSwitchAttributes を呼び出して、vSwitch の変更ステータスを照会できます。
- vSwitch が Pending 状態の場合、属性が変更中です。
- vSwitch が Available 状態の場合、vSwitch は使用可能です。
ModifyVSwitchAttribute は、同じ vSwitch に対する同時変更をサポートしていません。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vpc:ModifyVSwitchAttribute

update

*VSwitch。

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
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://` で始まることはできません。	これは私の vSwitch です
Ipv6CidrBlock	integer	任意	vSwitch の IPv6 CIDR ブロックの最後の 8 ビット。有効な値: 0～255。このパラメーターは、vSwitch が属する VPC で IPv6 が有効になっている場合にのみ設定できます。このパラメーターを使用すると、vSwitch に IPv6 CIDR ブロックを割り当てられます。IPv6 CIDR ブロックが割り当てられた後、別の CIDR ブロックに変更できません。CIDR ブロックが同じ VPC 内の他の vSwitch のものと重複しないことを確認してください。	10
Ipv6CidrMask	integer	任意	vSwitch の IPv6 CIDR ブロックマスク。このパラメーターは、vSwitch が属する VPC で IPv6 が有効になっている場合にのみ設定できます。説明 64 のみがサポートされています。	64
EnableIPv6	boolean	任意	vSwitch の IPv6 を有効にするかどうかを指定します。有効な値: true: IPv6 を有効にします。vSwitch が属する VPC で IPv6 が有効になっている必要があります。また、Ipv6CidrBlock を指定して、vSwitch に IPv6 CIDR ブロックを割り当てる必要があります。 false (デフォルト): IPv6 を無効にします。vSwitch の IPv6 を無効にする前に、使用中の IPv6 アドレスがないことを確認してください。同時に Ipv6CidrBlock を指定できません。	false
VpcIpv6CidrBlock	string	任意	vSwitch が属する VPC の IPv6 CIDR ブロック。 VPC に複数の IPv6 CIDR ブロックがある場合、このパラメーターを指定して、vSwitch の IPv6 CIDR ブロックの有効値を指定できます。このパラメーターを指定しない場合、VPC で IPv6 が有効になったときに割り当てられた IPv6 CIDR ブロックが使用されます。	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 名のフォーマットが無効です。vSwitch 名のフォーマットを確認してください。
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.	vSwitch の説明が無効です。
400	Forbidden.VRouterNotFound	specified virtual switch is not found during access authentication.	アクセス認証中に指定された vSwitch が見つかりませんでした。
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	CloudBox は IPv6 の作成をサポートしていません。
400	OperationFailed.Ipv6InstanceExist	Operation failed because vswitch has ipv6 instance.	vSwitch に 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 の変更と IPv6 機能の無効化を同時に行うことはできません。
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 CIDR ブロックに依存しています。この操作を実行する前に、依存するリソースを削除してください。
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 CIDR ブロックがすでに使用中であるため、操作に失敗しました。
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.	IPv6 CIDR ブロックが無効です。
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 CIDR ブロックが既に使用中のため、操作は失敗しました。
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.	vSwitch にセカンダリゾーンが設定されている場合、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.

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

変更履歴

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