Die AWS Partner Central API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der [AWS Partner Central API-Referenz.](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Arbeiten Sie mit Ihren Marketplace Revenue Shares
Eine Marketplace-Umsatzbeteiligung ist eine Eingabe für ein AWS Marketplace-Produkt, die den Teil des Gesamtumsatzes des Produkts angibt, der über AWS Marketplace Marketplace.AWS verwendet diese Eingabe, um den Umsatz eines Partners mit anderen Marketplace-collected Umsatzsignalen zu korrelieren.
Der Marketplace Revenue Share Service stellt APIs zur Verfügung, um Marketplace Revenue Share Ressourcen zu erstellen, abzurufen und aufzulisten und deren Zuweisungen zu verwalten (die vom Partner angegebenen Umsatzbeteiligungsprozentsätze und Gültigkeitszeitfenster). Standardmäßige AWS Tagging-Operationen werden auf der Marketplace-Ressource Revenue Share unterstützt.
## Was ist eine Marketplace-Umsatzbeteiligung?
Eine Marketplace-Umsatzbeteiligung besteht aus zwei Ebenen:
+ **Die Aktie** — ein Input für ein einzelnes AWS Marketplace-Produkt, das vom Marketplace identifiziert wurde`ProductId`. Pro Produkt gibt es genau eine Marketplace-Umsatzbeteiligung.
+ **Eine oder mehrere Zuweisungen** — für jede Zuteilung werden ein `RevenueSharePercent` und ein Gültigkeitsdatum angegeben (`EffectiveDate`optional`ExpirationDate`). Einer Aktie können im Laufe der Zeit viele Zuteilungen zugewiesen werden, aber zu jedem Zeitpunkt kann nur eine `ACTIVE` Zuteilung gelten.
Allokationen haben die folgenden wichtigsten Eigenschaften:
+ **Status** — `ACTIVE` oder`INACTIVE`. Bei der Erstellung ist der Status standardmäßig auf`ACTIVE`. Bei Umsatzberechnungen und Überschneidungsprüfungen werden nur `ACTIVE` Umlagen berücksichtigt.
+ **Überschneidungsinvariant** — innerhalb einer einzelnen Aktie dürfen sich die Bandbreiten nicht bei zwei `ACTIVE` Zuweisungen überschneiden. `[EffectiveDate, ExpirationDate]` Pro Aktie ist zu einem beliebigen Zeitpunkt höchstens eine unbefristete `ACTIVE` Zuteilung (nein`ExpirationDate`) zulässig.
## Arbeiten Sie mit Ihren Marketplace Revenue Shares
Partner verwalten Marketplace Revenue Shares und deren Zuweisungen über den Marketplace Revenue Share Service. Der Lebenszyklus durchläuft zwei Abläufe: den Ablauf zum Teilen (Erstellen, Abrufen, Auflisten, Markieren) und den Zuweisungsfluss (Erstellen, Aktualisieren, Löschen, Abrufen, Auflisten).
### Schaffung einer Marktplatz-Umsatzbeteiligung
Der erste Schritt besteht darin, mithilfe der `CreateMarketplaceRevenueShare` API-Aktion eine Marketplace-Umsatzbeteiligung für ein AWS Marketplace-Produkt zu erstellen. Die Aktie wird vom Marketplace identifiziert `ProductId` und dient als Container für alle nachfolgenden Allokationen.
Bei der Erstellung einer Marketplace-Umsatzbeteiligung müssen Partner Folgendes angeben:
+ **`Catalog`**— `AWS` für die Produktion oder `Sandbox` zum Testen.
+ **`ProductId`**— die 25-stellige Marketplace-Produkt-ID. Muster:`[a-z0-9]{25}`.
Partner können optional Folgendes bereitstellen:
+ **`Tags`**— bis zu 50 Schlüssel-Wert-Paare für die Organisation der Ressourcen zum Zeitpunkt der Erstellung. Wird verwendet`TagResource`, um Tags nach der Erstellung hinzuzufügen.
+ **`ClientToken`**— ein Idempotenz-Token, um doppelte Kreationen beim erneuten Versuch zu verhindern. Maximal 64 Zeichen. SDKs generieren dieses Token automatisch.
Produktvalidierung: Bei der Erstellung verifiziert der Service bei AWS Marketplace, ob das Produkt dem Konto des Anrufers oder einem Tochterkonto gehört, das über Partner Account Connection (PAC) mit dem Anrufer verbunden ist. Wenn das Produkt nicht existiert oder das Eigentümerkonto für den Anrufer nicht autorisiert ist, kehrt die API mit gutem Grund zurück. `ValidationException` `PRODUCT_NOT_FOUND_OR_NOT_OWNED`
Eine Aktie pro Produkt: Ein zweiter `CreateMarketplaceRevenueShare` Aufruf für dasselbe Ergebnis führt `ProductId` zu denselben `Catalog` Ergebnissen. `ConflictException`
Die Antwort gibt die Aktie `Arn` (Format`arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}`), die`Catalog`, die ursprüngliche `Version` Zahl (die bei 1 beginnt und bei jeder Zuordnungsänderung inkrementiert wird) und alle bei der Erstellung verwendeten Tags zurück. `ProductId`
### Zuordnungen werden hinzugefügt
Sobald eine Marketplace-Umsatzbeteiligung erstellt wurde, geben die Partner einen Prozentsatz der Umsatzbeteiligung und ein Gültigkeitsdatum an, indem sie über die `CreateMarketplaceRevenueShareAllocation` API-Aktion eine Zuordnung erstellen.
Bei der Erstellung einer Zuteilung müssen die Partner Folgendes angeben:
+ **`Catalog`**— `AWS` oder`Sandbox`.
+ **`MarketplaceRevenueShareIdentifier`**— die Kennung der Mutteraktie.
+ **`RevenueSharePercent`**— der Prozentsatz des über Marketplace erzielten Umsatzes des Produkts, angegeben als Dezimalzahl (z. B. `0.45` für 45%).
+ **`EffectiveDate`**— das Kalenderdatum, an dem diese Zuordnung wirksam wird. Format:`YYYY-MM-DD`.
Die Antwort gibt den Status der Allokation `Id` (Format`mrsa-[A-Za-z0-9]{13}`), den Zuordnungsstatus (`ACTIVE`bei der Erstellung) und den Wert der übergeordneten Aktie zurück `Version` (eine einzige Ganzzahl pro Aktie wird bei jeder Allokationsmutation erhöht, was für optimistische Sperren bei nachfolgenden Allokationsaktualisierungen verwendet wird).
### Allokationen werden aktualisiert
Partner können eine Zuordnung mithilfe der `UpdateMarketplaceRevenueShareAllocation` API-Aktion aktualisieren. Die aktualisierbaren Felder hängen davon ab, ob es sich bei der Zuordnung um eine zukünftige, aktuell gültige oder vergangene Zuordnung handelt.
Bei der Aktualisierung einer Zuordnung müssen die Partner Folgendes angeben:
+ **`Catalog`**— `AWS` oder`Sandbox`.
+ **`MarketplaceRevenueShareIdentifier`**— die Kennung der Mutteraktie.
+ **`AllocationId`**— die `mrsa-` ID der zu aktualisierenden Zuordnung.
+ **`MarketplaceRevenueShareVersion`**— die aktuelle Version der Mutteraktie für eine optimistische Festlegung der Allokation. Bump-Konflikte kehren zurück`ConflictException`.
Partner können optional Folgendes bereitstellen:
+ **`RevenueSharePercent`**— den aktualisierten Prozentsatz der Umsatzbeteiligung. Nur für zukünftige Zuweisungen bearbeitbar.
+ **`EffectiveDate`**— das aktualisierte Datum des Inkrafttretens. Nur für zukünftige Zuweisungen bearbeitbar.
+ **`ExpirationDate`**— das aktualisierte Ablaufdatum. Bearbeitbar für zukünftige Zuweisungen (beliebiger Wert`> EffectiveDate`) und für aktuell gültige oder unbefristete Zuweisungen (beliebiger Wert). `≥ today`
+ **`Status`**— `ACTIVE` oder. `INACTIVE` Die Einstellung auf „`INACTIVE`Vorläufiges Löschen“ löscht die Zuordnung. Nur für zukünftige Zuweisungen bearbeitbar.
+ **`ClientToken`**— ein Idempotenz-Token.
### Details zur Umsatzbeteiligung auf Marketplace anzeigen
Partner können mithilfe der `GetMarketplaceRevenueShare` API-Aktion vollständige Informationen für eine einzelne Marketplace-Umsatzbeteiligung abrufen. Dadurch werden die`Arn`,, `Catalog``ProductId`, `Version` (die aktuelle Version der übergeordneten Aktie),, `CreatedDate``LastModifiedDate`, und alle auf die Aktie angewendeten Tags zurückgegeben.
Partner können eine einzelne Zuordnung mithilfe der `GetMarketplaceRevenueShareAllocation` API-Aktion mit der Zuordnung abrufen`Id`. Das Ergebnis ist:
+ Die Allokation `Id` und die Anteile der Muttergesellschaft`MarketplaceRevenueShareArn`.
+ `RevenueSharePercent`, `EffectiveDate`, `ExpirationDate`.
+ `Status`(`ACTIVE`oder`INACTIVE`).
+ Die übergeordnete Aktie steht `MarketplaceRevenueShareVersion` für optimistisches Warten auf nachfolgende Updates.
+ `CreatedDate` und `LastModifiedDate`.
### Umsatzanteile von Marketplace auflisten
Partner können mithilfe der `ListMarketplaceRevenueShares` API-Aktion alle Marketplace Revenue Shares einsehen, die ihrem Konto gehören. Dadurch wird eine paginierte Liste mit Aktienübersichten zurückgegeben.
Partner können Ergebnisse nach folgenden Kriterien filtern:
+ **`Catalog`**— `AWS` oder `Sandbox` (erforderlich).
+ **`ProductIds`**— eine Liste bestimmter Marketplace-Produkt-IDs, die abgerufen werden sollen.
Die Antwort enthält eine Zusammenfassung für jede Aktie: `Arn``Catalog`,`ProductId`,, die neuesten `Version``CreatedDate`, und`LastModifiedDate`.
Verwenden Sie `MaxResults` und`NextToken`, um große Ergebnismengen zu paginieren.
### Zuordnungen auflisten
Partner können mithilfe der `ListMarketplaceRevenueShareAllocations` API-Aktion die Zuteilungen für eine bestimmte Marketplace-Umsatzbeteiligung auflisten. Dadurch wird eine paginierte Liste von Allokationsübersichten mit Filterfunktionen zurückgegeben.
Partner können Ergebnisse nach folgenden Kriterien filtern:
+ **`Status`**— `ACTIVE` oder`INACTIVE`.
+ **Gültigkeitszeitraum —**`EffectiveDateOnOrAfter`/`EffectiveDateOnOrBefore`, um Zuordnungen abzurufen, deren Gültigkeitsdatum in ein bestimmtes Fenster fällt.
Die Antwort enthält zusammenfassende Informationen für jede Zuordnung:`Id`,,,`RevenueSharePercent`,`EffectiveDate`,`ExpirationDate`, `Status``MarketplaceRevenueShareVersion`, und Prüfzeitstempel.
## Umsatzanteile von Marketplace taggen
Standardmäßige AWS Tagging-Operationen werden auf der Marketplace-Ressource Revenue Share unterstützt:
+ **`TagResource`**— Hinzufügen oder Überschreiben von Tags auf einer Marketplace-Umsatzbeteiligung. Maximal 50 Tags pro Aktie.
+ **`UntagResource`**— Entferne bestimmte Tags per Schlüssel.
+ **`ListTagsForResource`**— ruft alle Tags ab, die derzeit auf eine Marketplace-Umsatzbeteiligung angewendet wurden.
Zuordnungen unterstützen keine Tags. Taggen Sie die übergeordnete Aktie, um zugehörige Zuordnungen zu organisieren.
Bei jedem Tagging-Vorgang wird das Format `Arn` (Format`arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}`) des Share als Ressourcen-ID akzeptiert. Das standardmäßige AWS Tag-on-Create-Feld wird auch über das Feld on unterstützt. `Tags` `CreateMarketplaceRevenueShare`