全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
日志服务

ListMachines

更新时间:2018-04-02 22:46:21

获得 machinegroup 下属于用户并与 Server 端连接的机器状态信息。

示例:

GET /machinegroups/{groupName}/machines?offset=1&size=10

  1. GET /machinegroups/{groupName}/machines HTTP/1.1
  2. Authorization: <AuthorizationString>
  3. Date: <GMT Date>
  4. Host: <Project Endpoint>
  5. x-log-apiversion: 0.6.0
  6. x-log-signaturemethod: hmac-sha1

请求参数

URL 参数:

名称 类型 必须 描述
groupName string 机器分组名称
offset int 返回记录的起始位置,默认为 0
size int 每页返回最大条目,默认 500(最大值)

请求头

无特有请求头。关于 Log Service API 的公共请求头,请参考 公共请求头

响应头

无特有响应头。关于 Log Service API 的公共响应头,请参考 公共响应头

响应元素

名称 类型 描述
count int 返回的 machine 数目
total int machine 总数
machines json array 返回的 machine 名称列表

machines 说明如下:

名称 类型 描述
ip string 机器的 IP
machine-uniqueid string 机器 DMI UUID
userdefined-id string 机器的用户自定义标识
  1. {
  2. "count":10,
  3. "total":100,
  4. "machines":
  5. [{
  6. "ip" : "testip1",
  7. "machine-uniqueid" : "testuuid1",
  8. "userdefined-id" : "testuserdefinedid1",
  9. "lastHeartbeatTime" : 1447182247
  10. },
  11. {
  12. "ip" : "testip1",
  13. "machine-uniqueid" : "testuuid2",
  14. "userdefined-id" : "testuserdefinedid2",
  15. "lastHeartbeatTime" : 1447182247
  16. },
  17. {
  18. "ip" : "testip2",
  19. "machine-uniqueid" : "testuuid",
  20. "userdefined-id" : "testuserdefinedid"
  21. "lastHeartbeatTime" : 1447182247
  22. }]
  23. }

错误码

除了返回 Log Service API 的 通用错误码,还可能返回如下特有错误码:

HTTP 状态码 ErrorCode ErrorMessage
404 GroupNotExist group {GroupName} does not exist
500 InternalServerError internal server error

细节描述

该接口只获取与 Server 端连接正常的机器列表。

示例

请求示例:
  1. GET /machinegroups/test-machine-group-5/machines?offset=0&size=3 HTTP/1.1
  2. Header :
  3. {
  4. "x-log-apiversion": "0.6.0",
  5. "Authorization": "LOG 94to3z418yupi6ikawqqd370:9yoK0iJPxr0RrWf/wW9NJYXu4zo=",
  6. "Host": "ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com",
  7. "Date": "Tue, 10 Nov 2015 19:04:57 GMT",
  8. "Content-Length": "0",
  9. "x-log-signaturemethod": "hmac-sha1",
  10. "User-Agent": "sls-java-sdk-v-0.6.0",
  11. "Content-Type": "application/x-protobuf",
  12. "x-log-bodyrawsize": "0"
  13. }
响应示例:
  1. HTTP/1.1 200 OK
  2. Header :
  3. {
  4. "Date": "Tue, 10 Nov 2015 19:04:58 GMT",
  5. "Content-Length": "324",
  6. "x-log-requestid": "56423FD999248C827B000A57",
  7. "Connection": "close",
  8. "Content-Type": "application/json",
  9. "Server": "nginx/1.6.1"
  10. }
  11. Body :
  12. {
  13. "machines": [
  14. {
  15. "ip": "10.101.166.116",
  16. "machine-uniqueid": "",
  17. "userdefined-id": "",
  18. "lastHeartbeatTime": 1447182247
  19. },
  20. {
  21. "ip": "10.101.165.193",
  22. "machine-uniqueid": "",
  23. "userdefined-id": "",
  24. "lastHeartbeatTime": 1447182246
  25. },
  26. {
  27. "ip": "10.101.166.91",
  28. "machine-uniqueid": "",
  29. "userdefined-id": "",
  30. "lastHeartbeatTime": 1447182248
  31. }
  32. ],
  33. "count": 3,
  34. "total": 8
  35. }
本文导读目录