全部产品
Search

搜索本产品

    云监控：BatchExport - 导出在Cursor中定义的监控数据

    文档中心

    云监控：BatchExport - 导出在Cursor中定义的监控数据

    更新时间：Jul 26, 2024

    调用BatchExport接口导出在Cursor接口中定义的监控数据。

    接口说明

    前提条件

    请确保您已调用 Cursor 接口获取初始的Cursor。

    使用说明

    本文将提供一个示例，导出云产品acs_ecs_dashboard的监控项cpu_idle的某个初始Cursor的监控数据，且每次最多返回 1000 条数据。

    调试

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

    授权信息

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

    请求参数

    名称类型必填描述示例值
    Namespacestring是

    云产品的数据命名空间。

    关于如何获取云产品的数据命名空间，请参见云产品监控项。

    说明 本参数必须与 Cursor 接口中的请求参数Namespace相同。
    		acs_ecs_dashboard
    Metricstring是

    云产品的监控项名称。

    关于如何获取云产品的监控项名称，请参见云产品监控项。

    说明 本参数必须与 Cursor 接口中的请求参数Metric相同。
    		cpu_idle
    Cursorstring是

    循环调用本接口导出数据时，必须输入Cursor的值。Cursor值的获取方法如下：

    • 当您初次调用本接口时，必须先调用 Cursor 接口，获取Cursor的值。更多信息，请参见 Cursor 。

    • 当您再次调用本接口时，可以从上次调用本接口的返回数据中获取Cursor的值。

    		eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0MzIwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQ3NTY2MzYzMjY3NmI2ZjM5MzU2YjY4MzAzMTYyNzg3MTcwNjkzMTM3MjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2****
    Lengthinteger是

    每次最多返回的数据条数。

    取值范围：1~10000。

    		1000
    Measurementsarray否

    用于定制返回数据的测量值。默认返回全部测量值。

    例如：云产品acs_ecs_dashboard的监控指标cpu_idle下有三个测量值的列，分别是Average、Maximum或Minimum，如果只需要返回Average和Maximum两列，则该参数设置为["Average", "Maximum"]数组即可。

    关于如何获取云产品的监控指标的测量值，请参见云产品监控项的statistics列。

    string否

    测量值列名。

    		Maximum

    关于公共请求参数的详情，请参见公共参数。

    返回参数

    名称类型描述示例值
    object

    无。

    Messagestring

    返回信息。

    		success
    Codeinteger

    状态码。

    说明 200 表示成功。
    		200
    Successboolean

    操作是否成功。取值：

    • true：成功。

    • false：失败。

    		true
    RequestIdstring

    请求 ID。

    		251402CD-305C-1617-808E-D8C11FC8138D
    Cursorstring

    用于再次调用本接口。

    说明 如果返回结果为null，则说明监控数据导出完成。
    		v2.5eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0ODAwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQzMjdhNjU2MjY3N2E2NjZhNzczOTY2NmM3Mjc0NjM3MzY5Njg3NDcyMjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2MH0***
    Lengthinteger

    本次调用数据返回的条数。

    		1000
    Anchorlong

    后端请求数据的时间戳。时间戳越大，表示导出数据越靠近当前时间。

    		1678781819000
    HasNextboolean

    数据是否已完成导出。取值：

    • true：部分数据未完成导出。
    • false：数据已完成导出。
    		true
    DataResultsarray

    当前调用的返回数据。

    MetricStat

    导出数据。具体如下：

    • Namespace：云产品的数据命名空间，例如：acs_ecs_dashboard。
    • Metric：云产品的监控项名称，例如：cpu_idle。
    • Timestamp：监控数据的时间戳（单位：毫秒），例如：1641454680000。
    • Period：监控数据的统计周期（单位：秒），例如：60。
    • Dimensions：用于标识监控对象（实例）的 Dimension 信息，例如：[{"Label":"userId", "Value":""20654616023382****"}, {"Label":"InstanceId", "Value":""i-2ze2d6j5uhg20x4****"}]。
    • Associated：监控对象（实例）的附加信息，例如：标签信息之类，key:value 键值对形式的集合，例如：{"group":"test****", "name":"Alice"}。
    • Measurements：指标的测量值（默认多值模式），例如：{"Average":60,"Maximum":85}。
    • LogTime：监控数据的记录时间（单位：毫秒），对于非原始数据（聚合后的数据），LogTime为空（NULL）。

    示例

    正常返回示例

    JSON格式

    {
  "Message": "success",
  "Code": 200,
  "Success": true,
  "RequestId": "251402CD-305C-1617-808E-D8C11FC8138D",
  "Cursor": "v2.5eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0ODAwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQzMjdhNjU2MjY3N2E2NjZhNzczOTY2NmM3Mjc0NjM3MzY5Njg3NDcyMjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2MH0***",
  "Length": 1000,
  "Anchor": 1678781819000,
  "HasNext": true,
  "DataResults": [
    {
      "Namespace": "acs_ecs_dashboard",
      "Metric": "cpu_idle",
      "Period": 60,
      "Timestamp": 1641454680000,
      "Dimensions": [
        {
          "Label": "instanceId",
          "Value": "i-dferwret*****"
        }
      ],
      "Associated": {
        "key": "{\"group\":\"test****\", \"name\":\"Alice\"}"
      },
      "Measurements": {
        "key": "{\"Average\":60,\"Maximum\":85}"
      },
      "LogTime": 1683686550073
    }
  ]
}

    错误码

    HTTP status code错误码错误信息
    400%s%s
    500InternalErrorThe request processing has failed due to some unknown error.

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史