AWS パートナーセントラル API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、 [AWS パートナーセントラル API リファレンス](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Marketplace 収益共有の使用
Marketplace 収益共有は、AWS Marketplace を通じて収集された製品の総収益の一部を宣言するAWS Marketplace 製品の入力です。 はこの入力AWSを使用して、パートナーの Marketplace で収集された収益を他の収益シグナルと関連付けます。
Marketplace Revenue Share Service は、 Marketplace Revenue Share リソースを作成、取得、一覧表示し、その割り当て (パートナーが宣言した収益共有の割合と発効日ウィンドウ) を管理する APIs を公開します。標準のAWSタグ付けオペレーションは、 Marketplace Revenue Share リソースでサポートされています。
## Marketplace 収益配分とは
Marketplace 収益共有には 2 つのレイヤーがあります。
+ **共有** — Marketplace によって識別される単一の Marketplace 製品の入力AWS`ProductId`。製品ごとに Marketplace 収益配分が 1 つだけあります。
+ **1 つ以上の割り当て** — 各割り当ては、 `RevenueSharePercent`と有効日ウィンドウ (`EffectiveDate`、オプションで ) を宣言します`ExpirationDate`。共有は時間の経過とともに多くの割り当てを持つことができますが、いつでも適用できる`ACTIVE`割り当ては 1 つだけです。
割り当てには、次のキープロパティがあります。
+ **ステータス** — `ACTIVE`または `INACTIVE`。作成時、ステータスはデフォルトで になります`ACTIVE`。`ACTIVE` 配分のみが収益計算と重複チェックに参加します。
+ **重複不変** — 1 つの共有内では、2 つの`ACTIVE`割り当てが重複`[EffectiveDate, ExpirationDate]`範囲を持つことはできません。共有ごとにいつでも最大 1 つのオープンエンド`ACTIVE`割り当て ( なし`ExpirationDate`) が許可されます。
## Marketplace 収益共有の使用
パートナーは、 Marketplace Revenue Share Service を通じて Marketplace Revenue Shares とその割り当てを管理します。ライフサイクルは、共有フロー (作成、取得、リスト、タグ) と割り当てフロー (作成、更新、ソフト削除、取得、リスト) の 2 つのフローを通じて進行します。
### Marketplace 収益共有の作成
最初のステップでは、 `CreateMarketplaceRevenueShare` API アクションを使用して Marketplace 製品のAWS Marketplace 収益共有を作成します。共有は Marketplace によって識別`ProductId`され、後続のすべての割り当てのコンテナとして機能します。
Marketplace 収益共有を作成する場合、パートナーは以下を提供する必要があります。
+ **`Catalog`** — 本番`AWS`稼働用またはテスト`Sandbox`用。
+ **`ProductId`** — 25 文字の Marketplace 製品 ID。パターン: `[a-z0-9]{25}`。
パートナーはオプションで以下を提供できます。
+ **`Tags`** — 作成時にリソース組織に対して最大 50 個のキーと値のペア。を使用して`TagResource`、作成後にタグを追加します。
+ **`ClientToken`** — 再試行時の重複作成を防ぐためのべき等性トークン。最大 64 文字。SDKsトークンを自動生成します。
製品検証: 作成時に、サービスは、製品が発信者のアカウント、または Partner Account Connection (PAC) を介して発信者に接続された子会社アカウントによって所有されていることをAWS Marketplace で検証します。製品が存在しないか、所有アカウントが発信者に対して承認されていない場合、API は理由 `ValidationException`で を返します`PRODUCT_NOT_FOUND_OR_NOT_OWNED`。
製品ごとに 1 つの共有: 同じ `ProductId` の 2 回目の`CreateMarketplaceRevenueShare`呼び出しは `Catalog`を返します`ConflictException`。
レスポンスは、共有 `Arn` (形式 `arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}`)、`Catalog`、、`ProductId`初期`Version`数 (各割り当てミューテーションで 1 から始まり、増分）、および作成時に適用されるタグを返します。
### 割り当ての追加
Marketplace 収益共有が作成されると、パートナーは `CreateMarketplaceRevenueShareAllocation` API アクションを使用して配分を作成して収益共有の割合と有効日ウィンドウを宣言します。
割り当てを作成する場合、パートナーは以下を提供する必要があります。
+ **`Catalog`** — `AWS`または `Sandbox`。
+ **`MarketplaceRevenueShareIdentifier`** — 親共有の識別子。
+ **`RevenueSharePercent`** — 10 進数で提供される Marketplace を通じて収集された製品の収益の割合 (例: `0.45` 45%)。
+ **`EffectiveDate`** — この割り当てが有効になるカレンダーの日付。形式: `YYYY-MM-DD`。
レスポンスは、割り当ての `Id` (形式 `mrsa-[A-Za-z0-9]{13}`)、割り当てステータス (`ACTIVE`作成時）、および親共有のバンプ `Version` (割り当てミューテーションごとに 1 つのバージョン整数がバンプされ、その後の割り当て更新で楽観的ロックに使用されます) を返します。
### 割り当ての更新
パートナーは API `UpdateMarketplaceRevenueShareAllocation`アクションを使用して割り当てを更新できます。更新可能なフィールドは、割り当てが将来の日付であるか、現在有効であるか、過去の日付であるかによって異なります。
割り当てを更新する場合、パートナーは以下を提供する必要があります。
+ **`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 アクションを使用して 1 つの割り当てを取得できます`Id`。これにより、次が返されます。
+ 割り当ての `Id`と親共有の `MarketplaceRevenueShareArn`。
+ `RevenueSharePercent`, `EffectiveDate`, `ExpirationDate`.
+ `Status` (`ACTIVE` または `INACTIVE`)。
+ 後続の更新で楽観的にロック`MarketplaceRevenueShareVersion`するための親共有の 。
+ 「`CreatedDate`」および「`LastModifiedDate`」。
### Marketplace 収益共有の一覧表示
パートナーは、 `ListMarketplaceRevenueShares` API アクションを使用して、自分のアカウントが所有するすべての Marketplace 収益共有を表示できます。これにより、共有の概要のページ分割されたリストが返されます。
パートナーは、次の方法で結果をフィルタリングできます。
+ **`Catalog`** — `AWS`または `Sandbox` (必須）。
+ **`ProductIds`** — 取得する特定の Marketplace 製品 IDsのリスト。
レスポンスには、各共有の概要として、`Arn`、`Catalog`、`ProductId`、最新の `Version`、`CreatedDate`、および が含まれます`LastModifiedDate`。
`MaxResults` と を使用して`NextToken`、大きな結果セットをページ分割します。
### 割り当ての一覧表示
パートナーは、 `ListMarketplaceRevenueShareAllocations` API アクションを使用して、特定の Marketplace 収益共有の割り当てを一覧表示できます。これにより、フィルタリング機能を備えた割り当ての概要のページ分割されたリストが返されます。
パートナーは、次の方法で結果をフィルタリングできます。
+ **`Status`** — `ACTIVE`または `INACTIVE`。
+ **有効日付範囲** — `EffectiveDateOnOrAfter` / `EffectiveDateOnOrBefore` 有効日が特定のウィンドウ内にある割り当てを取得します。
レスポンスには、各割り当ての概要情報、`Id`、、`RevenueSharePercent``EffectiveDate`、`ExpirationDate``Status``MarketplaceRevenueShareVersion`、、および監査タイムスタンプが含まれます。
## Marketplace 収益共有のタグ付け
Marketplace Revenue Share リソースでは、標準のAWSタグ付けオペレーションがサポートされています。
+ **`TagResource`** — Marketplace 収益共有にタグを追加または上書きします。共有あたり最大 50 タグ。
+ **`UntagResource`** — キーで特定のタグを削除します。
+ **`ListTagsForResource`** — Marketplace 収益共有に現在適用されているすべてのタグを取得します。
割り当てはタグをサポートしていません。親共有にタグを付けて、関連する割り当てを整理します。
各タグ付けオペレーションは、共有の `Arn` (形式 `arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}`) をリソース識別子として受け入れます。Standard AWS tag-on-create は、 の `Tags`フィールドでもサポートされています`CreateMarketplaceRevenueShare`。