对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 [AWS 合作伙伴中心 API 参考](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)。

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

# 处理您的商城收入份额
<a name="working-with-marketplace-revenue-share"></a>

商城收入份额是 AWS 商城产品的输入，用于申报通过商 AWS 城收取的产品总收入的一部分。 AWS 使用此输入将合作伙伴的 Marketplace-collected 收入与其他收入信号关联起来。

商城收入分成服务提供 API，用于创建、检索和列出商城收入分成资源，并管理其分配（合作伙伴申报的收入分成百分比和生效日期窗口）。商城收入分成资源支持标准 AWS 标记操作。

## 什么是市场收入分成？
<a name="what-is-a-marketplace-revenue-share"></a>

商城收入份额分为两层：
+ **份额 ** — 单一 AWS 商城产品的输入，由商城识别`ProductId`。每种产品只有一个市场收入份额。
+ **一次或多次分配 ** — 每个分配都声明一个`RevenueSharePercent`和一个生效日期窗口（`EffectiveDate`可选`ExpirationDate`）。随着时间的推移，一股可以进行多次分配，但任何时候都只能进行一次`ACTIVE`分配。

分配具有以下关键属性：
+ **状态 ** — `ACTIVE` 或`INACTIVE`. 创建时，状态默认为`ACTIVE`。只有`ACTIVE`分配参与收入计算和重叠检查。
+ **重叠不变 ** ——在一份股票内，任何两个`ACTIVE`分配的范围都不得重叠`[EffectiveDate, ExpirationDate]`。任何时候每股最多允许进行一次无限期分`ACTIVE`配（否`ExpirationDate`）。

## 处理您的商城收入份额
<a name="managing-marketplace-revenue-shares"></a>

合作伙伴通过商城收益分成服务管理商城收入份额及其分配。生命周期分为两个流程：共享流程（创建、检索、列出、标记）和分配流程（创建、更新、软删除、检索、列出）。

### 创建商城收入份额
<a name="creating-a-marketplace-revenue-share"></a>

第一步是使用 `CreateMarketplaceRevenueShare` API 操作为商 AWS 城产品创建商城收入份额。该份额由市场识别`ProductId`，用作所有后续分配的容器。

创建商城收入份额时，合作伙伴必须提供：
+ **`Catalog`**— `AWS` 用于生产或`Sandbox`测试。
+ **`ProductId`**— 25 个字符的商城产品 ID。图案：`[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}`）、、的`Catalog`、初始`Version`数字（从 1 开始，每次分配突变时递增）以及创建时应用的所有标签。`ProductId`

### 添加分配
<a name="adding-marketplace-revenue-share-allocations"></a>

创建商城收入份额后，合作伙伴通过API操作创建分配，申报收入分成百分比和生效日期窗口。`CreateMarketplaceRevenueShareAllocation`

创建分配时，合作伙伴必须提供：
+ **`Catalog`**— `AWS` 或`Sandbox`。
+ **`MarketplaceRevenueShareIdentifier`**— 母股的标识符。
+ **`RevenueSharePercent`**— 通过商城收集的产品收入的百分比，以十进制表示（`0.45`例如，45%）。
+ **`EffectiveDate`**— 此分配生效的日历日期。格式：`YYYY-MM-DD`。

响应返回分配的`Id`（格式`mrsa-[A-Za-z0-9]{13}`）、分配状态（创建时）和母股的`ACTIVE`上涨情况`Version`（每次分配突变都会增加每股的单一版本整数，用于对后续分配更新进行乐观锁定）。

### 更新分配
<a name="updating-marketplace-revenue-share-allocations"></a>

合作伙伴可以使用 `UpdateMarketplaceRevenueShareAllocation` API 操作更新分配。可更新的字段取决于分配是未来的、当前有效的，还是过去的。

更新分配时，合作伙伴必须提供：
+ **`Catalog`**— `AWS` 或`Sandbox`。
+ **`MarketplaceRevenueShareIdentifier`**— 母股的标识符。
+ **`AllocationId`**— 要更新的分配的 `mrsa-` ID。
+ **`MarketplaceRevenueShareVersion`**— 母公司股票的当前版本，用于乐观地锁定分配。碰撞冲突卷土重来`ConflictException`。

合作伙伴可以选择提供：
+ **`RevenueSharePercent`**— 更新的收入分成百分比。仅对未来配额进行编辑。
+ **`EffectiveDate`**— 更新的生效日期。仅对未来配额进行编辑。
+ **`ExpirationDate`**— 更新的到期日期。可编辑未来分配（任何值`> EffectiveDate`）以及当前有效的或无限期的分配（任何值）。`≥ today`
+ **`Status`**— `ACTIVE` 或`INACTIVE`。设置为`INACTIVE`软删除分配。仅对未来配额进行编辑。
+ **`ClientToken`**— 一种等性标记。

### 查看商城收入份额详情
<a name="viewing-marketplace-revenue-share-details"></a>

合作伙伴可以使用 `GetMarketplaceRevenueShare` API 操作检索单个商城收入份额的完整信息。这将返回共享的`Arn`、`Catalog`、`ProductId`、`Version`（父共享的当前版本）`CreatedDate`、`LastModifiedDate`、以及应用于共享的所有标签。

合作伙伴可以使用带有分配`GetMarketplaceRevenueShareAllocation`的 API 操作来检索单个分配`Id`。这将返回：
+ 配额`Id`和母公司股份`MarketplaceRevenueShareArn`。
+ `RevenueSharePercent`, `EffectiveDate`, `ExpirationDate`.
+ `Status`（`ACTIVE`或`INACTIVE`）。
+ 母公司股票`MarketplaceRevenueShareVersion`用于乐观地锁定后续更新。
+ `CreatedDate` 和 `LastModifiedDate`

### 上市市场收入份额
<a name="listing-marketplace-revenue-shares"></a>

合作伙伴可以使用 `ListMarketplaceRevenueShares` API 操作查看其账户拥有的所有商城收入份额。这将返回共享摘要的分页列表。

合作伙伴可以按以下条件筛选结果：
+ **`Catalog`**— `AWS` 或`Sandbox`（必填）。
+ **`ProductIds`**— 要检索的特定商城产品 ID 的列表。

回应包括每股的摘要：`Arn``Catalog`、`ProductId`、、最新`Version``CreatedDate`、和`LastModifiedDate`。

使用`MaxResults`和`NextToken`对大型结果集进行分页。

### 清单分配
<a name="listing-marketplace-revenue-share-allocations"></a>

合作伙伴可以使用 `ListMarketplaceRevenueShareAllocations` API 操作列出特定商城收入份额的分配。这将返回具有筛选功能的分配摘要的分页列表。

合作伙伴可以按以下条件筛选结果：
+ **`Status`**— `ACTIVE` 或`INACTIVE`。
+ **生效日期范围 ** —`EffectiveDateOnOrAfter`/`EffectiveDateOnOrBefore`用于检索生效日期在特定窗口内的分配。

响应包括每次分配的摘要信息：`Id`、`RevenueSharePercent`、`EffectiveDate`、`ExpirationDate`、`Status``MarketplaceRevenueShareVersion`、和审计时间戳。

## 标记市场收入份额
<a name="tagging-marketplace-revenue-shares"></a>

商城收入分成资源支持标准 AWS 标记操作：
+ **`TagResource`**— 在商城收入份额上添加或覆盖标签。每份最多 50 个标签。
+ **`UntagResource`**— 按键删除特定标签。
+ **`ListTagsForResource`**— 检索当前应用于商城收入份额的所有标签。

分配不支持标签。标记母股以组织相关分配。

每个标记操作都接受共享`Arn`（格式`arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}`）作为资源标识符。还通过 AWS on 字段支持标准的创建时标记。`Tags` `CreateMarketplaceRevenueShare`