全部产品
云市场

修改集群

更新时间:2019-01-13 17:28:57

ModifyCluster

描述

修改集群信息。

请求语法

请求行:

  1. PUT /clusters/{Id} HTTP/1.1

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

属性名称 类型 是否必须 描述
Id String 集群标识符。

请求数据:

请求数据以 JSON 格式描述:

  1. {
  2. "ImageId": "img-centos",
  3. "EnvVars": {
  4. "k2": "v2"
  5. },
  6. "UserData": {
  7. "k1": "v1"
  8. },
  9. "Configs": {
  10. "Mounts": {
  11. "Entries": [
  12. {
  13. "Source": "nas://26a174a62f-sfi98.cn-shenzhen.nas.aliyuncs.com:/",
  14. "WriteSupport": true,
  15. "Destination": "/home/admin/modify-dir1/"
  16. },
  17. {
  18. "Source": "oss://my-test-bk/",
  19. "WriteSupport": false,
  20. "Destination": "/home/admin/modify-dir3/"
  21. }
  22. ]
  23. }
  24. },
  25. "Groups": {
  26. "group1": {
  27. "DesiredVMCount": 1,
  28. "InstanceType": "ecs.sn2ne.large",
  29. "SpotStrategy": "SpotAsPriceGo",
  30. "SpotPriceLimit": 0.0
  31. }
  32. }
  33. }

属性说明

属性名称 类型 是否必须 描述
ImageId string 镜像标识符。您可以使用官方定义的或自定义的镜像。可以通过 获取镜像列表 获取您可使用的所有镜像标识符。
UserData map<string, string> 用户自定义的信息,您可以定义字典的 key 和 value 值。用户程序使用 ECS 的 user server 获取。
EnvVars map<string, string> 虚拟机的环境变量,您可以定义字典的 key 和 value 值。用户程序从环境变量中获取。
Groups map<string, object(GroupDesc)> 集群的实例组群信息。key 是您自定义的 group name, value 是 GroupDesc 类型。 但只能修改 GroupDesc 的以下属性: “DesiredVMCount”、 “InstanceType”、”SpotStrategy”、”SpotPriceLimit”。
Configs object(Configs) 集群的一些配置信息。同创建集群的Configs参数,但只能修改Configs.Mount.Entries中的属性。

返回信息

成功

响应行:

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