AI 助理
文档备案控制台
官方文档
首页

计算巢按量付费服务云市场上报数据说明

更新时间：
复制 MD 格式
产品详情
我的收藏

计算巢服务上架云市场且设置为按量付费后，需要上报服务实例资源或数据以便云市场计算费用。本文介绍如何上报数据和修改数据的上报方式。

背景信息

  • 数据上报是指计算巢将云市场购买的计算巢服务实例中使用的资源数据推送至云市场，云市场在获取数据后，会根据云市场商品预先定义的计费信息折算服务实例的费用并扣除。

  • 对于按量付费的服务，云市场提供了11个计量维度，分别为：Frequency、Period、Storage、NetworkOut、NetworkIn、Character、DailyActiveUser、PeriodMin、VirtualCpu、Memory和Unit。

  • 按量付费服务的数据上报方式分为服务商主动上报和计算巢自动上报两种，其中Period、PeriodMin、VirtualCpu、Storage四个维度的数据支持计算巢上报或者服务商主动上报两种方式，其他计量维度的数据当前仅支持服务商主动上报方式。

服务商上报数据说明

服务商可以通过在应用中集成上报API，通过调用API实现上报。具体上报方式如下。

  1. 获取应用部署的ECS地域（regionld）信息。

    访问如下网址，获得地域信息。获取到的地域信息，会在后续步骤中使用，因此需要您记录。

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

    返回示例

    curl http://100.100.100.200/latest/meta-data/region-id
cn-wulanchabu

  2. 发起上报调用。

    调用参数的格式与云市场API类型，但调用命令中不需要填写InstanceId参数值。

    调用PushMeteringData格式如下：

    curl -H "Content-Type: application/json" -XPOST https://<regionId>.axt.aliyun.com/computeNest/marketplace/push_metering_data -d '{"Metering":"[{\"StartTime\":\"100000000\",\"EndTime\":\"100000010\",\"Entities\":[{\"Key\":\"Frequency\",\"Value\":\"96\"}]}]"}'

    将regionId替换成步骤1中获取的地域信息，发起上报调用。

    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\"}]}]"}'

    返回结果

    • 上报成功

      curl -H "Content-Type: application/json" -XPOST https://cn-wulanchabu.axt.aliyun.com/computeNest/marketplace/push_metering_data
{"Code":"200","RequestId":"e6862d3a-9385-4289-8dd3-9c52a6802280","StartTime":"1664451045","EndTime":"1664451228","instanceId":"0-ij1d5hy53xfy81nwu16cZ","Entities":[{"Key":"Frequency","Value":"6"}]}
{"Code":"200","RequestId":"0E070CDCA-16F9-113E-AD14-4B618ECD6F68","result":{"1":"0j1d5hy53xfy81nwu16cZ"},"PushMeteringDataRequestId":"1106d44C-E003-5169-79137007CB5","Token":"05130a063e6ac1883280d2316989894d*","Success":true}

    • 上报失败

      • 当前服务实例不可上报数据（服务实例为非按量付费实例）。

        curl -H "Content-Type: application/json" -XPOST https://cn-wulanchabu.axt.aliyun.com/computeNest/marketplace/push_metering_data -d '{"Metering":"{\"StartTime\":\"V6644531237\",\"EndTime\":\"V6644531237\",\"Entities\":[{\"Key\":\"KeyDomain\",\"Value\":\"1\"}]}"}'
{"Code":"400","RequestId":"1f9b0b19-596b7192-3906-41e8-80b0e-b7e0b6ca3fcf3","InstanceId":"si-4j|1564mproo9nomixntiZ","errCode":"NotSupportPushMeteringData","errMsg":"NotSupportPushMeteringData : The ServiceInstance si-4d0009e39c394379b2ee does not supported push metering data.\r\nRequestId: 93C64F0A-222F-1E99-9785-88ACB5022D74\r\n"}

      • 当前计量维度由计算巢上报，服务商不可上报。

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

        返回错误示例：

        {"code":400,"requestId":"bcbd7604-1f0a-4569-b244-b6bf6def4ca2","instanceId":"i-0xxx","errCode":"NotSupportPushMeteringData","errMsg":"NotSupportPushMeteringData : Not support push metering data entity \"Period\"."}

      • 当前计量维度不合法。当请求体中 Entities 的 Key 值不合法（如 PeriodMin123）时，接口返回 Invalid.Parameter.Metering 错误。

        curl -H "Content-Type: application/json" -XPOST https://cn-wulanchabu.xxx.aliyun.com/computeNest/marketplace/push_metering_data \
-d '{"Metering":"[{\"StartTime\":\"1664451123\",\"EndTime\":\"1664451198\",\"Entities\":[{\"Key\":\"PeriodMin123\",\"Value\":\"1\"}]}]"}'  
{"code":400,"requestId":"a3bc4111-5df7-46ea-937d-f8fc14316535","instanceId":"i-0jxxx","errCode":"Invalid.Parameter.Metering","errMsg":"Invalid.Parameter.Metering : The specified Metering parameter is invalid.\r\nRequestId : 2E6299F7-B3B3-1572-B6F2-11AED28499B6"}

计算巢上报数据说明

计算巢每个整点（间隔一小时）会依据服务定义计量维度统计并上报一次数据。当前仅支持上报Period、PeriodMin、VirtualCpu、Storage四个维度的数据。

只要服务实例存在（未删除），不论ECS实例状态如何，计算巢均会上报数据。具体维度计量单位与云市场保持一致。

计算巢支持的数据上报维度信息如下。

名称

说明

Period

使用小时时长（秒）。

服务实例创建后第一次上报时，计算巢会计算服务实例创建完成时间到当前时间的差值，如果小于半小时，即小于0.5小时，计算巢会以0小时上报，即不计费；反之，如果大于0.5小时，计算巢会以1小时上报。当服务实例删除时，计算巢会在资源删除前最后上报一次数据，上报计量方式同前述。

PeriodMin

使用分钟时长（分钟）。

服务实例创建后第一次上报时，计算巢会计算服务实例创建完成时间到当前时间的差值，如果小于半分钟，即小于0.5分钟，当前分钟数不计入，如计算得出分钟数为35.3分钟，则计算巢只上报35分钟，反之，如果大于半分钟，如计算得出分钟数为35.7分钟，则计算巢上报的分钟数为36分钟。服务实例删除时，计算巢会在资源删除前最后上报一次数据，上报计量方式同前述。

VirtualCpu

虚拟CPU核数（核/小时）。

计算巢将在上报时刻统计vCPU总数作为上报值，如目前服务实例一共有10台ECS实例，计算得到10台VCPU总数为48核，则上报数量为48核/小时，不论过去时间vCPU数量如何变化，均以上报时刻的vCPU核数为准。服务实例删除时，计算巢会在资源删除前最后上报一次数据，上报计量方式同前述。

Storage

使用存储空间（Byte）。

计算巢将在上报时刻统计存储量作为上报值，如目前服务实例一共有10台ECS，计算得到10台存储量为200 GB，则上报数量为200 GB，不论过去一段时间存储量如何变化，均以上报时刻的存储量为准。服务实例删除时，计算巢会在资源删除前最后上报一次数据，上报计量方式同前述。

修改上报方式

当前计算巢支持上报的维度为Period、PeriodMin、VirtualCpu、Storage，计算巢每个整点（间隔一小时）会依据服务定义计量维度统计并上报一次数据。这四个维度的上报方式默认为计算巢上报，若您想将这四个维度的上报方式修改为主动上报，可在计算巢控制台上进行修改。详细的操作流程如下。

  1. 登录计算巢控制台。

  2. 在左侧导航栏中，选择服务目录 > 我的服务，在我的服务页面中，选择我发布的服务，然后单击创建新服务。

    说明

    如果您的服务当前版本为未发布的版本，若您需要编辑按量上报方式，必须有一个历史版本已经发布且已上架到云市场商品。

  3. 单击服务名称，进入服务详情页面。

  4. 单击编辑按量上报方式。

  5. 在编辑按量上报方式弹窗中，修改上报方式。

    说明

    若某维度选择了计算巢上报数据，服务商错误上报此维度的数据时，则会提示此维度不可上报。

    在编辑按量上报方式弹窗中，可为各计量指标（如使用分钟时长、使用小时时长、虚拟CPU核数、上行使用流量、字符数、下行使用流量等）分别选择服务商上报或计算巢上报，设置完成后单击确定。

  6. 单击确定。