この操作を実行すると、ECS インスタンスの VPC 属性を変更できます。
説明
本インターフェイスを呼び出すときは、次の点に留意してください。
- 停止(
停止
) のECSインスタンスのみ、VPC 属性を変更することができます。 - この操作を実行する前に、新しい ECS インスタンスは起動済みおよび停止済みである必要があります。
- この操作を行う前に、VPC 属性が変更されたECSインスタンスは起動済みおよび停止済みである必要があります。
- この操作を実行する際に
VSwitchId
が指定されている場合は、VSwitchId
は現在の VPC に属している必要があります。 - この操作を実行する際、
VSwitchId
が指定されていて、且つPrivateIpAddress
が指定されていない場合、システムが自動でプライベート IP アドレスを ECS インスタンスに割り当てます。 - 現在の VSwitch と新しい VSwitch (
VSwitchId
)は、同じリージョン内のゾーンに属している必要があります。 - 現在の VSwitchと 新しいVSwitch (
VSwitchId
) は同じ VPC に属している必要があります。 VSwitchId
とPrivateIpAddress
の両方が指定されている場合、プライベート IP アドレスは、指定の VSwitch の CIDRブロックに属している必要があります。PrivateIpAddress
はVSwitchId
に依存する為、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 | 指定されたリソースが見つかりません。 | 指定されたトレイルがが存在しない場合に表示されるエラーメッセージ。 |