文档

QueryCommercialUsage - 查询可观测用量数据

更新时间:

查询写入量数据,支持应用监控、可观测链路OpenTelemetry版、Prometheus、用户体验监控四大产品用量数据。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
arms:QueryCommercialUsageget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
IntervalInSecinteger

数据片的时间间隔,单位为秒,最小值为 3600。

枚举值:
  • 3600小时
  • 86400
3600
StartTimelong

起始时间的时间戳,精确到毫秒。

1699200000000
EndTimelong

结束时间的时间戳,精确到毫秒。

1699286400000
OrderBystring

排序依据,可设为任一 dimesion

枚举值:
  • dataTypedataType
dataType
Metricstring

指标名称,取值:USAGEFEE.STAT

USAGEFEE.STAT
Orderstring

排序标准。取值:

  • ASC:升序。
  • DESC:降序。
ASC
AdvancedFiltersarray<object>

过滤条件数组

object
Keystring

过滤条件的 key

regionId
Valuestring

过滤条件的 value

cn-hangzhou
OpTypestring

操作符,目前仅支持等于或者 in

枚举值:
  • inin
  • eqeq
eq
Dimensionsarray

指标对应的维度。

  • dataType 数据类型
  • productType 产品类型
  • instanceId 实例 ID
  • instanceName 实例名称
  • instanceType 实例类型
string

指标对应的维度。

dataType
Measuresarray

指标对应的测量数据。

string

指标对应的测量数据。目前仅支持 byte_sum

byte_sum
QueryTypestring

查询的数据返回类型:

  • instantQuery 非时序
  • timeSeriesQuery 时序
instantQuery

返回参数

名称类型描述示例值
object
Codeinteger

接口状态,取值说明如下:2XX:成功。3XX:重定向。4XX:请求错误。5XX:服务器错误。

200
Messagestring

调用失败时返回的信息。

success
RequestIdstring

请求 ID。

99A663CB-8D7B-4B0D-A006-03C8EE38E7BB
Successboolean

查询是否成功:

  • true:成功。
  • false:失败。
true
Dataobject

返回结构体。

Completeboolean

涉及到多区域查询是,整体是否执行完成:

  • true:是。

  • false:否。

true
Itemsarray<object>

返回数据的数据结构体列表。

object

数据项

{ "date": "1697108400", "dataType": "metrics", "byte_sum": 9497922 }

示例

正常返回示例

JSON格式

{
  "Code": 200,
  "HttpStatusCode": 0,
  "Message": "success",
  "RequestId": "99A663CB-8D7B-4B0D-A006-03C8EE38E7BB",
  "Success": true,
  "Data": {
    "Complete": true,
    "Items": [
      {
        "date": "1697108400",
        "dataType": "metrics",
        "byte_sum": 9497922
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400ParameterMetricIllegalThe specified metric is invalid.参数metric非法
400ParameterMeasuresIllegalThe specified Measures is invalid.Measures非法
400ParameterTimeStampIllegalThe specified timeStamp is invalid.时间参数非法
400ParameterOrderIllegalThe specified order is invalid.参数order非法
400ParameterPageSizeIllegalThe specified PageSize is invalid.PageSize非法
400ParameterIntervalIllegalThe specified interval is invalid.参数Interval非法
400ParameterMeasuresMissingYou must specify measures.参数measures缺失
400ParameterDimensionsIllegalThe specified dimensions is invalid.Dimensions非法
400ParameterRegionIdIllegalThe specified RegionId is invalid.RegionId非法
400InternalErrorInternal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries.内部错误,建议重试。如果多次重试报错请联系钉钉服务账号。
403APINotAuthorizeThe current user is not authorized to access the interface.当前用户无权限访问该接口

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

变更历史

变更时间变更内容概要操作
2024-07-25OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
  • 调用时为什么会出现 RAM 的权限问题? 这可能是由于该 RAM 角色没有权限,您可以为用户添加权限,请参见借助 RAM 角色实现跨云账号访问资源。
  • 怎么拉取列表数据(不考虑时间粒度)? 将 queryType 设置为 instantQuery
  • 返回时间非法,目前 intervalInSec 仅支持 3600 以及 8600,不支持其他间隔