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 Umsatzzuordnungs-IDs
Eine Umsatzzuordnungs-ID ist eine Kennung auf Deal-Ebene, die Ihren AWS Marketplace-Produktumsatz bestimmten AWS Marketplace-Angeboten and/or AWS von Partner Central zuordnet. Sie baut auf der Implementierung der Partner Revenue Measurement (PRM) auf Produktebene auf: PRM erfasst den gesamten zugeschriebenen Umsatz für ein Marketplace-Produkt, und eine Umsatzzuordnungs-ID ordnet diesen Umsatz bestimmten Deals gemäß den von Ihnen angegebenen Prozentsätzen für die monatliche Kostenzuweisung zu.
Der Revenue Attribution Service stellt APIs zur Verfügung, um Umsatzzuordnungs-IDs zu erstellen, abzurufen, aufzulisten und zu aktualisieren und ihre monatlichen Kostenzuordnungseinträge asynchron zu verwalten.
## Was ist eine Revenue Attribution ID?
Eine Umsatzzuordnungs-ID besteht aus zwei Ebenen:
+ **Die Zuordnung ist ** eine vom Partner benannte, vom Partner beschriebene Ressource, die durch eine `ra-` Präfix-ID (z. B.) und einen ARN identifiziert wird. `ra-aabbccddee001` Jede Zuordnung bezieht sich auf einen `Catalog` (`AWS`für Produktions- und Testzwecke) und das Konto des Partners`Sandbox`.
+ **Ein oder mehrere monatliche Kostenzuordnungseinträge. ** Jeder Eintrag ordnet eine einzelne Kombination (Angebots-ID oder Opportunity-ID, Abrechnungsmonat) einem Prozentsatz der Kostenzuweisung zu. Die Einträge werden in Stapeln asynchron mithilfe eines Aufgabenmusters für die Zuordnung verwaltet.
Eine Umsatzattribution-ID kann auf zwei Arten verwendet werden:
+ **Als Overlay auf Angebotsebene für Ihre bestehende PRM-Implementierung ** auf Produktebene. Erstellen Sie eine Umsatzzuordnungs-ID, verknüpfen Sie Ihre entsprechenden Marketplace-Angebote ( and/or ACE Opportunities) und AWS ordnen Sie Ihren bereits gemessenen Produktumsatz diesen spezifischen Angeboten zu — es sind keine Änderungen an Ihren vorhandenen Ressourcen-Tags oder User-Agent-Strings erforderlich.
+ **Als eigenständige Kennung, die direkt als Ressourcen-Tag-Wert (`aws-apn-id`=``) oder in einer User-Agent-Zeichenfolge (`APN_1.1/pc_$`) ** verwendet wird, um den AWS Konsum von Anfang an einem bestimmten Geschäft zuzuordnen.
## Arbeiten Sie mit Ihren Umsatzzuordnungs-IDs
Partner können Umsatzattribution-IDs und ihre monatlichen Kostenzuordnungseinträge über den Revenue Attribution Service verwalten. Der Lebenszyklus durchläuft zwei unabhängige Abläufe: den Ablauf der Attributionsdatensätze (erstellen, aktualisieren, abrufen, auflisten) und den Zuordnungsfluss (eine Batch-Aufgabe starten, Ergebnisse abfragen, einzelne Einträge abrufen, Einträge für eine Zuordnung auflisten).
### Eine Umsatzzuordnungs-ID erstellen
Der erste Schritt besteht darin, mithilfe der `CreateRevenueAttribution` API-Aktion eine Umsatzattribution-ID zu erstellen. Die zurückgegebene `Id` und `Arn` kann sofort als Ressourcen-Tag-Wert oder in einer User-Agent-Zeichenfolge verwendet werden, um den Verbrauch zuzuordnen. AWS
Bei der Erstellung einer Umsatzzuordnungs-ID müssen Partner Folgendes angeben:
+ **`Catalog`**— `AWS` für die Produktion oder `Sandbox` zum Testen.
+ **`Name`**— ein für Menschen lesbarer Name für die Zuordnung. Muss im Katalog und im Konto des Partners eindeutig sein. Maximal 128 Zeichen.
Partner können optional Folgendes bereitstellen:
+ **`Description`**— Freitextbeschreibung der Zuschreibung. Maximal 1024 Zeichen.
+ **`MarketplaceProduct`**— das AWS Marketplace-Produkt, das mit dieser Zuordnung verknüpft werden soll. Geben Sie `ProductIdentifier` (die 25-stellige Marketplace-Produkt-ID) und `TenancyModel` (`MULTI_TENANT`oder`SINGLE_TENANT`) an. Wenn sie bei der Erstellung weggelassen wird, bezieht sich die Zuordnung auf den gesamten Verbrauch, der unter der Umsatzzuordnungs-ID gemessen wird, unabhängig davon, welches Marketplace-Produkt der Kunde gekauft hat. Dies ist nützlich, wenn eine einzelne Bereitstellung mehr als ein Marketplace-Angebot umfasst.
+ **`Tags`**— bis zu 200 Schlüssel-Wert-Paare für die Ressourcenorganisation. Tag-Schlüssel müssen innerhalb der Anfrage eindeutig sein.
Best Practice: Geben Sie an`MarketplaceProduct.ProductIdentifier`, wann immer Ihr Angebot an ein bestimmtes Marketplace-Angebot gebunden ist. Auf diese Weise können AWS Sie überprüfen, ob das Produkt dem Konto des anrufenden Partners oder einem Tochterkonto gehört, das über die Partner Account Connection (PAC) verknüpft ist, und in der Antwort werden die gelösten `ProductCode` und `ProductType` (z. B. `SaaS``AMI`,,`ML`) angezeigt. Wenn das Produkt keinem autorisierten Konto gehört, gibt die API eine entsprechende Begründung zurück `ValidationException``PRODUCT_NOT_FOUND_OR_NOT_OWNED`.
Die Antwort gibt die `MarketplaceProduct` Attribute new `Id` (format`ra-[a-z0-9]{13}`)`Arn`, aufgelöst und die ursprüngliche `Version` Zahl (die bei 1 beginnt und bei jeder nachfolgenden Aktualisierung erhöht wird) zurück.
### Hinzufügen von Einträgen für die monatliche Kostenzuweisung
Sobald eine Umsatzzuordnungs-ID erstellt wurde, ordnen Partner ihr AWS Marketplace Offers and/or ACE Opportunities zu, indem sie über die `StartRevenueAttributionAllocationsTask` API-Aktion einen Stapel von Einträgen für die monatliche Kostenzuweisung einreichen. Dies ist ein asynchroner Vorgang, der bis zu 250 Zuordnungsänderungen (`CREATE` and/or `UPDATE`) pro Aufgabe akzeptiert.
Jeder Zuordnungseintrag gibt Folgendes an:
+ **Angebots-ID oder ** Opportunity-ID — die eindeutige Kennung des Deals, das verknüpft wird. Wenn ein Marketplace-Angebot bereits mit einer ACE-Opportunity verknüpft ist, müssen Partner nur die Angebots-ID angeben; der Umsatz AWS wird automatisch der verknüpften Opportunity zugeordnet.
+ **Abrechnungsmonat ** — der Kalendermonat, für den die Kostenzuweisung gilt (z. B.`2026-04`).
+ **Kostenzuweisung in% ** — der Anteil des AWS Gesamtverbrauchs des Produkts, der auf dieses Angebot in diesem Abrechnungsmonat entfällt. Erforderlich für SaaS-Produkte mit mehreren Mandanten, einschließlich von Partnern gehosteter Komponenten für Hybridbereitstellungen, bei denen Kunden die Infrastruktur gemeinsam nutzen.
+ ** AWS Kundenkonto-ID ** — das AWS Konto des Kunden, der das Produkt konsumiert. Erforderlich für SaaS-Produkte mit mehreren Mandanten.
Der Prozentsatz der Gesamtkostenzuweisung für alle Zuordnungseinträge für eine bestimmte Umsatzzuordnungs-ID und denselben Abrechnungsmonat darf 100% nicht überschreiten. Wenn der Gesamtwert 100% übersteigt, wird der fehlerhafte Eintrag bei der asynchronen Geschäftsvalidierung mit einem Fehlercode pro Datensatz zurückgewiesen.
Synchrone Validierung: `StartRevenueAttributionAllocationsTask` Führt die grundlegende Formvalidierung synchron durch (Feldtypen, Muster, Stapelgröße). Wenn die grundlegende Validierung erfolgreich ist, gibt die API den Status `TaskId` with zurück. `IN_PROGRESS` Die Unternehmensvalidierung (Cap-Checks, Unveränderbarkeitsregeln, Suche nach Abhängigkeiten anhand von Marketplace und ACE) wird asynchron ausgeführt, und die Ergebnisse pro Datensatz werden anhand von Daten ermittelt. `GetRevenueAttributionAllocationsTask`
Um eine übermittelte Aufgabe zu überwachen, verwenden Partner eine Umfrage `GetRevenueAttributionAllocationsTask` mit der Revenue Attribution Resource Id oder ARN. Die Antwort geht von `IN_PROGRESS` bis `COMPLETED` (unabhängig davon, ob einzelne Datensätze erfolgreich waren oder nicht) und gibt Folgendes zurück:
+ **`TaskStatus`**— `IN_PROGRESS``COMPLETED`, oder `FAILED` (Fehler bei der Aufgabe auf oberster Ebene).
+ **`RecordResults`**— für jeden Eingabedatensatz: der zugewiesene `AllocationId` (falls erfolgreich), der Status (`SUCCEEDED`oder`FAILED`) pro Datensatz sowie ein strukturierter Fehlercode und eine Meldung, falls der Datensatz fehlgeschlagen ist.
Die Partner sollten die Aufgabenergebnisse umgehend abrufen. Nach Abschluss der Aufgabe können die Ergebnisse pro Datensatz abgeglichen werden. Fehlgeschlagene Eingaben können korrigiert und in einer neuen Aufgabe erneut eingereicht werden.
### Einträge für die monatliche Kostenzuweisung bearbeiten
Einträge zur Kostenzuweisung werden pro Abrechnungsmonat nach folgenden Regeln verwaltet:
+ Partner können jederzeit einen neuen monatlichen Eintrag ** für den aktuellen oder einen zukünftigen Abrechnungsmonat ** hinzufügen.
+ Partner können einen monatlichen Eintrag ** für den aktuellen oder einen zukünftigen Abrechnungsmonat jederzeit ** aktualisieren.
+ Partner können den Eintrag des letzten Monats ** bis zum ** 7. des aktuellen Monats ** aktualisieren**. In diesem Fenster können Partner die tatsächliche Nutzung im AWS Cost Explorer überprüfen, bevor sie die Zuordnung für den Vormonat abschließen.
Nach dem 7. des aktuellen Monats kann die Zuordnung für den vorherigen Abrechnungsmonat nicht mehr geändert werden. Aktualisierungen eines aktuellen oder zukünftigen Monatseintrags gelten ab dem nächsten monatlichen Abrechnungszeitraum. Die historische Zuordnung für frühere Monate wird nicht rückwirkend neu berechnet.
Aktualisierungen von Zuordnungseinträgen werden über dieselbe `StartRevenueAttributionAllocationsTask` API-Aktion übermittelt, wobei für jeden betroffenen Eintrag die `Operation` Einstellung auf `UPDATE` gesetzt ist. Das asynchrone Aufgabenmuster behandelt Aktualisierungen und Kreationen einheitlich.
### Aktualisierung einer Umsatzzuordnungs-ID
Partner können die `Description` einer vorhandenen Umsatzzuordnungs-ID mithilfe der `UpdateRevenueAttribution` API-Aktion aktualisieren. Der Attributionsdatensatz selbst ist ansonsten unveränderlich —`Name`,`MarketplaceProduct`, und die Tag-on-Create-Werte können nach der Erstellung nicht mehr geändert werden. Um die Ressource erneut zu taggen, verwenden Sie die standardmäßigen AWS Tagging-Operationen für den ARN der Attribution.
Bei der Aktualisierung einer Umsatzzuordnungs-ID müssen Partner Folgendes angeben:
+ **`Catalog`**— `AWS` oder`Sandbox`.
+ **`Identifier`**— die `ra-` ID des Attributs, das aktualisiert werden soll.
+ **`Version`**— die aktuelle Version der Attribution für optimistisches Sperren.
Partner können optional Folgendes bereitstellen:
+ **`Description`**— die aktualisierte Freitextbeschreibung. Maximal 1024 Zeichen.
+ **`ClientToken`**— ein Idempotenz-Token für das Update.
Optimistische Sperrung: Das `Version` Feld stellt sicher, dass Aktualisierungen nur gelten, wenn sich die Zuordnung seit dem letzten Abruf nicht geändert hat. Wenn die übermittelte Version `Version` nicht mit der aktuellen Ressourcenversion übereinstimmt, wird das Update abgelehnt `ConflictException` und es wird eine Meldung mit den übermittelten und aktuellen Versionsnummern angezeigt. Es empfiehlt sich, `GetRevenueAttribution` vor jedem Update die neueste Version abzurufen.
### Details zur Umsatzzuordnungs-ID anzeigen
Partner können mithilfe der `GetRevenueAttribution` API-Aktion vollständige Informationen für eine einzelne Umsatzzuordnungs-ID abrufen. Das Ergebnis ist:
Metadaten der Ressource:
+ Eindeutiger Bezeichner (`Id`) und Amazon-Ressourcenname (`Arn`).
+ Der, `Catalog` in dem die Zuordnung existiert.
+ `Name` und `Description`.
+ Die abgerufenen `Version` und die `LatestVersion` (verwenden Sie die neueste Version für nachfolgende Aktualisierungen).
Marketplace-Produktattribute (falls sie bei der Erstellung festgelegt `MarketplaceProduct` wurden):
+ `ProductId`— die vom Partner bereitgestellte Marketplace-Produkt-ID.
+ `ProductCode`— der AWS Marketplace-Produktcode, von dem die Lösung gefunden wurde`ProductId`.
+ `ProductType`—`SaaS`,`AMI`, `Container``ML`,`Data`, oder`Professional Services`.
+ `TenancyModel`— `MULTI_TENANT` oder`SINGLE_TENANT`.
Informationen zur Prüfung:
+ `CreatedDate` und `LastModifiedDate`.
Partner können `Version` in der Anfrage optional eine spezifische Angabe machen, um eine historische Version der Zuordnung abzurufen. Lassen Sie es aus, `Version` um die neueste Version zurückzugeben.
Um einen bestimmten Eintrag für die monatliche Kostenzuweisung abzurufen, verwenden Partner die `GetRevenueAttributionAllocation` API-Aktion mit den Einträgen. `AllocationId` Dadurch werden die Angebots- oder Opportunity-ID, der Abrechnungsmonat, die Kostenzuweisung in%, die AWS Kundenkonto-ID sowie der Status und die Prüfungsinformationen des Eintrags zurückgegeben.
### Auflisten der Umsatzzuordnungs-IDs
Partner können mithilfe der `ListRevenueAttributions` API-Aktion alle Umsatzzuordnungs-IDs in ihrem Konto einsehen. Dadurch wird eine paginierte Liste von Attributionszusammenfassungen mit Filter- und Sortierfunktionen zurückgegeben.
Partner können die Ergebnisse nach folgenden Kriterien filtern:
+ **`Catalog`**— `AWS` oder `Sandbox` (erforderlich).
+ **`Identifiers`**— eine Liste mit bis zu 100 spezifischen `ra-` IDs, die abgerufen werden sollen.
+ **`CreatedAfter`/`CreatedBefore`**— nach Zeitstempelbereich für die Erstellung filtern (einschließlich).
Partner können die Ergebnissortierung mithilfe des folgenden `Sort` Parameters konfigurieren:
+ `SortBy`— `CreatedDate` oder`LastModifiedDate`.
+ `SortOrder`— `ASCENDING` oder`DESCENDING`.
Die Antwort enthält eine Zusammenfassung für jede Zuordnung:`Arn`,,`Id`, gelöste `MarketplaceProduct` Attribute `Catalog``Name`,, `CreatedDate``LastModifiedDate`, das letzte und `TotalRevenueAttributionAssociationCount` (die Anzahl der aktiven monatlichen Kostenzuordnungseinträge`Version`, die mit der Zuordnung verknüpft sind).
Verwenden Sie `MaxResults` (Standard 25, maximal 100) und, um in großen `NextToken` Ergebnismengen zu paginieren. Die Antwort enthält eine Angabe, `NextToken` ob weitere Seiten verfügbar sind.
### Auflistung der Einträge zur monatlichen Kostenzuweisung
Partner können mithilfe der `ListRevenueAttributionAllocations` API-Aktion die Einträge für die monatliche Kostenzuweisung für eine bestimmte Umsatzzuordnungs-ID auflisten. Dadurch wird eine paginierte Liste von Zuordnungszusammenfassungen mit Filterfunktionen zurückgegeben.
Partner können die Ergebnisse nach folgenden Kriterien filtern:
+ **`MarketplaceOfferId`**— listet nur Einträge auf, die einem bestimmten Marketplace-Angebot zugeordnet sind.
+ **`AwsPartnerCentralOpportunityId`**— listet nur Einträge auf, die einer bestimmten Partner Central-Opportunity zugeordnet sind.
+ **`BillingMonth`**— listet nur Einträge für einen bestimmten Kalendermonat auf.
Die Antwort enthält zusammenfassende Informationen für jeden Eintrag: die`AllocationId`, die zugehörige Angebots- oder Opportunity-ID, die AWS Kundenkonto-ID, den Abrechnungsmonat, den Prozentsatz der Kostenzuweisung, den Namen und Status des Eintrags sowie Zeitstempel für die Prüfung.
Dashboard-Erstellung: Die Kombination aus `ListRevenueAttributions` und `ListRevenueAttributionAllocations` wurde entwickelt, um die Erstellung von Partner-Dashboards zu unterstützen. Partner können Ansichten wie die folgenden erstellen:
+ Alle Umsatzzuordnungs-IDs, die in den letzten 30 Tagen erstellt wurden, sortiert nach Erstellungsdatum.
+ Alle monatlichen Kostenzuordnungseinträge für ein bestimmtes Marketplace-Angebot für mehrere Umsatzzuordnungs-IDs.
+ Alle Einträge zur Kostenzuweisung für den aktuellen Abrechnungsmonat, um sicherzustellen, dass die Gesamtsummen pro Zuordnung nicht mehr als 100% betragen.
+ Alle Umsatzzuordnungs-IDs, für die mindestens ein aktiver Umlageeintrag () vorhanden ist. `TotalRevenueAttributionAssociationCount > 0`