View a markdown version of this page

Arbeiten Sie mit Ihren Umsatzzuordnungs-IDs - AWS Partner Central
Was ist eine Umsatzzuordnungs-ID?Arbeiten Sie mit Ihren Umsatzzuordnungs-IDs

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 Umsatzzuordnungs-IDs

Eine Umsatzzuordnungs-ID ist eine Kennung auf Angebotsebene, die Ihren AWS Marketplace-Produktumsatz bestimmten AWS Marketplace-Angeboten and/or AWS Partner Central-Opportunities zuordnet. Es baut auf der Implementierung von Partner Revenue Measurement (PRM) auf Produktebene auf: PRM erfasst den gesamten zugeschriebenen Umsatz für ein Marketplace-Produkt, und eine Umsatzzuweisungs-ID ordnet diesen Umsatz bestimmten Deals entsprechend den von Ihnen angegebenen monatlichen Kostenzuweisungsprozentsätzen 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 Umsatzzuordnungs-ID?

Eine Umsatzzuordnungs-ID besteht aus zwei Ebenen:

  • Die Zuordnung einer vom Partner benannten, vom Partner beschriebenen Ressource, die durch eine ra- Präfix-ID (z. B.) und einen ARN identifiziert wird. ra-aabbccddee001 Jede Zuordnung ist auf ein Konto Catalog (AWSfür die Produktion, für Tests) und das Konto des Partners Sandbox beschränkt.

  • Ein oder mehrere monatliche Kostenzuordnungseinträge, wobei jeder Eintrag eine einzelne Kombination (Angebots-ID oder Opportunity-ID, Abrechnungsmonat) einem Kostenzuweisungsprozentsatz zuordnet. Die Einträge werden stapelweise asynchron über ein Zuweisungsaufgabenmuster verwaltet.

Eine Umsatzzuordnungs-ID kann auf zwei Arten verwendet werden:

  • Als Overlay auf Angebotsebene zu Ihrer bestehenden PRM-Implementierung auf Produktebene. Erstellen Sie eine Umsatzzuordnungs-ID, ordnen Sie Ihre entsprechenden Marketplace-Angebote and/or ACE-Opportunities zu und AWS ordnen Sie Ihren bereits gemessenen Produktumsatz diesen spezifischen Deals 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=<RA ID>) oder in einer User-Agent-Zeichenfolge (APN_1.1/pc_<RA ID>$) verwendet wird, um den AWS Verbrauch von Anfang an einem bestimmten Angebot zuzuordnen.

Arbeiten Sie mit Ihren Umsatzzuordnungs-IDs

Partner können Umsatzzuordnungs-IDs und ihre monatlichen Kostenzuordnungseinträge über den Revenue Attribution Service verwalten. Der Lebenszyklus durchläuft zwei unabhängige Abläufe: den Ablauf der Zuordnung von Datensätzen (Erstellen, Aktualisieren, Abrufen, Auflisten) und den Zuweisungsablauf (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 Umsatzzuordnungs-ID zu erstellen. Der zurückgegebene Id Wert Arn kann sofort als Resource-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 innerhalb des Katalogs und im Konto des Partners eindeutig sein. Maximal 128 Zeichen.

Partner können optional Folgendes angeben:

  • Description— Freitext-Beschreibung der Zuordnung. 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_TENANToderSINGLE_TENANT) an. Wenn bei der Erstellung nicht angegeben, gilt die Zuordnung für 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 sich eine einzelne Bereitstellung über mehr als ein Marketplace-Angebot erstreckt.

  • 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 anMarketplaceProduct.ProductIdentifier, wann immer Ihr Angebot in einem bestimmten Marketplace-Angebot verankert ist. Auf diese Weise kann AWSüberprüft werden, ob das Produkt dem Konto des anrufenden Partners oder einem Tochterkonto gehört, das über die Partnerkontoverbindung (PAC) verbunden ist, und das gelöste ProductCode und ProductType (z. B., SaaSAMI,ML) wird in der Antwort angezeigt. Wenn das Produkt keinem autorisierten Konto gehört, kehrt die API ValidationException mit gutem Grund zurückPRODUCT_NOT_FOUND_OR_NOT_OWNED.

Die Antwort gibt die neuen Attribute Id (Formatra-[a-z0-9]{13})Arn, die aufgelösten MarketplaceProduct Attribute und die Version Anfangszahl (die bei 1 beginnt und bei jeder nachfolgenden Aktualisierung erhöht wird) zurück.

Hinzufügen von Einträgen zur monatlichen 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 monatlicher Kostenzuordnungseinträge 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 verknüpften Deals. 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 zugewiesen.

  • Abrechnungsmonat — der Kalendermonat, für den die Kostenzuweisung gilt (z. B.2026-04).

  • Kostenzuweisung in% — der Teil des AWS Gesamtverbrauchs des Produkts, der auf dieses Geschäft in diesem Abrechnungsmonat entfällt. Erforderlich für mehrinstanzenfähige SaaS-Produkte, einschließlich von Partnern gehosteter Komponenten für Hybridbereitstellungen, bei denen sich Kunden die Infrastruktur teilen.

  • AWS Kundenkonto-ID — das AWS Konto des Kunden, der das Produkt konsumiert. Erforderlich für SaaS-Produkte mit mehreren Mandanten.

Die Gesamtkostenzuweisung in% aller Zuordnungseinträge für eine bestimmte Umsatzzuordnungs-ID und denselben Abrechnungsmonat darf 100% nicht überschreiten. Wenn die Summe 100% übersteigt, wird der fehlerhafte Eintrag während der asynchronen Geschäftsvalidierung mit einem Fehlercode pro Datensatz zurückgewiesen.

Synchrone Validierung: StartRevenueAttributionAllocationsTask Führt synchron die grundlegende Formvalidierung durch (Feldtypen, Muster, Chargengröße). Wenn die Standardvalidierung erfolgreich ist, gibt die API den Status TaskId with zurück. IN_PROGRESS Die Geschäftsvalidierung (Grenzwertprüfungen, Unveränderlichkeitsregeln, Abhängigkeitsabfragen anhand von Marketplace und ACE) wird asynchron ausgeführt, und die Ergebnisse pro Datensatz werden ermittelt. GetRevenueAttributionAllocationsTask

Um eine eingereichte Aufgabe zu überwachen, fragen Partner GetRevenueAttributionAllocationsTask anhand der Revenue Attribution Resource Id oder ARN ab. Die Antwort geht von IN_PROGRESS bis weiter COMPLETED (unabhängig davon, ob einzelne Datensätze erfolgreich waren oder nicht) und gibt Folgendes zurück:

  • TaskStatus— IN_PROGRESSCOMPLETED, oder FAILED (Fehler bei der Aufgabe der obersten Ebene).

  • RecordResults— für jeden Eingabedatensatz: der zugewiesene AllocationId (falls erfolgreich), der Status pro Datensatz (SUCCEEDEDoderFAILED) und 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.

Bearbeiten von Einträgen zur monatlichen Kostenzuweisung

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 beliebigen future Abrechnungsmonat hinzufügen.

  • Partner können einen monatlichen Eintrag für den aktuellen oder einen beliebigen future 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 Zuteilung 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 des Eintrags eines aktuellen oder future Monats gelten ab dem nächsten monatlichen Abrechnungszeitraum. Die historische Zuordnung für frühere Monate wird nicht rückwirkend neu berechnet.

Aktualisierungen der Zuordnungseinträge werden über dieselbe StartRevenueAttributionAllocationsTask API-Aktion übermittelt, wobei für jeden betroffenen Eintrag die Operation Einstellung auf UPDATE gesetzt ist. Das asynchrone Aufgabenmuster verarbeitet Aktualisierungen und Kreationen einheitlich.

Aktualisierung einer Umsatzzuordnungs-ID

Partner können eine bestehende Umsatzzuordnungs-ID mithilfe der UpdateRevenueAttribution API-Aktion aktualisieren. Description Der Attributionsdatensatz selbst ist ansonsten unveränderlich — NameMarketplaceProduct, und Tag-on-Create-Werte können nach der Erstellung nicht mehr geändert werden. Um die Ressource erneut zu taggen, verwenden Sie die AWS Standard-Tagging-Operationen für den ARN der Zuordnung.

Bei der Aktualisierung einer Umsatzzuordnungs-ID müssen Partner Folgendes angeben:

  • Catalog— AWS oderSandbox.

  • Identifier— die ra- ID der zu aktualisierenden Zuordnung.

  • Version— die aktuelle Version der Zuordnung für optimistisches Sperren.

Partner können optional Folgendes bereitstellen:

  • Description— die aktualisierte Freitext-Beschreibung. Maximal 1024 Zeichen.

  • ClientToken— ein Idempotenz-Token für das Update.

Optimistisches Sperren: Das Version Feld stellt sicher, dass Aktualisierungen nur gelten, wenn sich die Zuordnung seit dem letzten Abruf nicht geändert hat. Wenn die eingereichte Version Datei nicht mit der aktuellen Version der Ressource übereinstimmt, wird das Update mit einer Meldung, die die übermittelte ConflictException und die aktuelle Versionsnummer enthält, abgelehnt. Es empfiehlt sich, GetRevenueAttribution vor jedem Update die neueste Version mit 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 MarketplaceProduct bei der Erstellung festgelegt):

  • ProductId— die vom Partner bereitgestellte Marketplace-Produkt-ID.

  • ProductCode— der AWS Marketplace-Produktcode wurde von aufgelöstProductId.

  • ProductType—SaaS,AMI, ContainerML,Data, oderProfessional Services.

  • TenancyModel— MULTI_TENANT oderSINGLE_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 ausVersion, 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 die Status- und Prüfungsinformationen des Eintrags zurückgegeben.

IDs zur Umsatzzuweisung werden aufgelistet

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 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 der Erstellung filtern (einschließlich).

Partner können die Ergebnissortierung mit dem folgenden Sort Parameter konfigurieren:

  • SortBy— CreatedDate oderLastModifiedDate.

  • SortOrder— ASCENDING oderDESCENDING.

Die Antwort enthält eine Zusammenfassung für jede Zuordnung:Arn,,, IdCatalog, Name aufgelöste MarketplaceProduct Attribute,, CreatedDateLastModifiedDate, die letzten und TotalRevenueAttributionAssociationCount (die Anzahl der aktiven monatlichen KostenzuordnungseinträgeVersion, die mit der Zuordnung verknüpft sind).

Verwenden Sie MaxResults (Standard 25, maximal 100) und NextToken um große Ergebnismengen zu paginieren. Die Antwort beinhaltet, NextToken ob weitere Seiten verfügbar sind.

Auflistung der Einträge zur monatlichen Kostenzuweisung

Partner können mithilfe der ListRevenueAttributionAllocations API-Aktion die monatlichen Kostenzuordnungseinträge für eine bestimmte Umsatzzuordnungs-ID auflisten. Dadurch wird eine paginierte Liste von Zuordnungsübersichten mit Filterfunktionen zurückgegeben.

Partner können Ergebnisse nach folgenden Kriterien filtern:

  • MarketplaceOfferId— listet nur Einträge auf, die mit einem bestimmten Marketplace-Angebot verknüpft sind.

  • AwsPartnerCentralOpportunityId— listet nur Einträge auf, die mit einer bestimmten Partner Central-Opportunity verknüpft sind.

  • BillingMonth— listet nur Einträge für einen bestimmten Kalendermonat auf.

Die Antwort enthält zusammenfassende Informationen für jeden Eintrag: dieAllocationId, die zugehörige Angebots- oder Opportunity-ID, die AWS Kundenkonto-ID, den Abrechnungsmonat, die Kostenzuweisung in%, den Namen und Status des Eintrags sowie Zeitstempel für die Prüfung.

Erstellung von Dashboards: Die Kombination aus ListRevenueAttributions und ListRevenueAttributionAllocations soll die Erstellung von Partner-Dashboards 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 über mehrere Umsatzzuweisungs-IDs.

  • Alle Kostenzuordnungseinträge für den aktuellen Abrechnungsmonat, um zu überprüfen, ob die Gesamtwerte pro Zuordnung 100% nicht überschreiten.

  • Alle Umsatzzuordnungs-IDs, für die mindestens ein aktiver Umlageeintrag () vorhanden ist. TotalRevenueAttributionAssociationCount > 0