修改集群
ModifyCluster
描述
修改集群信息。
請求語法
請求行：
PUT /clusters/{Id} HTTP/1.1請求方法為 PUT，請求資源為 clusters，請求參數(shù)為：
屬性名稱 | 類型 | 是否必須 | 描述 |
Id | String | 是 | 集群標識符。 |
請求數(shù)據(jù)：
請求數(shù)據(jù)以 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”。 |
返回信息
成功
響應(yīng)行：
HTTP/1.1 200 OK無響應(yīng)數(shù)據(jù)。
錯誤
錯誤響應(yīng)格式請參閱 返回結(jié)果。
修改集群特有的錯誤碼：
狀態(tài)碼 | 錯誤碼 | 錯誤信息 | 語義 |
404 | InvalidResource.NotFound | Specified resource is not found. | 用戶請求的資源不存在。 |
400 | MissingGroups | Groups is mandatory for this action. | 缺少Groups參數(shù)。 |
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參數(shù)。 |
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}參數(shù)不合法。 |