aws-sdk-marketplacemetering

本参考提供了AWS Marketplace Metering服务API的低级别API描述。

AWS Marketplace卖家可以使用此API提交自定义使用维度的使用数据。

有关使用此API所需的权限信息，请参阅《AWS Marketplace卖家指南》中的AWS Marketplace计量和授权API权限。

提交计量记录

• MeterUsage - 提交AWS Marketplace产品的计量记录。MeterUsage在EC2实例或运行在EKS或ECS上的容器中调用。
• BatchMeterUsage - 提交一组客户的计量记录。BatchMeterUsage在软件即服务（SaaS）应用程序中调用。

接受新客户

• ResolveCustomer - 在注册过程中由SaaS应用程序调用。当买家在注册过程中访问您的网站时，买家通过浏览器提交注册令牌。通过此API解析注册令牌以获取CustomerIdentifier、CustomerAWSAccountId和ProductCode。

付费容器产品的授权和计量

• 通过AWS Marketplace销售的付费容器软件产品必须与AWS Marketplace Metering服务集成，并调用RegisterUsage操作进行软件授权和计量。对于Amazon ECS或Amazon EKS的免费和BYOL产品不需要调用RegisterUsage，但您可以这样做，以便在您的卖家报告中接收使用数据。有关使用RegisterUsage操作的更多信息，请参阅基于容器的产品。

BatchMeterUsage API 调用由 AWS CloudTrail 记录。您可以使用 CloudTrail 通过搜索具有 eventName 为 BatchMeterUsage 的记录来验证您发送的 SaaS 计费记录是否准确。您还可以使用 CloudTrail 对记录进行时间审计。有关更多信息，请参阅 _ AWS CloudTrail 用户指南._

入门

许多服务和操作的示例可用，请参阅 GitHub 中的示例文件夹。

SDK 为每个 AWS 服务提供一个 crate。您必须在 Rust 项目中添加 Tokio 作为依赖项以执行异步代码。要将 aws-sdk-marketplacemetering 添加到您的项目，请将以下内容添加到您的 Cargo.toml 文件中

[dependencies]
aws-config = { version = "1.1.7", features = ["behavior-version-latest"] }
aws-sdk-marketplacemetering = "1.39.0"
tokio = { version = "1", features = ["full"] }

然后在代码中，可以使用以下方式创建客户端

use aws_sdk_marketplacemetering as marketplacemetering;

#[::tokio::main]
async fn main() -> Result<(), marketplacemetering::Error> {
    let config = aws_config::load_from_env().await;
    let client = aws_sdk_marketplacemetering::Client::new(&config);

    // ... make some calls with the client

    Ok(())
}

有关可进行的调用、每个调用的输入和输出的信息，请参阅 客户端文档。

使用 SDK

在 SDK 发布之前，我们将向 开发者指南 中添加有关使用 SDK 的信息。请随时通过提交问题并描述您要执行的操作来提出指南的额外部分建议。

获取帮助

• GitHub 讨论区 - 用于想法、RFC 和一般问题
• GitHub 问题 - 用于错误报告和功能请求
• 生成的文档（最新版本）
• 使用示例

许可协议

本项目采用 Apache-2.0 许可协议。