この操作を実行すると、ECS インスタンスの VPC 属性を変更できます。

説明

本インターフェイスを呼び出すときは、次の点に留意してください。

  • 停止(停止) のECSインスタンスのみ、VPC 属性を変更することができます。
  • この操作を実行する前に、新しい ECS インスタンスは起動済みおよび停止済みである必要があります。
  • この操作を行う前に、VPC 属性が変更されたECSインスタンスは起動済みおよび停止済みである必要があります。
  • この操作を実行する際にVSwitchIdが指定されている場合は、VSwitchIdは現在の VPC に属している必要があります。
  • この操作を実行する際、VSwitchIdが指定されていて、且つPrivateIpAddressが指定されていない場合、システムが自動でプライベート IP アドレスを ECS インスタンスに割り当てます。
  • 現在の VSwitch と新しい VSwitch ( VSwitchId)は、同じリージョン内のゾーンに属している必要があります。
  • 現在の VSwitchと 新しいVSwitch (VSwitchId ) は同じ VPC に属している必要があります。
  • VSwitchIdPrivateIpAddressの両方が指定されている場合、プライベート IP アドレスは、指定の VSwitch のCIDRブロックに属している必要があります。PrivateIpAddressVSwitchIdに依存する為、PrivateIpAddressのみを指定することはできません。

デバッグ

API Explorer でデバッグを実行できます。 API Explorer で各種操作を行い API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成等を行うことができます。

リクエストパラメーター

名称 タイプ 必須 説明
InstanceId String Yes i-bp1iudwa5b1tqaxxxxxx

インスタンスの ID。

VSwitchId String Yes [vswitchid]

新しい VSwitch の ID 。 現在のスイッチと新しいスイッチ ( VSwitchId )は、同じリージョン内のゾーンに属している必要があります。

Action String No ModifyInstanceVpcAttribute

実行する操作です。 値をModifyInstanceVpcAttribute に設定します。

OwnerAccount String No ECSforCloud@Alibaba.com

RAM ユーザーのログインネーム。

PrivateIpAddress String No 172.17。 XX.XXX

インスタンスの新しいプライベート IP アドレス。 PrivateIpAddress は、 VSwitchId に依存します。したがって、 PrivateIpAddress のみを指定することはできません。

レスポンスのパラメーター

名称 タイプ 説明
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエスト ID。

リクエストの例


https://ecs.aliyuncs.com/?Action=ModifyInstanceVpcAttribute
&InstanceId = i-bp1iudwa5b1tqaxxxxxx
&VSwitchId = [vswitchid] 
&<Common request parameters>

通常のレスポンスの例

XML 形式

<ModifyInstanceAttributeResponse>
  <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId> 
</ModifyInstanceAttributeResponse>

JSON 形式

{
	"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 InvalidPrivateIpAddress.Malformed 指定されたプライベート IP アドレスは不正 IP アドレスです。 指定された説明が無効な場合に表示されるエラーメッセージ。
400 IncorrectVSwitchStatus 仮想スイッチの現在のステータスは、この操作をサポートしていません。 指定された VSwitch が保留状態にあり、削除できない場合に表示されるエラーメッセージ。
404 InvalidVSwitchId.NotFound 指定された仮想スイッチは存在しません。 指定されたトレイルがが存在しない場合に表示されるエラーメッセージです。
400 IncorrectInstanceStatus インスタンスの現在のステータスでは、この操作を実行できません。 現在の状態のインスタンスでは該当の操作が実行できない場合に表示されるエラーメッセージ。
400 OperationDenied VPC にインスタンスがないため、指定された操作が却下されました。 インスタンスがVPC内にないため、指定された操作が拒否された場合に表示されるエラーメッセージ。
400 InvalidPrivateIpAddress.Mismatch 指定されたプライベート IP アドレスは仮想スイッチの CIDR ブロック内に存在しません。 指定されたプライベート IP アドレスが、指定の VSwitch の CIDR ブロック内に存在しない場合に表示されるエラーメッセージ。
404 NoSuchResource 指定されたリソースが見つかりません。 指定されたトレイルがが存在しない場合に表示されるエラーメッセージ。

エラーコードの表示