文档

修改集群

更新时间:

ModifyCluster

描述

修改集群信息。

请求语法

请求行:

PUT /clusters/{Id} HTTP/1.1

请求方法为 PUT,请求资源为 clusters,请求参数为:

属性名称

类型

是否必须

描述

Id

String

集群标识符。

请求数据:

请求数据以 JSON 格式描述:

{
    "ImageId": "img-centos",
    "UserData": {
        "k1": "v1"
    },
    "Groups": {
        "group1": {
            "DesiredVMCount": 1,
            "InstanceType": "ecs.sn2ne.large",
            "SpotStrategy": "SpotAsPriceGo",
            "SpotPriceLimit": 0.0
        }
    }
}

属性说明

属性名称

类型

是否必须

描述

ImageId

string

镜像标识符。您可以使用官方定义的或自定义的镜像。可以通过 获取镜像列表获取您可使用的所有镜像标识符。

UserData

map<string, string>

用户自定义的信息,您可以定义字典的 key 和 value 值。用户程序使用 ECS 的 user server 获取。

Groups

map<string, object(GroupDesc)>

集群的实例组群信息。key 是您自定义的 group name, value 是 GroupDesc 类型。 但只能修改 GroupDesc 的以下属性: “DesiredVMCount”、 “InstanceType”、”SpotStrategy”、”SpotPriceLimit”。

返回信息

成功

响应行:

HTTP/1.1 200 OK

无响应数据。

错误

错误响应格式请参阅 返回结果

修改集群特有的错误码:

状态码

错误码

错误信息

语义

404

InvalidResource.NotFound

Specified resource is not found.

用户请求的资源不存在。

400

MissingGroups

Groups is mandatory for this action.

缺少Groups参数。

400

InvalidGroups

Specified parameter Groups is not valid. Its type must be object.

Groups必须是一个object。

400

InvalidGroups.{key}

Specified parameter Groups.{key} is not valid. Its type must be object.

Groups.{key}必须是一个object。

400

InvalidGroups.{key}

Specified parameter Groups.{key} is not valid. Its size must be in [1, 64].

Groups.{key}的大小必须在1与64之间。

400

MissingDesiredVMCount

DesiredVMCount is mandatory for this action.

缺少DesiredVMCount参数。

400

InvalidDesiredVMCount

Specified parameter DesiredVMCount is not valid. Its type must be integer.

DesiredVMCount必须是一个integer。

400

InvalidDesiredVMCount

Specified parameter DesiredVMCount is not valid. It must be in [1, 65536].

DesiredVMCount的大小必须在1与65536之间。

403

QuotaExhausted.MaxClusterGroupDesiredVMCount

The MaxClusterGroupDesiredVMCount ({value}) quota is exhausted.

一个Cluster中的一个Group的DesiredVMCount不能超过{value}。

400

Invalid{Parameter}

Specified parameter {Parameter} is not valid.

{Parameter}参数不合法。

  • 本页导读 (0)
文档反馈