PushMeteringData_云市场_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 请求参数全部需要 URLEncode 编码。
  • 云市场对每个 InstanceId 的请求限制为 60 秒一次,每次请求支持写入的计量数据为 100 条。
  • 不支持跨商品的 InstanceId 批量推送,批量推送时请确保所有 InstanceId 来自同一个商品。
  • 批量推送计量数据时,“InstanceId”属性必须为同一个商品所产生的实例,目前不支持多个商品的实例同时推送。
  • 按小时出账的商品,截止出账时间是下一个小时,计量数据必须按时推送过来。比如推送的计量数据是 8:10-08:20, 则必须在 9.59 之前将计量数据推送过来,否则将不会出账。按天出账规则类似,即第二天必须要把前一天的数据推送过来,否则不会出账。
  • 如果商品设置为实时出账,StartTime 和 EndTime 为任意时间宽度均可以,但是 EndTime 一定要大于 StartTime 。
  • 如果商品设置为非实时出账(即选择按小时、按天、按月等),StartTime 和 EndTime 的间隔必须大于 5 分钟。 -注意参数中 Metering 字段要严格按照文档中的示例来提交,以往发现很多提交过来的不是一个 JSON 字段,再提交之前可以先用 JSON 格式化工具检查一下,否则接口调用会失败, 一定要仔细检查。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
acm:PushMeteringData
Create
全部资源
*

请求参数

字段名称字段详情
Meteringstring

示例中的参数说明如下:展开详情

示例值:[{"InstanceId":"1000001","StartTime":"100000000","EndTime":"100000010","Entities":[{"Key":"PeriodMin","Value":"96","meteringAssit":"cmapi00060317-PeriodMin-4"}]}]

返回参数

字段名称字段详情
Successboolean

成功状态标识

示例值:true
RequestIdstring

请求 ID

示例值:6EF60BEC-0242-43AF-BB20-270359FB54A7

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
Invalid.Parameter.Metering
meteringAssit is empty诊断
500
UnknownError
An error occurred while processing your request.诊断
500
Service.Flow.Control
The rate throttling threshold has been exceeded.诊断
500
Invalid.Parameter
The specified parameter is invalid.诊断
500
Invalid.Parameter.Instance
The specified Instance parameter is invalid.诊断
500
Invalid.Parameter.Metering
The specified Metering parameter is invalid.诊断
500
Metering.Data.Exceeded
The number of metering entities must not exceed 100.诊断
500
Permission.Denied
You are not authorized to call the API operation. Contact the API developer to add your account to the API user whitelist.诊断

变更历史

变更时间变更内容概要操作
2023-07-10
新增错误码400

相关示例