View a markdown version of this page

使用您的收入归因 ID - AWS 合作伙伴中心
什么是收入归因 ID？使用您的收入归因 ID

AWS 合作伙伴中心 API 参考已重新构建。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用您的收入归因 ID

收入归因 ID 是一种交易级别标识符，可将您的AWS Marketplace 产品收入映射到特定的AWS Marketplace 优惠 and/or AWS合作伙伴中心机会。它建立在产品级合作伙伴收入测量 (PRM) 实施之上：PRM 捕获 Marketplace 产品的总归因收入，收入归因 ID 根据您指定的每月成本分配百分比将收入映射到特定交易。

收入归因服务提供了 API，用于创建、检索、列出和更新收入归因 ID，并异步管理其每月成本分配条目。

什么是收入归因 ID？

收入归因 ID 分为两层：

  • 归因是由合作伙伴命名的、由合作伙伴描述的资源，由ra-前缀 ID（例如）ra-aabbccddee001和 ARN 标识。每个归因的范围都限AWS于Catalog（用于生产、Sandbox用于测试）和合作伙伴的账户。

  • 每个@@ 条目都有一个或多个月度成本分配条目，将单个（优惠 ID 或机会 ID，账单月份）组合映射到成本分配百分比。通过分配任务模式对条目进行异步批量管理。

收入归因 ID 有两种使用方式：

  • 作为对现有产品级 PRM 实施的交易级叠加。创建收入归因 ID，关联适用的 Marketpl and/or ace 优惠 ACE 机会，并将您已经衡量的产品收入AWS映射到这些特定交易——无需更改现有资源标签或用户代理字符串。

  • 作为独立标识符，直接用作资源标签值 (aws-apn-id=<RA ID>) 或在用户代理字符串 (APN_1.1/pc_<RA ID>$) 中，从一开始就将AWS消耗归因于特定交易。

使用您的收入归因 ID

合作伙伴可以通过收入归因服务管理收入归因 ID 及其每月成本分配条目。生命周期通过两个独立的流程进行：归因记录流程（创建、更新、检索、列出）和分配流程（启动批量任务、轮询结果、检索单个条目、列出归因条目）。

创建收入归因 ID

第一步是使用 CreateRevenueAttribution API 操作创建收入归因 ID。返回的Id，Arn可以立即用作资源标签值，也可以在用户代理字符串中使用以归因消耗。AWS

在创建收入归因 ID 时，合作伙伴必须提供：

  • Catalog— AWS 用于生产或Sandbox测试。

  • Name— 一个人类可读的归因名称。在目录和合作伙伴账户中必须是唯一的。最多 128 个字符。

合作伙伴可以选择提供：

  • Description— 对归因的自由文字描述。最多 1024 个字符。

  • MarketplaceProduct— 要与此归因关联的AWS Marketplace 产品。提供ProductIdentifier（25 个字符的 Marketplace 商品编码）和TenancyModel（MULTI_TENANT或SINGLE_TENANT）。如果在创建时省略了归因，则无论客户购买了哪个 Marketplace 产品，归因都适用于以收入归因 ID 衡量的所有消费，这在单个部署跨越多个商城列表时非常有用。

  • Tags— 最多 200 个用于资源组织的键值对。标签密钥在请求中必须是唯一的。

最佳实践：MarketplaceProduct.ProductIdentifier每当您的交易锚定到特定的 Marketplace 列表时，请提供。这样可以AWS验证产品是否归呼叫合作伙伴账户或通过合作伙伴账户连接 (PAC) 关联的子公司账户所有，并在响应中显示已解决的ProductCode和ProductType（例如AMI，SaaS、、ML）。如果产品不归授权账户所有，则 API 会返回ValidationException并说明原因PRODUCT_NOT_FOUND_OR_NOT_OWNED。

响应返回新的Id（格式ra-[a-z0-9]{13}）Arn、已解析的MarketplaceProduct属性和初始Version数字（从 1 开始，在每次后续更新时递增）。

添加每月成本分配条目

创建收入归因 ID 后，合作伙伴会通过 StartRevenueAttributionAllocationsTask API 操作提交一批每月成本分配条目，从而将AWS Marketplace Offers and/or ACE 机会与其关联起来。这是一个异步操作，每个任务最多可接受 250 个分配更改 (CREATE and/or UPDATE)。

每个分配条目都指定：

  • 报价 ID 或机会 ID — 关联交易的唯一标识符。如果 Marketplace 优惠已与 ACE 机会相关联，则合作伙伴只需要提供优惠 ID；AWS自动将收入归因于关联的机会。

  • 账单月份 — 成本分配适用的日历月（例如，2026-04）。

  • 成本分配百分比 — 本账单月份产品总AWS消耗中归因于该交易的部分。适用于多租户 SaaS 产品，包括用于客户共享基础架构的混合部署的合作伙伴托管组件。

  • 客户AWS账户 ID — 消费产品的客户的AWS账户。对于多租户 SaaS 产品来说是必需的。

给定收入归因 ID 和同一账单月份的所有分配条目的总成本分配百分比不得超过 100%。如果总数超过 100%，则在异步业务验证期间，违规条目将被拒绝，并显示每条记录的错误代码。

同步验证：同步StartRevenueAttributionAllocationsTask执行基本形状验证（字段类型、模式、批次大小）。如果基本验证通过，API 将返回TaskId带状态的IN_PROGRESS。业务验证（上限检查、不可变性规则、针对 Marketplace 和 ACE 的依赖关系查询）异步运行，每条记录的结果是通过发现的。GetRevenueAttributionAllocationsTask

要监控已提交的任务，合作伙伴GetRevenueAttributionAllocationsTask可使用收入归因资源 ID 或 ARN 进行投票。响应从变IN_PROGRESS为COMPLETED（无论个别记录成功还是失败），并返回：

  • TaskStatus— IN_PROGRESS COMPLETED、或FAILED（顶级任务失败）。

  • RecordResults— 对于每条输入记录：分配的AllocationId（如果成功）、每条记录的状态（SUCCEEDED或FAILED），以及结构化错误代码和消息（如果记录失败）。

合作伙伴应及时检索任务结果。任务完成后，可以协调每条记录的结果，并且可以在新任务中更正任何失败的条目并重新提交。

编辑每月成本分配条目

按账单月份管理成本分配条目，规则如下：

  • 合作伙伴可以随时为当前或任何未来的账单月度添加新的月度条目。

  • 合作伙伴可以随时更新当前或任何未来账单月份的月度条目。

  • 合作伙伴可以在当月 7 日之前更新上个月的条目。此窗口允许合作伙伴在最终确定上个月的分配之前，在AWS Cost Explorer 中查看实际使用情况。

当月 7 日之后，无法再修改前一个账单月份的归因。当前或未来月份条目的更新将从下一个月度账单周期开始生效。不对前几个月的历史归因进行追溯性重新计算。

分配条目的更新通过相同的 StartRevenueAttributionAllocationsTask API 操作提交，每个受影响的条目均Operation设置为。UPDATE异步任务模式统一处理更新和创建。

更新收入归因 ID

合作伙伴可以使用 UpdateRevenueAttribution API 操作更新现有收入归因 ID。Description否则，归因记录本身是不可变的—— Name MarketplaceProduct、，并且创建时标记的值在创建后无法更改。要重新标记资源，请对归因的 ARN 使用标准AWS标记操作。

更新收入归因 ID 时，合作伙伴必须提供：

  • Catalog— AWS 或Sandbox。

  • Identifier— 要更新的归因的 ra- ID。

  • Version— 乐观锁定归因的当前版本。

合作伙伴可以选择提供：

  • Description— 更新的自由文本描述。最多 1024 个字符。

  • ClientToken— 更新的等性标记。

Optimistic Locking：该Version字段可确保只有在归因自上次检索以来未发生变化时才会应用更新。如果提交的内容与当前资源版本Version不匹配，则更新将被拒绝，ConflictException并显示一条包含已提交版本号和当前版本号的消息。最佳做法是在每次更新GetRevenueAttribution之前检索最新版本。

查看收入归因 ID 详情

合作伙伴可以使用 GetRevenueAttribution API 操作检索单个收入归因 ID 的完整信息。这将返回：

资源元数据：

  • 唯一标识符 (Id) 和 Amazon 资源名称 (Arn)。

  • Catalog存在归因的。

  • Name 和 Description

  • 检索到的Version和LatestVersion（使用最新版本进行后续更新）。

Marketplace 商品属性（如果MarketplaceProduct是在创建时设置的）：

  • ProductId— 合作伙伴提供的 Marketplace 产品编号。

  • ProductCode—AWS Marketplace 产品代码解析自ProductId。

  • ProductType— SaaS、AMI、Container、ML、Data、或Professional Services。

  • TenancyModel— MULTI_TENANT 或SINGLE_TENANT。

审计信息：

  • CreatedDate 和 LastModifiedDate

合作伙伴可以选择在请求Version中提供具体信息，以检索归因的历史版本。省略Version返回最新版本。

要检索特定的每月成本分配条目，合作伙伴可使用带有该条目的 GetRevenueAttributionAllocation API操作AllocationId。这将返回报价 ID 或机会 ID、账单月份、成本分配百分比、客户AWS账户 ID 以及条目的状态和审计信息。

列出收入归因 ID

合作伙伴可以使用 ListRevenueAttributions API 操作查看其账户中的所有收入归因 ID。这将返回具有筛选和排序功能的归因摘要分页列表。

合作伙伴可以按以下条件筛选结果：

  • Catalog— AWS 或Sandbox（必填）。

  • Identifiers— 最多可检索 100 个特定 ra- ID 的列表。

  • CreatedAfter/CreatedBefore— 按创建时间戳范围（含）筛选。

合作伙伴可以使用以下Sort参数配置结果排序：

  • SortBy— CreatedDate 或LastModifiedDate。

  • SortOrder— ASCENDING 或DESCENDING。

响应包括每个归因的摘要：Arn、Id、Catalog、Name、已解决的MarketplaceProduct属性CreatedDateLastModifiedDate、、、Version、最新和TotalRevenueAttributionAssociationCount（与归因关联的每月有效成本分配条目数量）。

使用MaxResults（默认 25，最大 100）和NextToken对大型结果集进行分页。NextToken如果有其他页面可用，则响应中包含一个。

列出每月成本分配条目

合作伙伴可以使用 ListRevenueAttributionAllocations API 操作列出特定收入归因 ID 的每月成本分配条目。这将返回具有筛选功能的分配摘要的分页列表。

合作伙伴可以按以下条件筛选结果：

  • MarketplaceOfferId— 仅列出与特定 Marketplace 优惠相关的条目。

  • AwsPartnerCentralOpportunityId— 仅列出与特定合作伙伴中心机会相关的条目。

  • BillingMonth— 仅列出特定日历月的条目。

响应包括每个条目的摘要信息：AllocationId、关联的报价 ID 或机会 ID、客户AWS账户 ID、账单月份、成本分配百分比、条目的名称和状态以及审计时间戳。

控制面板构建：ListRevenueAttributions和的组合ListRevenueAttributionAllocations旨在支持合作伙伴控制面板的创建。合作伙伴可以建立视图，例如：

  • 过去 30 天内创建的所有收入归因 ID，按创建日期排序。

  • 跨多个收入归因 ID 的某个 Marketplace 优惠的所有月度成本分配条目。

  • 当前账单月份的所有成本分配条目，以验证每次归因的总费用不超过 100%。

  • 至少有一个有效分配条目的所有收入归因 ID (TotalRevenueAttributionAssociationCount > 0)。