全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
批量计算

创建集群

更新时间:2017-09-06 13:45:35

CreateCluster

描述

请求语法

  1. POST /clusters?IdempotentToken={IdempotentToken}
  2. {
  3. "Name": "test-ubuntu",
  4. "Description": "demo",
  5. "ImageId": "m-2309yqb5n",
  6. "InstanceType": "bcs.a2.large",
  7. "UserData": {
  8. "key1": "value1"
  9. },
  10. "Notification": {
  11. "Topic": {
  12. "Name": "test-topic",
  13. "Endpoint": "http://[UserId].mns.[Region].aliyuncs.com/",
  14. "Events": [
  15. "OnClusterDeleted",
  16. "OnInstanceCreated",
  17. "OnInstanceActive"
  18. ]
  19. }
  20. },
  21. "Configs": {
  22. "Disks": {
  23. "SystemDisk": {
  24. "Type": "cloud",
  25. "Size": 500
  26. },
  27. "DataDisk": {
  28. "Type": "cloud",
  29. "Size": 500,
  30. "MountPoint": "/path/to/mount"
  31. }
  32. },
  33. "Mounts": {
  34. "Entries": [
  35. {
  36. "Destination": "/home/admin/mount-dest",
  37. "Source": "oss://your-bucket/mount-source",
  38. "WriteSupport": true
  39. }
  40. ],
  41. "Locale": "GBK",
  42. "Lock": false,
  43. "CacheSupport": true,
  44. "NAS": {
  45. "AccessGroup": [
  46. "group1",
  47. "group2"
  48. ],
  49. "FileSystem": [
  50. "filesystem1",
  51. "filesystem2"
  52. ]
  53. },
  54. "OSS": {
  55. "AccessKeyId": "",
  56. "AccessKeySecret": "",
  57. "AccessSecurityToken": ""
  58. }
  59. },
  60. "Networks": {
  61. "Classic": {
  62. "AllowIpAddress": [],
  63. "AllowIpAddressEgress": [],
  64. "AllowSecurityGroup": [],
  65. "AllowSecurityGroupEgress": []
  66. },
  67. "VPC": {
  68. "CidrBlock": "10.0.0.0/8"
  69. }
  70. }
  71. },
  72. "Groups": {
  73. "group1": {
  74. "DesiredVMCount": 3,
  75. "InstanceType": "",
  76. "ResourceType": "OnDemand",
  77. "SpotStrategy": "SpotAsPriceGo",
  78. "SpotPriceLimit": 0.0
  79. }
  80. }
  81. }

属性说明

属性名称 类型 是否必须 描述
Name string 集群名称。
ImageId string 镜像标识符。
InstanceType string 构建集群的实例类型。目前支持的ECS实例类型
Groups object 集群的实例组信息,每个实例组的信息由GroupDesc描述。
Description string 集群的描述信息。
UserData object 一个KeyValue映射,用户自定义的信息,使用ECS的metaserver获取。
Notification object 消息通知配置,用户指定消息事件Notification
Configs object 集群的一些配置信息,比如实例的磁盘配置,由Configs描述。
IdempotentToken string 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个字符,字符包括了字母、数字以及下划线。

返回信息

成功

返回201状态码以及Cluster的id,如下。

  1. {
  2. "Id":"usr-cluster-1"
  3. }

属性说明

属性名称 类型 是否必须 描述
Id string 作业标示符。

错误

状态码 错误码 错误信息 语义
400 IdempotentTokenMismatch Specified idempotent token mismatch. 说明该token已经被使用过,并且该请求参数与之前的请求不一样。
400 InvalidJsonFormat The request body has an invalid json format. 请求body是一个非法的json格式。
400 InvalidHttpBody Specified parameter HttpBody is not valid. Its type must be object. http body必须是一个object。
400 MissingName Name is mandatory for this action. 缺少Name参数。
400 MissingConfigs.Networks.VPC.OppositeRouterId Configs.Networks.VPC.OppositeRouterId is mandatory for this action. 缺少Configs.Networks.VPC.OppositeRouterId参数。
400 MissingConfigs.Networks.VPC.OppositeAccessPointId Configs.Networks.VPC.OppositeAccessPointId is mandatory for this action. 缺少Configs.Networks.VPC.OppositeAccessPointId参数。
400 MissingConfigs.Networks.VPC.OppositeRegionId Configs.Networks.VPC.OppositeRegionId is mandatory for this action. 缺少Configs.Networks.VPC.OppositeRegionId参数。
400 InvalidName Specified parameter Name is not valid. Its type must be string. Name必须是一个string。
400 InvalidName Specified parameter Name is not valid. Its length must be in [1, 64]. Name的长度必须在1与64之间。
400 InvalidName Specified parameter Name is not valid. It must only contain characters within [a-zA-Z0-9_-], and must not start with [0-9]. Name中只能包括字母数字和_-,但不能以数字开头。
400 InvalidDescription Specified parameter Description is not valid. Its type must be string. Description必须是一个string。
400 InvalidDescription Specified parameter Description is not valid. Its length must be in [0, 1024]. Description的长度必须在0与1024之间。
400 MissingImageId ImageId is mandatory for this action. 缺少ImageId参数。
400 InvalidImageId Specified parameter ImageId is not valid. Its type must be string. ImageId必须是一个string。
400 InvalidImageId Specified parameter ImageId is not valid. Its length must be in [1, 256]. ImageId的长度必须在1与256之间。
400 InvalidUserData Specified parameter UserData is not valid. Its type must be object. UserData必须是一个object。
400 InvalidUserData Specified parameter UserData is not valid. Its size must be in [0, 64]. UserData的大小必须在0与64之间。
400 InvalidUserData.{key} Specified parameter UserData.{key} is not valid. Its length must be in [1, 128]. UserData.{key}的大小必须在1与128之间。
400 InvalidUserData.{key}.value Specified parameter UserData.{key}.value is not valid. Its type must be string. UserData.{key}对应的Value必须是一个string。
400 InvalidUserData.{key}.value Specified parameter UserData.{key}.value is not valid. Its length must be in [0, 1024]. UserData.{key}对应的value的长度必须在0与1024之间。
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之间。
400 InvalidCidrBlock Specified parameter CidrBlock is not valid. Configs.Networks.VPC.CidrBlock is not valid. 无效的CidrBlock。
403 QuotaExhausted.MaxClusterCount The MaxClusterCount ({value}) quota is exhausted. Cluster数量不能超过{value}。
403 QuotaExhausted.MaxClusterGroupCount The MaxClusterGroupCount ({value}) quota is exhausted. 一个Cluster中的Group的数量不能超过{value}。
403 QuotaExhausted.MaxClusterGroupDesiredVMCount The MaxClusterGroupDesiredVMCount ({value}) quota is exhausted. 一个Cluster中的一个Group的DesiredVMCount不能超过{value}。
403 QuotaExhausted.Configs.Networks.VPC.OppositeRouterType The Configs.Networks.VPC.OppositeRouterType ({value}) is forbidden. Configs.Networks.VPC.OppositeRouterType不允许取值{value}。
400 MissingInstanceType InstanceType is mandatory for this action. 缺少InstanceType参数。
400 InvalidInstanceType Specified parameter InstanceType is not valid. InstanceType参数取值不合法。
400 MissingResourceType ResourceType is mandatory for this action. 缺少ResourceType参数。
400 InvalidResourceType Specified parameter ResourceType is not valid. ResourceType参数取值不合法。
400 Invalid{Parameter} Specified parameter {Parameter} is not valid. {Parameter}参数不合法。
本文导读目录