View a markdown version of this page

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

对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。

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

使用您的收入归因 ID

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

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

什么是收入归因 ID？

收入归因 ID 有两层：

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

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

收入归因 ID 可以通过两种方式使用：

  • 作为现有产品级 PRM 实施的交易级叠加层。创建收入归因 ID，关联您的适用 Marketpl and/or ace Offers 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 商城产品。提供ProductIdentifier（25 个字符的商城商品编码）和TenancyModel（MULTI_TENANT或SINGLE_TENANT）。如果在创建时省略，则归因适用于在收入归因ID下衡量的所有消费，无论客户购买了哪种Marketplace产品，这在单次部署跨越多个商城列表时很有用。

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

最佳实践：MarketplaceProduct.ProductIdentifier每当您的交易锚定到特定的商城列表时都要提供。这样可以验证产品是否 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 商城提供的 and/or ACE机会关联到该ID。这是一项异步操作，每个任务最多接受 250 次分配更改 (CREATE and/or UPDATE)。

每个分配条目都指定：

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

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

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

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

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

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

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

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

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

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

编辑每月成本分配条目

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

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

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

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

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

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

更新收入归因 ID

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

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

  • Catalog— AWS 或Sandbox。

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

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

合作伙伴可以选择提供：

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

  • ClientToken— 用于更新的等效性标记。

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

查看收入归因 ID 详情

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

资源元数据：

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

  • 归因所Catalog在。

  • Name 和 Description

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

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

  • ProductId— 合作伙伴提供的商城产品 ID。

  • ProductCode— 解析自的 AWS 商城产品代码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。

回应包括每个归因的摘要：ArnId、Catalog、Name、、已解决的MarketplaceProduct属性CreatedDateLastModifiedDate、、Version、最新和TotalRevenueAttributionAssociationCount（与归因相关的每月活跃成本分配条目数量）。

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

列出每月成本分配条目

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

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

  • MarketplaceOfferId— 仅列出与特定商城报价相关的条目。

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

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

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

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

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

  • 跨多个收入归因ID的特定商城报价的所有月度费用分配条目。

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

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