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.

Konfiguration der benutzerdefinierten Messung für Containerprodukte mit dem AWS Marketplace Metering Service

AWS Marketplace Für Produkte in Containern können individuelle Dosierungen für bis zu 24 verschiedene Preisdimensionen pro Produkt verwendet werden. Jeder Dimension kann ein langfristiger Vertragspreis zugeordnet werden. Um eine benutzerdefinierte Messung zu ermöglichen, integrieren Sie Ihr Container-Produkt in den AWS Marketplace Metering Service. Sie können Ihre eigenen Preiseinheiten und die benutzerdefinierte Messung für diese Nutzung bis hin AWS zur Abrechnung mithilfe des MeterUsageAPIVorgangs definieren. In den folgenden Abschnitten erfahren Sie, wie Sie die benutzerdefinierte Messung für Ihr Container-Produkt konfigurieren.

Preisdimensionen werden an zwei Stellen definiert, einmal im Formular zum Laden des Produkts und einmal während des MeterUsage Vorgangs. Diese Zwei-Faktor-Methode stellt sicher, dass die nachfolgenden Angebote wie beabsichtigt funktionieren, bevor sie der Öffentlichkeit zugänglich gemacht werden.

Um die benutzerdefinierte Messung einzurichten, müssen Sie die Nutzungskategorie, den Einheitentyp und die Preisgestaltung auswählen:

Optional können Sie die Nutzung anhand von Eigenschaften, die Sie verfolgen, in Zuordnungen aufteilen. Die Zuweisungen werden dem Käufer als Tags angezeigt. Diese Tags ermöglichen es dem Käufer, seine Kosten aufgeschlüsselt nach Nutzungswerten einzusehen. Wenn Sie beispielsweise nach dem Benutzer abrechnen und Benutzer die Eigenschaft „Abteilung“ haben, können Sie Nutzungszuordnungen mit Tags erstellen, die den Schlüssel „Abteilung“ und eine Zuordnung pro Wert haben. Dadurch werden der von Ihnen gemeldete Preis, die Abmessungen oder die Gesamtnutzung nicht geändert, Ihr Kunde kann seine Kosten jedoch nach Kategorien aufgeschlüsselt nach Kategorien anzeigen, die zu Ihrem Produkt passen.

Wir empfehlen, dass Sie jede Stunde einen Messdatensatz senden. Sie können die Nutzung jedoch auch über tägliche oder monatliche Zeiträume aggregieren. Falls es zu einem Ausfall kommt, können Sie die Softwarenutzung des Käufers zusammenfassen und die Software innerhalb der folgenden Stunden abrechnen. Sie können nicht mehr als einen Datensatz pro Stunde versenden.

Voraussetzungen für die benutzerdefinierte Messung

Bevor Sie das Produkt veröffentlichen, müssen Sie Folgendes tun:

Produktladeformular für die benutzerdefinierte Messung

Wenn Sie das Produktladeformular für die individuelle Dosierung ausfüllen, kann jedes Produkt bis zu 24 Abmessungen haben. Die Abmessungen sind in den folgenden Feldern definiert:

Testen der MeterUsage Integration und des Vorschaumodus

Verwenden Sie diesen MeterUsage Vorgang, um Ihre Integration zu testen, bevor Sie Ihr Bild AWS Marketplace zur Veröffentlichung einreichen.

Der Vorschaumodus funktioniert identisch mit dem Produktionsmodus, außer dass der Vorschaumodus nicht die Berechtigung zur Nutzung Ihres Produkts überprüft. Um MeterUsage im Vorschaumodus aufzurufen, rufen Sie MeterUsage von den Container-Images aus auf, indem Sie Ihr Produkt auf Amazon Elastic Container Service (AmazonECS) oder Amazon Elastic Kubernetes Service (AmazonEKS) mit dem ausführen, auf dem AWS-Konto Sie das Produkt anbieten. AWS Marketplace Ihre Metering-Integration muss das dynamisch einstellen AWS-Region, anstatt es fest zu codieren. Starten Sie beim Testen jedoch mindestens eine ECS Amazon-Aufgabe oder einen EKS Amazon-Pod mit Ihrem bezahlten Container in der Region USA Ost (Nord-Virginia), damit das AWS Marketplace Betriebsteam Ihre Arbeit anhand der Logs in dieser Region überprüfen kann.

Sie können die Integration erst dann vollständig testen, wenn es mit allen erforderlichen Metadaten und Preisinformationen veröffentlicht wurde. Auf Anfrage kann das für die AWS Marketplace Katalogverwaltung zuständige Team den Eingang Ihrer Messdaten im Vorschaumodus überprüfen.

Fehlerbehandlung für MeterUsage

Wenn Ihr Container-Image in den MeterUsage Vorgang integriert wird und eine Ausnahme außer ThrottlingException beim Start des Containers auftritt, sollten Sie den Container beenden, um eine unbefugte Verwendung zu verhindern.

Andere Ausnahmen als ThrottlingException werden nur beim ersten Aufruf von MeterUsage ausgelöst. Nachfolgende Aufrufe von derselben ECS Amazon-Aufgabe oder demselben EKS Amazon-Pod werden nicht ausgelöst, CustomerNotSubscribedException auch wenn der Kunde sich abmeldet, während die Aufgabe oder der Pod noch ausgeführt wird. Diesen Kunden wird das Ausführen der Container auch dann noch in Rechnung gestellt, wenn sie sich abgemeldet haben und ihre Nutzung nachgehalten wird.

Eine ausführliche Beschreibung MeterUsageder häufigsten Fehler für finden Sie in der AWS Marketplace Metering Service APIReferenz. MeterUsage Für jede AWS SDK Programmiersprache gibt es eine Reihe von Richtlinien zur Fehlerbehandlung, in denen Sie weitere Informationen finden können.

Tagging nach Herstellerangaben (optional)

Durch die Kennzeichnung mit Herstellerangabe können unabhängige Softwareanbieter (ISVs) dem Käufer detailliertere Einblicke in seine Softwarenutzung geben und ihn bei der Kostenverteilung unterstützen.

Es gibt viele Möglichkeiten, die Softwarenutzung eines Käufers zu kennzeichnen. Eine Möglichkeit besteht darin, Ihre Käufer zunächst zu fragen, was sie in ihrer Kostenaufteilung sehen möchten. Anschließend können Sie die Nutzung auf die Immobilien aufteilen, die Sie für das Konto des Käufers nachverfolgen. Zu den Eigenschaften gehören beispielsweise AccountIdBusiness Unit,Cost Centers, und andere relevante Metadaten für Ihr Produkt. Diese Eigenschaften werden dem Käufer als Tags angezeigt. Mithilfe von Stichwörtern können Käufer in ihrer AWS Abrechnungskonsole ihre Kosten nach Nutzung aufgeteilt nach Tagwerten einsehen (https://console.aws.amazon.com/billing/). Das Tagging mit Lieferantenzählung hat keine Auswirkungen auf den Preis, die Abmessungen oder die Gesamtnutzung, die Sie melden. So können Ihre Kunden ihre Kosten nach Kategorien aufteilen, die zu Ihrem Produkt passen.

In einem gängigen Anwendungsfall abonniert ein Käufer Ihr Produkt mit einem AWS-Konto. Der Käufer hat außerdem zahlreiche Benutzer, die mit demselben Produktabonnement verknüpft sind. Sie können Nutzungszuordnungen mit Tags erstellen, die den Schlüssel von habenAccountId, und dann jedem Benutzer die Nutzung zuweisen. In diesem Fall können Käufer das AccountId Tag in ihrer Billing and Cost Management-Konsole aktivieren und die Nutzung einzelner Benutzer analysieren.

Erfahrung des Verkäufers

Verkäufer können die Messdaten für Ressourcen mit demselben Satz von Stichwörtern zusammenfassen, anstatt die Nutzung für alle Ressourcen zu aggregieren. Verkäufer können beispielsweise einen Messdatensatz erstellen, der verschiedene Kategorien von Daten umfasst. UsageAllocations Jeder Bucket steht UsageQuantity für eine Reihe von Stichwörtern, wie z. B. AccountId undBusinessUnit.

Im folgenden Diagramm hat Ressource 1 einen eindeutigen Satz von AccountId und BusinessUnit -Tags und wird im Messdatensatz als ein einziger Eintrag angezeigt.

Ressource 2 und Ressource 3 haben beide dasselbe AccountId Tag,2222, und dasselbe BusinessUnit Tag,Operations. Dadurch werden sie zu einem einzigen UsageAllocations Eintrag im Messdatensatz zusammengefasst.

Verkäufer können auch Ressourcen ohne Tags zu einem einzigen Ressourcen UsageAllocation mit der zugewiesenen Nutzungsmenge zusammenfassen und diese als einen der Einträge einsendenUsageAllocations.

Zu den Beschränkungen gehören:

Zu den Validierungen gehören:

Käufererlebnis

Die folgende Tabelle zeigt ein Beispiel für das Einkaufserlebnis, nachdem ein Käufer die Tags AccountId und die BusinessUnit Lieferanten-Tags aktiviert hat.

In diesem Beispiel kann der Käufer die zugewiesene Nutzung in seinem Kostennutzungsbericht sehen. Die Tags mit Lieferantenzählung verwenden das Präfix. “aws:marketplace:isv” Käufer können sie in der Billing and Cost Management unter „AWS Kostenverrechnungs-Tags“ aktivieren.

Die erste und letzte Zeile des Kostennutzungsberichts beziehen sich auf das, was der Verkäufer an den Messdienst sendet (wie im Erfahrung des Verkäufers Beispiel gezeigt).

Ein Codebeispiel finden Sie unter MeterUsageCodebeispiel mit Kennzeichnung der Verwendungszuweisung (optional).

Codebeispiel

Das folgende Codebeispiel soll Ihnen helfen, Ihr Container-Produkt mit den für die Veröffentlichung und Wartung Ihres Produkts AWS Marketplace APIs erforderlichen Komponenten zu integrieren.

MeterUsageCodebeispiel mit Kennzeichnung der Verwendungszuweisung (optional)

Das folgende Codebeispiel ist relevant für Containerprodukte mit Verbrauchspreismodellen. Das Python-Beispiel sendet einen Messdatensatz mit entsprechenden Nutzungszuweisungs-Tags an AWS Marketplace , um Ihren Kunden pay-as-you-go Gebühren in Rechnung zu stellen.

# NOTE: Your application will need to aggregate usage for the 
#       customer for the hour and set the quantity as seen below. 
#       AWS Marketplace can only accept records for up to an hour in the past. 
#
# productCode is supplied after the AWS Marketplace Ops team has 
# published the product to limited

# Import AWS Python SDK
import boto3
import time

usageRecord = [
    { 
        "AllocatedUsageQuantity": 2, 
        "Tags": 
            [ 
                { "Key": "BusinessUnit", "Value": "IT" },
                { "Key": "AccountId", "Value": "123456789" },
            ]

    },
    { 
        "AllocatedUsageQuantity": 1, 
        "Tags": 
            [ 
                { "Key": "BusinessUnit", "Value": "Finance" },
                { "Key": "AccountId", "Value": "987654321" },
            ]

    }
]

marketplaceClient = boto3.client("meteringmarketplace")

response = marketplaceClient.meter_usage(
    ProductCode="testProduct",
    Timestamp=int(time.time()),
    UsageDimension="Dimension1",
    UsageQuantity=3,
    DryRun=False,
    UsageAllocations=usageRecord 
)

Weitere Informationen zu MeterUsage finden Sie MeterUsagein der AWS Marketplace Metering Service APIReferenz.

Beispielantwort

{ "MeteringRecordId": "string" }