云市场计量映射上报说明

背景信息

针对依赖硬件资源计费的软件（如底层服务器的规格越好、数量越多，则其费用越高），需要获取云资源数据以计量计费。然而软件获取云资源数据存在一定难度，且不同厂商需要针对上报逻辑定制化开发软件，存在一定开发成本。此外，全托管服务由于资源开在服务商账号，服务商收费需包含资源费用，这部分费用现有流程较难收取。计算巢提出计量项映射上报的方案，适用于全托管和私有部署场景。全托管服务中，服务商可在计算巢配置映射上报，将资源费用并入计量项中，作为云市场计量项的值进行上报并及时推送到用户账号中向用户收取资源费用。

操作流程

此处介绍如何配置按量计费商品的计量项。

1. 创建服务并发布至云市场。

   创建服务的详细信息，请参见创建私有部署服务。

   将服务发布至云市场并设置为按量付费收费模式的详细信息，请参见将服务上架到云市场。

2. 配置计量项。

   说明

   由于兼容原因，此步骤仅适用于新创建的服务，旧服务的设置计量项的方式，请参见计算巢按量付费服务云市场上报数据说明。

   1. 进入已发布至云市场的服务详细页。

   2. 在基本信息区域的关联云市场商品处，单击前往编辑。

   3. 在云市场页中的计量项页签中，单击修改上报方式的计量项，然后在修改页面中，修改上报方式。

      修改上报方式时，一个计量项只能选择一种上报方式，如已选择计算巢上报方式，则服务商不可以自己调用API上报这个计量项。若需同一个计量项（如Unit）同时存在计算巢上报和服务商上报时，建议您在云市场多定义几个计量项。

      • 服务商上报：服务商手动调用API上报数据。选择服务商上报后，您需要在商品绑定页签中编辑计量项。详细信息，请参见计算巢按量付费服务云市场上报数据说明。

      • 计算巢上报：计算巢映射上报计量数据，选择此项的计量项将出现在映射上报页签中。

        若计量项为Unit时，可以选择资源量上报或按Pod数上报中的一种方式。

        • 资源量上报：上报用户的资源量信息，和其他计量项计算巢上报功能相同。

        • 按Pod数上报：上报用户的Pod数量，非容器部署无需选择。

          选择按Pod数上报时，您需要设置上报Pod所属的命名空间信息。

          说明

          若选择计算巢上报且选择按Pod数上报，则计量项将出现在商品绑定中，在绑定至某一模板或套餐后，计算巢将自动上报Pod数，上报间隔为每小时一次。

          • 固定Namespace：需要填写新建的Namespace名称，该选项适用于新建ACK的场景。

          • 动态Namespace：仅支持上报Namespace为服务实例ID的Pod数，该选项适用于已有ACK的场景。选择动态Namespace前，您需要在服务模板中将DefaultNamespace的值定义为ALIYUN::StackName。

          

3. 配置映射上报。

   1. 在计量映射页签中，单击编辑。

   2. 在映射关系编辑页面中，配置映射上报参数。

      根据映射范围，可选择服务、模板或套餐三个范围中的一个。

      说明

      若服务中无多模板或模板中无多套餐，对应映射范围将不可选择。

      • 选择服务时，会自动展示计量上报方式中选择计算巢上报的所有计量项。

      • 选择模板或套餐时，可自由添加具体的计量项。单个计量项的范围仍然为计算巢上报方式的所有计量项。

   3. 完成配置后，单击确定。

4. 用户场景下的服务实例将自动完成计量上报。

   说明

   • 若选择计算巢上报且选择按Pod数上报，则计量项将出现在商品绑定中，在绑定至某一模板或套餐后，计算巢将自动上报Pod数，上报间隔为每小时一次。

   • 其他计量上报的频率为一天上报一次，即每天中午12点上报前一天数据。在服务实例删除后的第一天将会上报前一天（即删除当日）的数据。

云市场计量项与账单Code映射关系表达式

当前计算巢官方预定义了如下映射关系表达式。若有特殊需求，欢迎联系计算巢官方增加映射关系表达式。映射关系表达式中Usage和ServicePeriod等参数为调用分账账单API的返回值。例如，映射关系表达式中的InstanceConfig.CPU * Usage表示返回值InstanceConfig中CPU的数量乘以返回参数Usage中的值。

如下为API DescribeSplitItemBill截取的部分返回值，依据上述映射关系表达式，可计算出云市场计量项PeriodMin的上报结果。根据映射关系表达式表中可知，该计量项的映射关系表达式为ServicePeriod/60，从返回示例中可获取该参数的值为：54000/60=900。在云市场最终的上报结果为：[{"InstanceId":"xxxx","StartTime":"10000xxxx","EndTime":"10000xxxx","Entities":[{"Key":"PeriodMin","Value":"900","meteringAssit":"cmapi0006xxxx-PeriodMin-1"}]}]

{
    "Message":"Successful!",
    "Data":{
        "BillingCycle":"2023-12",
        "Items":[
            {
                "ProductName":"云服务器 ECS",
                "InstanceConfig":"I/O 优化实例:I/O 优化实例;操作系统位数:64位;实例规格族:企业级实例 g6;实例规格:2核 8GB;操作系统的类型:Linux;体检服务:是;地域:乌兰察布;可用区:可用区A;CPU:2核;系统盘种类:高效云盘;镜像平台:linux;公网带宽:10240Kbps;虚拟交换机:vsw-0jlueyydpuekou6m1s1nn;网络类型:专有网络;系统盘大小:200GB;实例系列:系列 V;操作系统:centos_7_9_x64_20G_alibase_20231109.vhd;内存:8GBMB;是否是按流量计费:按使用流量;操作系统许可费用:付费;挂载点:/dev/xvdaGB;管家服务:是（管家）",
                "ProductCode":"ecs",
                "ServicePeriodUnit":"秒",
                "ServicePeriod":"54000",
                "UsageUnit":"台",
                "BillingItemCode":"InstanceType",
                "CommodityCode":"ecs",
                "Usage":"15.000000"
            }
        ]
    },
    "Code":"Success",
    "Success":true
}