SuperAPI AI 工具集

aws-marketplace-metering

部署与运维

查看项目

更新于 10-15 12:21

技能介绍

AWS Marketplace Metering 技能用于管理 AWS Marketplace 按用量计费(SaaS PAYG)的完整生命周期,覆盖部署、查询与调试三个环节。

用途

该技能面向 SaaS 按用量计费场景:一是 Setup,部署新的无服务器计量集成(SAM、ResolveCustomer、BatchMeterUsage、EventBridge);二是 Query,查找、检查、调试和分析已有的计量提交记录,可使用 CloudTrail 事件历史(最多 90 天)或 Seller Reports 查看已计费历史。技能范围仅限 SaaS Usage-based(PAYG);SaaS Contract、Contract with Consumption Pricing(CCP)以及 AMI/Container 计量均不在范围内,需转向公开 AWS 文档。

主要能力

技能提供打包的 scripts/、assets/、references/ 资源,展示如何组织计量栈,作为参考而非可直接复制的成品。它可生成 CloudFormation/SAM 模板、Lambda 处理器、IAM 策略和 deploy.sh 等,并部署到卖家的 AWS 账户。计量管道涉及 ResolveCustomer 解析买家身份、BatchMeterUsage 提交用量、EventBridge 处理订阅事件,以及聚合、去重、重试和告警等机制。

使用方式

技能由 AI 代理执行,推荐配合 AWS MCP 服务器以获得沙箱化执行和审计日志。使用前需先判断技能加载方式:若通过 AWS MCP retrieve_skill 加载,技能不在本地文件系统,需用 retrieve_skill 的 file 参数逐个获取参考或脚本;若本地安装,则通过相对路径读取或运行。所有卖家特定值(产品代码、区域、阶段名、VMT 标签、告警动作/阈值、保留/KMS 等)需从卖家获取并填入 TODO 标记;未知值应询问而非假设。不得更改架构或 awsmp-* 命名,卖家只能自定义标记的 TODO 部分。

适用场景

适用于需要为 SaaS 产品搭建或维护按用量计费管道的 AWS Marketplace 卖家,包括新集成部署、已有提交的排查与调试、用量记录被拒原因分析、CloudTrail 查询等。

限制与注意事项

技能为 AI 生成输出,可能出错,所有生成物和部署到卖家账户的内容都必须视为待审查提案,而非可信成品。在承载生产计量流量前,卖家必须彻底审查每个资源(模板、Lambda 代码、IAM 角色/策略、表/索引、队列、告警),确认符合意图和组织标准;必须经过正常代码审查和变更管理流程;必须端到端运行完整测试计划(references/test-plan.md)并验证每个预期可观察结果。计量错误直接影响收入(少计费或多计费),因此审查不可省略。技能不得暗示部署成功即代表生产就绪。

其他关键事实包括:新(Concurrent Agreements)产品每条 UsageRecord 需 CustomerAWSAccountId(非 CustomerIdentifier)加 LicenseArn;订阅事件使用 EventBridge(非 SNS),且仅在 us-east-1 发出;ResolveCustomer 从 x-amzn-marketplace-token 解析买家 LicenseArn、customerAWSAccountId 和 productCode,该 token 在约 4 小时内可重复使用,过期返回 ExpiredTokenException;BatchMeterUsage 为区域 API,但区域由卖家选择,无 InvalidEndpointRegionException,去重按区域进行;时间戳窗口为 24 小时,超过则被拒(客户端 MalformedTimestamp,服务端 TimestampOutOfBoundsException),仅月末边界有 6 小时宽限;当前进行中的小时不会在正常路径计量;BatchMeterUsage 限制为 ≤25 条 UsageRecords 且 ≤1 MB 请求负载;VMT 标签上限为每条 UsageRecord 5 个 usageAllocations 标签,超出触发 TooManyTags;VMT 按组全有或全无,不得混用已分配和未分配的非零行;DuplicateRecord 为首写胜出且会被报告,不同数量的重提交不会被计费;CustomerNotSubscribed 为真实失败,不应重试;无效 LicenseArn 是请求级 InvalidLicenseException,会使整批失败,需客户端形状校验和二分隔离;未定义维度触发请求级 InvalidUsageDimensionException,需二分隔离并标记 RejectedClientSide;UnprocessedRecords 是部分批次结果,可安全重提交,提交器会重试一次,失败则留待下次计划运行;CloudTrail 为区域服务,约 15 分钟延迟,保留 90 天;建议在用量生成后约 1 小时内提交,接近 24 小时边界重试余量越小,超过则永久丢失;超龄为终态并清除 pending 标记,触发 UsageAggregationExpired / UsageSubmissionExpired 告警。

以上内容均来自技能资料,未提供的功能、收费、价格、平台或效果信息暂未提供。