全部产品
Search
文档中心

获取集群列表

更新时间: 2018-05-14

描述

获取集群列表(ListClusters)。

请求语法

  1. GET /clusters?Marker={Marker}&MaxItemCount={MaxItemCount}

属性说明

属性名称 类型 是否必需 描述
Marker string 本页起始资源标识符。默认为空字符串。
MaxItemCount int 实际返回最大资源数量。默认值50,最大值100。

返回信息

成功

返回200状态码以及集群列表信息,如下。

  1. {
  2. "NextMarker": "",
  3. "Items":[{
  4. "Name": "clusterName1",
  5. "Id": "cls-6kir9pdp3lg6220g418002",
  6. "OwnerId": 123,
  7. "Description": "demo",
  8. "CreationTime": "2016-10-31T06:55:33.921897Z",
  9. "State": "Active",
  10. "ImageId": "img-ubuntu",
  11. "Notification": {
  12. "Topic": {
  13. "Name": "test-topic",
  14. "Endpoint": "http://[UserId].mns.[Region].aliyuncs.com/",
  15. "Events": [
  16. "OnClusterDeleted",
  17. "OnInstanceCreated",
  18. "OnInstanceActive"
  19. ]
  20. }
  21. },
  22. "Configs": {
  23. "Disks": {
  24. "SystemDisk": {
  25. "Type": "cloud",
  26. "Size": 500
  27. },
  28. "DataDisk": {
  29. "Type": "cloud",
  30. "Size": 500,
  31. "MountPoint": "/path/to/mount"
  32. }
  33. }
  34. },
  35. "Groups": {
  36. "group1": {
  37. "DesiredVMCount": 3,
  38. "ActualVMCount": 2,
  39. "InstanceType": "bcs.a2.large",
  40. "ResourceType": "OnDemand"
  41. }
  42. },
  43. "OperationLogs": ["[2016-10-31T06:55:33.921897Z][group]Creating instance group successfully","[2016-10-31T06:55:33.941897Z]Creating cluster successfully"],
  44. "Metrics": {
  45. "RunningCount": 1,
  46. "StartingCount": 0,
  47. "StoppingCount": 0,
  48. "StoppedCount": 0
  49. }
  50. }]
  51. }

属性说明

属性名称 类型 描述
NextMarker string 下一页起始资源标识符。最后一页该值为空。
Items array 集群列表。

错误码

错误码 错误信息 状态码 语义
InvalidMaxItemCount Specified parameter MaxItemCount is not valid. Its type must be integer. 400 MaxItemCount必须是一个integer。
InvalidMaxItemCount Specified parameter MaxItemCount is not valid. It must be in [0, 100]. 400 MaxItemCount的大小必须在0与100之间。