使用 AWS Marketplace Metering Service 对容器产品配置自定义计量

AWS Marketplace 容器产品可以对每种产品多达 24 种不同的定价维度进行自定义计量。每个维度都可以具有与之相关的长期合同价格。要启用自定义计量，请将您的容器产品与 AWS Marketplace Metering Service 集成。您可以使用 MeterUsage API 操作为该用量定义自己的定价单位和自定义计量以便 AWS 进行计费。以下部分将介绍如何为容器产品配置自定义计量。

价格维度在两个位置定义，一次是在产品加载表单中，一次是通过 MeterUsage API 操作。此双因素方法可确保后续的产品在向公众提供之前按预期工作。

要设置自定义计量，您需要选择使用类别、单位类型和定价维度：

或者，您可以按您跟踪的属性将用量分发到分配中。分配以标签形式呈现给买家。这些标签允许买家按标签值查看按用量划分的费用。例如，如果您按用户收费，并且用户具有“部门”属性，则可以使用键为“部门”的标签创建使用分配，每个值一个分配。这不会更改您报告的价格、维度或总用量，但允许您的客户按与您的产品相应类别查看其成本。

我们建议您每小时发送一次计量记录。但是，您也可以汇总每日或每月的用量。如果您遇到中断，您可以聚合买家的软件用量，并在接下来的小时计量中发送。每小时不能发送多条记录。

自定义计量先决条件

发布产品之前，您必须首先完成以下操作：

自定义计量的产品加载表单

填写产品加载表单进行自定义计量时，每种产品最多可以有 24 个维度。维度在以下字段中定义：

测试 MeterUsage 集成和预览模式

在将映像提交到 AWS Marketplace 以进行发布之前，您可以使用 MeterUsage 操作测试您的集成。

预览模式的运行方式与生产模式完全相同，但预览模式不验证对您的产品的使用权。要在预览模式下调用 MeterUsage，请使用您用于在 AWS Marketplace 上列出产品的 AWS 账户在 Amazon Elastic Container Service (Amazon ECS) 或 Amazon Elastic Kubernetes Service (Amazon EKS) 上运行您的产品，从而从容器映像中调用 MeterUsage。您的计量集成必须动态设置 AWS 区域，而不是对其进行硬编码。但是，在测试时，请至少在美国东部（弗吉尼亚州北部）区域启动一个包含您的付费容器的 Amazon ECS 任务或 Amazon EKS 容器组 (pod)，以便 AWS Marketplace 运营团队可以使用该区域的日志验证您的工作。

在使用所有必需的元数据和定价信息发布您的产品之前，您无法完全测试集成。根据请求，AWS Marketplace 目录运营团队可以验证在预览模式下收到的计量记录。

MeterUsage 中的错误处理

如果您的容器映像与 MeterUsage 操作集成并在容器启动时收到 ThrottlingException 之外的异常，您应终止容器以防止未经授权的使用。

仅在初始调用 MeterUsage 时引发 ThrottlingException 以外的异常。从同一 Amazon ECS 任务或 Amazon EKS 容器组 (pod) 进行的后续调用不会引发 CustomerNotSubscribedException，即使客户在任务或 容器组 (pod) 仍在运行时取消订阅也是如此。这些客户在取消订阅并跟踪其使用情况后仍需支付运行容器的费用。

有关 MeterUsage 常见错误的详细描述，请参阅《AWS Marketplace Metering Service API 参考》中的 MeterUsage。每个 AWS SDK 编程语言都有一组错误处理准则，您可以参阅它们来了解其他信息。

供应商计量标记（可选）

供应商计量标记可帮助独立软件供应商 (ISV) 让买家更精细地了解其软件使用情况并帮助他们进行成本分配。

有许多方法可以标记买家的软件使用情况。一种方法是先询问买家他们希望在成本分配中看到什么。然后，您可以在为买家帐户跟踪的属性之间分配使用情况。属性的示例包括 AccountId、Business Unit、Cost Centers，以及您的产品的其他相关元数据。这些属性作为标签展示给买家。使用标签，买家可以在 AWS Billing 控制台 (https://console.aws.amazon.com/billing/) 中按标签值查看用量成本。供应商计量标记不会更改您报告的价格、维度或总用量。它允许您的客户按您产品的相应类别查看成本。

在常见情形中，买家会通过一个 AWS 账户订阅您的产品。买家还有许多与同一产品订阅相关的用户。您可以使用具有 AccountId 键的标签创建用量分配，然后将用量分配给每个用户。在这种情况下，买家可以在其账单与成本管理控制台中激活 AccountId 标签并分析个人用户的使用情况。

卖家体验

卖家可以汇总具有相同标签集的资源的计量记录，而不是汇总所有资源的使用情况。例如，卖家可以构造包含不同的 UsageAllocations 存储桶的计量记录。每个存储桶代表一组标签的 UsageQuantity，例如 AccountId 和 BusinessUnit。

在下图中，资源 1 具有一组唯一的 AccountId 和 BusinessUnit 标签，并作为单个条目出现在计量记录中。

资源 2 和资源 3 都具有相同的 AccountId 标签 2222 和相同的 BusinessUnit 标签 Operations。因此，它们在计量记录中合并为一个 UsageAllocations 条目。

卖家还可以将没有标签的资源组合成一个包含分配用量的 UsageAllocation，然后将其作为 UsageAllocations 中的一个条目发送。

限制包括：

验证包括：

买家体验

下表显示了买家激活 AccountId 和 BusinessUnit 供应商标签后的买家体验示例。

在此示例中，买家可以在其成本使用报告中看到分配的用量。供应商计量标签使用前缀 “aws:marketplace:isv”。在账单与成本管理中，买家可以再成本分配标签下的 AWS 生成的成本分配标签中激活它们。

成本使用报告的第一行和最后一行与卖家向 Metering Service 发送的内容相关（如 卖家体验 示例所示）。

有关代码示例，请参阅 带有用量分配标签的 MeterUsage 代码示例（可选）。

代码示例

提供了以下代码示例来帮助您将容器产品与发布和维护产品所需的 AWS Marketplace API 集成。

带有用量分配标签的 MeterUsage 代码示例（可选）

以下代码示例与具有消费定价模式的容器产品相关。Python 示例向 AWS Marketplace 发送具有相应用量分配标签的计量记录，以便向客户收取即用即付费用。

# NOTE: Your application will need to aggregate usage for the 
#       customer for the hour and set the quantity as seen below. 
#       AWS Marketplace can only accept records for up to an hour in the past. 
#
# productCode is supplied after the AWS Marketplace Ops team has 
# published the product to limited

# Import AWS Python SDK
import boto3
import time

usageRecord = [
    { 
        "AllocatedUsageQuantity": 2, 
        "Tags": 
            [ 
                { "Key": "BusinessUnit", "Value": "IT" },
                { "Key": "AccountId", "Value": "123456789" },
            ]

    },
    { 
        "AllocatedUsageQuantity": 1, 
        "Tags": 
            [ 
                { "Key": "BusinessUnit", "Value": "Finance" },
                { "Key": "AccountId", "Value": "987654321" },
            ]

    }
]

marketplaceClient = boto3.client("meteringmarketplace")

response = marketplaceClient.meter_usage(
    ProductCode="testProduct",
    Timestamp=int(time.time()),
    UsageDimension="Dimension1",
    UsageQuantity=3,
    DryRun=False,
    UsageAllocations=usageRecord 
)

有关 MeterUsage 的更多信息，请参阅《AWS Marketplace Metering Service API 参考》中的 MeterUsage。

响应示例

{ "MeteringRecordId": "string" }