调用ModifyCluster修改集群_批量计算(BC)-阿里云帮助中心

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}参数不合法。