PushMeteringData_计算巢服务(Compute Nest)-阿里云帮助中心

调用PushMeteringData推送计量数据。

接口说明

该命令只支持推送按量付费的计算巢服务实例的计量数据，推送的计量项需要定义为服务商上报。

请求参数

名称

类型

是否必选

描述

示例值

Metering

String

否

示例中的参数说明如下：

StartTime：计量开始时间。单位：秒。
EndTime：计量结束时间。单位：秒。
Entities：计量实体对象。
- Key：计量项属性名称。
  - Frequency：使用次数（次）。
  - Period：使用小时时长（秒）。
    重要
    请求参数中的时长单位为秒，而计费单位为小时，因此计费时会转换为小时，如推送19:00-20:00的用量1800，计费价格为1 元/小时，按小时出账该时段费用为1800/3600 x 1 = 0.5 元，费用如为小数，保留两位小数，超过两位舍弃。
  - Storage：使用存储空间（Byte）。
    重要
    请求参数中的单位为 Byte，而计费单位为 MB，因此计费时会转换为 MB，如推送 19:00-20:00 的用量 524288，计费价格为 1 元/MB，按小时出账该时段费用为 524288 / 1024 / 1024 x 1 = 0.5 元，费用如为小数，保留两位小数，超过两位舍弃。
  - NetworkOut：上行使用流量（Bit）。
    重要
    请求参数中的单位为 Bit，而计费单位为 Mb，因此计费时会转换为 Mb，如推送 19:00-20:00 的用量 524288，计费价格为 1 元/Mb，按小时出账该时段费用为 524288 / 1024 / 1024 x 1 = 0.5 元，费用如为小数，保留两位小数，超过两位舍弃。
  - NetworkIn：下行使用流量（Bit）。
    重要
    请求参数中的单位为 Bit，而计费单位为 Mb，因此计费时会转换为 Mb，如推送 19:00-20:00 的用量 524288，计费价格为 1 元/Mb，按小时出账该时段费用为 524288 / 1024 / 1024 x 1 = 0.5 元，费用如为小数，保留两位小数，超过两位舍弃。
  - Character：字符数（个）。
  - DailyActiveUser：日活跃用户数（DAU）。
  - PeriodMin：使用分钟时长（分钟）。
  - VirtualCpu：虚拟CPU核数。
- Value：计量数值（取值>=0）。

说明

如果商品设置为实时出账，StartTime和EndTime为任意时间宽度均可以，但是EndTime一定要大于StartTime。
如果商品设置为非实时出账（即选择按小时、按天、按月等），StartTime和EndTime的间隔必须大于5分钟。

[{\"StartTime\":\"1664451045\",\"EndTime\":\"1664451198\",\"Entities\":[{\"Key\":\"Frequency\",\"Value\":\"6\"}]}]

返回参数

名称	类型	示例值	描述
RequestId	String	e6862d3a-9305-4289-8dd3-9c52a680228b	请求ID。
instanceId	String	i-0jld5hy53xfyxxxxxxxx	实例ID。
Token	String	50130a063c6acf833280d23169898bd4	数字签名。
Success	Boolean	true	成功状态标识

示例

本示例是云市场按量付费的计算巢商品创建的ECS中发起掉用。在发起调用前，您需要先获取应用部署的ECS地域（regionld）信息，并将调用命令中的地域替换成已获取的地域信息，发起上报调用。

访问如下网址，获得地域信息。

http://100.100.100.200/latest/mata-data/region-id

返回地域示例

cn-wulanchabu

请求示例

curl -H "Content-Type: application/json" -XPOST https://cn-wulanchabu.axt.aliyun.com/computeNest/marketplace/push_metering_data -d '{"Metering":"[{\"StartTime\":\"1664451045\",\"EndTime\":\"1664451198\",\"Entities\":[{\"Key\":\"Frequency\",\"Value\":\"6\"}]}]"}'

返回示例

{
    "RequestId":"4ca591b5-bc30-4fa7-aeaa-c4d0ec5d24ed",
    "Success":"true",
    "PushMeteringDataRequestId":"i-0jld5hy53xfyxxxxxxxx",
    "Token":"50130a063c6acf833280d23169898bd4"
}

错误码

错误码	错误信息	描述
NotSupportPushMeteringData	The serviceInstance ${serviceInstanceId} does not supported push metering data.	当前计量维度由计算巢上报，服务商不可上报或者当前服务实例非按量付费服务实例
NotSupportPushMeteringData	Not support push metering data entity "${EntityId}"	不支持推送计量数据，计量项未绑定
MissingParameter	The input parameter "${parametersName}" that is mandatory for processing this request is not supplied.	缺少参数
InvalidJsonString	The specified parameter "${parameterName}" is not valid json string.	参数上报格式非json
NotBindMeteringAssist	This service version is not bound to the marketplace metering assist.	服务没有绑定计量项