View a markdown version of this page

Arbeiten Sie mit Ihren Marketplace Revenue Shares - AWS Partner Central
Was ist eine Marketplace-Umsatzbeteiligung?Arbeiten Sie mit Ihren Marketplace Revenue SharesUmsatzanteile von Marketplace taggen

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.

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 wurdeProductId. Pro Produkt gibt es genau eine Marketplace-Umsatzbeteiligung.

  • Eine oder mehrere Zuweisungen — für jede Zuteilung werden ein RevenueSharePercent und ein Gültigkeitsdatum angegeben (EffectiveDateoptionalExpirationDate). 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 oderINACTIVE. Bei der Erstellung ist der Status standardmäßig aufACTIVE. 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 (neinExpirationDate) 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 verwendetTagResource, 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 (Formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}), dieCatalog, 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 oderSandbox.

  • 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 (Formatmrsa-[A-Za-z0-9]{13}), den Zuordnungsstatus (ACTIVEbei 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 oderSandbox.

  • 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ückConflictException.

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 „INACTIVEVorlä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 dieArn,, CatalogProductId, Version (die aktuelle Version der übergeordneten Aktie),, CreatedDateLastModifiedDate, und alle auf die Aktie angewendeten Tags zurückgegeben.

Partner können eine einzelne Zuordnung mithilfe der GetMarketplaceRevenueShareAllocation API-Aktion mit der Zuordnung abrufenId. Das Ergebnis ist:

  • Die Allokation Id und die Anteile der MuttergesellschaftMarketplaceRevenueShareArn.

  • RevenueSharePercent, EffectiveDate, ExpirationDate.

  • Status(ACTIVEoderINACTIVE).

  • 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: ArnCatalog,ProductId,, die neuesten VersionCreatedDate, undLastModifiedDate.

Verwenden Sie MaxResults undNextToken, 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 oderINACTIVE.

  • 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, StatusMarketplaceRevenueShareVersion, 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 (Formatarn:{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