修改实例所属项目

最近更新时间:2019-12-02 17:32:04

说明:

当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

1. 接口描述

本接口 (ModifyInstanceProject) 用于修改实例所属项目:项目为一个虚拟概念,用户可以在一个账户下面建立多个项目,每个项目中管理不同的资源。

接口请求域名:cvm.api.qcloud.com

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见公共请求参数页面。

参数名称 是否必选 类型 描述
instanceId String 待操作的实例ID。可通过 DescribeInstances API返回值中的 unInstanceId 获取。
projectId Int 项目ID。项目可以使用 AddProject 创建,后续使用 DescribeInstances 查询实例时,项目ID可用于过滤结果。

3. 输出参数

参数名称 类型 描述
code Int 公共错误码。0表示成功,其他值表示失败。
message String 模块错误信息描述,与接口相关。

4. 错误码

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见CVM错误码页面。

错误码 描述
OperationConstraints.InstanceInAs 处于自动伸缩中的实例禁止更新项目
InvalidParameter.UuidOrUuidList 缺少uuid或uuidList参数
InvalidParameter.ProjectIdNotFound ProjectID不存在
OperationConstraints.InstanceBindWithLoadBalance 绑定负载均衡的实例无法进行此操作

5. 示例

输入

  https://cvm.api.qcloud.com/v2/index.php?
  Action=ModifyInstanceProject
  &instanceId=qcvm882eae196692549cc581015c495d312421
  &projectId=0
  &<公共请求参数>

输出

{
    "code": 0,
    "message": "ok"
}