AWS 合作伙伴中心 API 参考已重新构建。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
处理你的 Marketplace 收入份额
Marketplace 收入份额是AWS Marketplace 产品的输入，它申报了通过 M AWS arketplace 收取的产品总收入的部分。AWS使用此输入将合作伙伴的 Marketplace-collected 收入与其他收入信号关联起来。
Marketplace 收入共享服务提供了 API，用于创建、检索和列出 Marketplace 收入分成资源并管理其分配（合作伙伴申报的收入分成百分比和生效日期窗口）。Marketplace 收入共享资源支持标准AWS标签操作。
什么是 Marketplace 收入分成？
Marketplace 收入份额有两个层次：
-
份额 — 单个AWS Marketplace 产品的输入，由 Marketplace 标识
ProductId。每种产品只有一个 Marketplace 收入份额。 -
一个或多个分配 — 每个分配都声明一个
RevenueSharePercent和一个有效日期窗口（EffectiveDate可选ExpirationDate）。随着时间的推移，一个股票可以有多个分配，但任何时候都只能适用一种ACTIVE分配。
分配具有以下关键属性：
-
状态 —
ACTIVE或INACTIVE。创建时，状态默认为ACTIVE。只有ACTIVE分配参与收入计算和重叠检查。 -
重叠不变 — 在单个份额内，任何两个
ACTIVE分配的范围都不能重叠[EffectiveDate, ExpirationDate]。任何时候每股最多允许一次无限期ACTIVE配股（否ExpirationDate）。
处理你的 Marketplace 收入份额
合作伙伴通过 Marketplace 收入分成服务管理 Marketplace 收入份额及其分配。生命周期通过两个流程进行：共享流程（创建、检索、列出、标记）和分配流程（创建、更新、软删除、检索、列出）。
创建 Marketplace 收入分成
第一步是使用 CreateMarketplaceRevenueShare API 操作为 Marketplace 产品创建AWS Marketplace 收入分成。该份额由 Marketplace 标识，ProductId并作为所有后续分配的容器。
在创建 Marketplace 收入分成时，合作伙伴必须提供：
-
Catalog—AWS用于生产或Sandbox测试。 -
ProductId— 25 个字符的 Marketplace 商品编码。图案：[a-z0-9]{25}。
合作伙伴可以选择提供：
-
Tags— 创建时资源组织最多 50 个键值对。用于TagResource在创建后添加标签。 -
ClientToken— 一种等性标记，用于防止在重试时重复创建。最多 64 个字符。SDK 会自动生成此令牌。
产品验证：创建后，该服务会向AWS Marketplace 验证产品是否归来电者的账户或通过合作伙伴账户连接 (PAC) 与来电者关联的子账户所有。如果产品不存在或调用者未授权拥有账户，则 API 会返回ValidationException并说明原因PRODUCT_NOT_FOUND_OR_NOT_OWNED。
每种产品一股：第二次CreateMarketplaceRevenueShare要求ProductId在相同的Catalog回报中获得相同的股份ConflictException。
响应返回共享的Arn（格式arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}）、、、初始Version数字（从 1 开始，每次分配突变时递增）以及创建时应用的所有标签。Catalog ProductId
添加分配
创建 Marketplace 收入份额后，合作伙伴会通过 API 操作创建分配，从而申报收入分成百分比和生效日期窗口。CreateMarketplaceRevenueShareAllocation
创建分配时，合作伙伴必须提供：
-
Catalog—AWS或Sandbox。 -
MarketplaceRevenueShareIdentifier— 父共享的标识符。 -
RevenueSharePercent— 通过Marketplace收集的产品收入的百分比，以十进制形式提供（0.45例如，45％）。 -
EffectiveDate— 此分配生效的日历日期。格式：YYYY-MM-DD。
响应返回分配的Id（格式mrsa-[A-Za-z0-9]{13}）、分配状态（ACTIVE创建时）和父份额的增量Version（每次分配突变都会增加每股一个版本整数，用于对后续分配更新进行乐观锁定）。
更新分配
合作伙伴可以使用 UpdateMarketplaceRevenueShareAllocation API 操作更新分配。可更新的字段取决于分配是未来日期、当前有效还是过期。
更新分配时，合作伙伴必须提供：
-
Catalog—AWS或Sandbox。 -
MarketplaceRevenueShareIdentifier— 父共享的标识符。 -
AllocationId— 要更新的分配的mrsa-ID。 -
MarketplaceRevenueShareVersion— 当前版本的母股，用于乐观锁定分配。碰撞冲突又回ConflictException来了。
合作伙伴可以选择提供：
-
RevenueSharePercent— 更新的收入分成百分比。仅在未来分配时可编辑。 -
EffectiveDate— 更新的生效日期。仅在未来分配时可编辑。 -
ExpirationDate— 更新的到期日期。在远期分配（任何值> EffectiveDate）和当前有效或开放式分配（任何值）上均可编辑。≥ today -
Status—ACTIVE或INACTIVE。设置为INACTIVE软删除分配。仅在未来分配时可编辑。 -
ClientToken— 一个等性代币。
查看 Marketplace 收入分享详情
合作伙伴可以使用 GetMarketplaceRevenueShare API 操作检索单个 Marketplace 收入份额的完整信息。这将返回共享的Arn、Catalog、ProductId、Version（父共享的当前版本）CreatedDate、LastModifiedDate、以及应用于共享的所有标签。
合作伙伴可以使用 GetMarketplaceRevenueShareAllocation API 操作和分配来检索单个分配Id。这将返回：
-
配额
Id和母股MarketplaceRevenueShareArn。 -
RevenueSharePercent,EffectiveDate,ExpirationDate. -
Status（ACTIVE或INACTIVE）。 -
父共享
MarketplaceRevenueShareVersion用于乐观锁定后续更新。 -
CreatedDate和LastModifiedDate
列出市场收入份额
合作伙伴可以使用 ListMarketplaceRevenueShares API 操作查看其账户拥有的所有 Marketplace 收入份额。这将返回分页的分享摘要列表。
合作伙伴可以按以下条件筛选结果：
-
Catalog—AWS或Sandbox（必填）。 -
ProductIds— 要检索的特定 Marketplace 商品编号的列表。
响应包括每份共享的摘要：ArnCatalog、ProductId、、最新的VersionCreatedDate、和LastModifiedDate。
使用MaxResults和NextToken对大型结果集进行分页。
列出分配
合作伙伴可以使用 ListMarketplaceRevenueShareAllocations API 操作列出特定 Marketplace 收入份额的分配。这将返回具有筛选功能的分配摘要的分页列表。
合作伙伴可以按以下条件筛选结果：
-
Status—ACTIVE或INACTIVE。 -
有效日期范围 —
EffectiveDateOnOrAfter/EffectiveDateOnOrBefore用于检索有效日期在特定窗口内的分配。
响应包括每个分配的摘要信息：Id、RevenueSharePercent、EffectiveDate、ExpirationDate、StatusMarketplaceRevenueShareVersion、和审计时间戳。
标记 Marketplace 收入份额
Marketplace 收入共享资源支持标准AWS标签操作：
-
TagResource— 在 Marketplace 收入份额上添加或覆盖标签。每次共享最多 50 个标签。 -
UntagResource— 按密钥删除特定标签。 -
ListTagsForResource— 检索当前应用于 Marketplace 收入份额的所有标签。
分配不支持标签。为父共享添加标签以组织相关分配。
每个标记操作都接受共享的Arn（格式arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}）作为资源标识符。还通过AWS字段支持标准的创建时标记。Tags CreateMarketplaceRevenueShare
