閱讀590 返回首頁    go 阿裏雲


修改實例 VPC 屬性__實例相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

修改雲服務器實例的 VPC 屬性。

  • 指定 VSwitchId 修改 VPC 屬性時,指定的 VSwitchId,必須屬於當前的專有網絡。
  • 指定實例的當前交換機和新的交換機必須要屬於同一個可用區。
  • 指定 VSwitchId 不指定 PrivateIpAddress 時,係統自動為雲服務器實例分配一個空閑的私網 IP。
  • 同時指定 VSwitchId 和 PrivateIpAddress 時,私網 IP 要屬於指定交換機的網段。
  • PrivateIpAddress 依賴於 VSwitchId,不能單獨指定 PrivateIpAddress。
  • 進行修改操作的雲服務器實例必須是 Stopped 狀態,新創建的雲服務器實例必須要經過一次啟動 / 停止才能更改所屬的交換機。

請求參數

名稱 類型 是否必須 描述
Action String 係統規定參數,取值:ModifyInstanceVpcAttribute
InstanceId String 指定的實例 ID
VSwitchId String 新的交換機 ID,不能跨可用區修改實例的交換機
PrivateIpAddress String 新的私網 IP 地址,不能單獨指定

返回參數

全是公共返回參數,詳見公共返回參數

錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
InvalidVSwitchId.NotFound Specified virtual switch does not exist. 404 指定的交換機 ID 不存在
InvalidVSwitchId.Mismatch Specified instance and virtual switch are not in the same zone. 400 指定的實例和指定的交換機不屬於同一個可用區
InvalidInstanceId.NotFound Specified instance does not exist. 404 指定的 ECS 實例不存在
InvalidPrivateIpAddress.Mismatch Specified private IP address is not in the CIDR block of virtual switch. 400 指定的私網 IP 不在指定交換機的網段中
InvalidPrivateIpAddress.Malformed Specified private IP address is malformed. 400 指定的私有 IP 不合法
InvalidPrivateIpAddress.Duplicated Specified private IP address is duplicated. 400 指定的私網 IP 已經被使用
InvalidPrivateIp.Changing Previous action is not finished yet. 400 實例修改私網 IP 為完成,不能再進行在修改
InvalidVSwitchId.NotFound Specified virtual switch is not found in current VPC. 404 不能跨 VPC 修改實例的交換機。
IncorrectInstanceStatus The current status of instance does not support this operation. 400 不在已停止狀態的實例不能進行此操作。
OperationDenied Specified operation is denied as your instance is not in VPC. 400 實例不是 VPC 類型
InvalidPrivateIp.Changing Specified private IP address is not in the CIDR block of virtual switch. 400 實例正在修改私網 IP 過程中(實例一次 stop 隻能修改一次私網 IP)

示例

請求示例

  1. https://ecs.aliyuncs.com/?Action=ModifyInstanceVpcAttribute
  2. &InstanceId=35F20777-0DFF-C152-41FA-BCE0EA0B2FD7
  3. &VSwitchId=[vswitchid]
  4. &<公共請求參數>

返回示例

XML格式

  1. <ModifyInstanceAttributeResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </ModifyInstanceAttributeResponse>

JSON格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }

最後更新:2016-11-23 17:08:34

  上一篇:go 修改實例屬性__實例相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇:go 查詢實例狀態__實例相關接口_API 參考_雲服務器 ECS-阿裏雲