DescribeMetricTop - 查询排序后的最新监控数据

查询排序后的最新监控数据,支持实例网络带宽等监控数据的查询。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

MetricNames

array

监控指标列表。

string

监控项名称。

枚举值:

  • instance_out_traffic :

    流出带宽(仅限标准网络)

  • instance_in_traffic :

    流入带宽(仅限标准网络)

instance_in_traffic

AndroidInstanceIds

array

实例级别的监控,传入云手机实例 ID 列表。

矩阵级别的监控,传入矩阵 ID 列表。

string

实例级别的监控,传入云手机实例 ID。 矩阵级别的监控,传入矩阵 ID。

acp-sgicbcdadjs****

Period

integer

监控数据的统计周期。 单位:秒。

60

StartTime

string

查询监控项的开始时间。

2019-01-31 10:00:00

EndTime

string

查询监控项的结束时间。

2019-01-31 11:00:00

NextToken

string

用来标记当前开始读取的位置。置空表示从头开始。

AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uONHqPtDLM2U8s****

Length

string

返回监控数据的每页大小,用于分页查询。

说明

监控项为 instance_in_traffic 和 instance_out_traffic 时,最大值为 100。

100

InstanceIds

array

实例 ID 列表。

string

实例 ID。

说明

传入带宽包 ID,可查询带宽包下按带宽降序后 Top N (N 小于等于 100)带宽数据

np-5hh4a31emkt6u****

返回参数

名称

类型

描述

示例值

object

接口返回数据。

RequestId

string

请求 ID。

4610632D-D661-5982-B3D7-5D3FD183F****

Count

integer

数量。

1

NextToken

string

下一次查询的令牌(Token)。如果一次查询结果并没有完整返回所有的结果,则返回的 NextToken 不为空。您可以在查询中上传返回的 NextToken 继续查询。

AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****

MetricTotalModel

array<object>

实例监控结果列表。

array<object>

实例监控结果。

AndroidInstanceId

string

实例级别的监控,返回云手机实例 ID。 矩阵级别的监控,返回矩阵 ID。

acp-fkuit0cmyru4p****

InstanceId

string

实例 ID。

np-5hh4a31emkt6u****

MetricModelList

array<object>

指标监控结果列表。

array<object>

指标监控结果。

MetricName

string

监控项名称。

instance_in_traffic

DataPoints

array<object>

监控统计数据点。

object

监控统计数据点。

Timestamp

integer

统计时间戳。单位:毫秒。

1548777660000

Minimum

number

最小值。

说明

监控项为 instance_in_traffic 和 instance_out_traffic 时单位是 bps。

93.1

Average

number

平均值。单位:%。

说明

监控项为 instance_in_traffic 和 instance_out_traffic 时单位是 bps。

99.52

Maximum

number

最大值。单位:%。

说明

监控项为 instance_in_traffic 和 instance_out_traffic 时单位是 bps。

100

Name

string

名称。

cloudPhone-****

Id

string

ID 信息。

acp-fkuit0cmyru4p****

Properties

string

属性信息。

说明

返回扩展属性信息字符串(Json 格式) 。

{"IP":"192.168.*.***"}

示例

正常返回示例

JSON格式

{
  "RequestId": "4610632D-D661-5982-B3D7-5D3FD183F****",
  "Count": 1,
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****",
  "MetricTotalModel": [
    {
      "AndroidInstanceId": "acp-fkuit0cmyru4p****",
      "InstanceId": "np-5hh4a31emkt6u****",
      "MetricModelList": [
        {
          "MetricName": "instance_in_traffic",
          "DataPoints": [
            {
              "Timestamp": 1548777660000,
              "Minimum": 93.1,
              "Average": 99.52,
              "Maximum": 100,
              "Name": "cloudPhone-****",
              "Id": "acp-fkuit0cmyru4p****\n",
              "Properties": "{\"IP\":\"192.168.*.***\"}"
            }
          ]
        }
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情