Konfiguration der Stundenzählung mit AWS Marketplace Metering Service - AWS Marketplace
Voraussetzungen für die StundenmessungProduktladeformular für die StundenmessungTesten der Integration und des Vorschaumodus für RegisterUsageFehlerbehandlung für RegisterUsage

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 Stundenzählung mit AWS Marketplace Metering Service

Wenn für Ihr Container-Produkt eine Preisgestaltung pro Stunde pro Aufgabe oder pro Pod anstelle von kundenspezifischen Preisdimensionen verwendet wird, müssen Sie keine benutzerdefinierten Abmessungen für die Messung definieren. Sie können den AWS Marketplace Metering Service für die stündliche Messung mit Containerprodukten verwenden AWS Marketplace. In den folgenden Abschnitten erfahren Sie, wie Sie die stündliche Messung mit dem AWS Marketplace Metering Service konfigurieren.

Der RegisterUsage API Betrieb misst die Softwarenutzung pro Amazon Elastic Container Service (AmazonECS) -Aufgabe oder pro Amazon Elastic Kubernetes Service (AmazonEKS) -Pod pro Stunde, wobei die Nutzung auf die Sekunde aufgeteilt wird. Auf nur kurz ausgeführte Aufgaben oder Pods wird ein Minimum von 1 Minute angewendet. Die kontinuierliche Messung der Softwarenutzung erfolgt automatisch durch AWS Marketplace Metering Control Plane. Ihre Software muss keine spezifischen Aktionen zur Erfassung der Softwarenutzung ausführen, es sei denn, Sie rufen RegisterUsage einmal auf, damit die Messung der Softwarenutzung beginnt.

RegisterUsagemuss sofort beim Starten eines Containers aufgerufen werden. Wenn Sie den Container nicht in den ersten 6 Stunden nach dem Start des Containers registrieren, bietet AWS Marketplace Metering Service keine Messgarantien für frühere Monate. Die Messung wird jedoch für den laufenden Monat fortgesetzt, bis der Container endet.

Die AWS Marketplace Metering Control Plane stellt Kunden weiterhin die Ausführung von ECS Amazon-Aufgaben und EKS Amazon-Pods in Rechnung, unabhängig vom Abonnementstatus des Kunden. Dadurch muss Ihre Software nach dem ersten erfolgreichen Start der Aufgabe oder des Pods keine Berechtigungsprüfungen mehr durchführen.

Themen

Voraussetzungen für die Stundenmessung

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

  1. Erstellen Sie ein neues Containerprodukt in der AWS Marketplace Management Portal, und notieren Sie sich den zugehörigen Produktcode.

    Weitere Informationen finden Sie unter Überblick: Erstellen Sie ein Container-Produkt.

  2. Verwenden Sie eine AWS Identity and Access Management (IAM) -Rolle für die Aufgabe oder den Pod, auf dem Ihre Anwendung ausgeführt wird, mit den zum Aufrufen erforderlichen IAM BerechtigungenRegisterUsage. Die IAM verwaltete Richtlinie AWSMarketplaceMeteringRegisterUsage verfügt über diese Berechtigungen.

  3. (Optional) Wenn Sie die Protokollierung sehen möchten, empfehlen wir, die AWS CloudTrail Protokollierung in der Aufgaben- oder Pod-Definition zu aktivieren.

  4. Führen Sie einen Testaufruf RegisterUsage API mit einem Datensatz für alle von Ihnen definierten Preisdimensionen durch.

Produktladeformular für die Stundenmessung

Füllen Sie beim Ausfüllen des Produktladeformulars für die stündliche Messung zusätzlich zu den anderen erforderlichen und optionalen Feldern, die Ihr Produkt definieren, die folgenden Felder für Ihr Produkt aus:

  • Stundenpreis — Der Preis für Ihr Produkt pro Stunde.

  • Dimension Long Term Rate — Der gesamte Softwarepreis für einen langfristigen Vertrag, wenn Käufer im Voraus zahlen.

  • Langfristige Laufzeit (Tage) — Die Dauer des langfristigen Vertrags in Tagen.

Testen der Integration und des Vorschaumodus für RegisterUsage

Verwenden Sie diesen RegisterUsage API 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 RegisterUsage im Vorschaumodus aufzurufen, rufen Sie RegisterUsage vom Container-Image aus auf, indem Sie Ihr Produkt bei Amazon ECS oder Amazon ausführenEKS. Verwenden Sie AWS-Konto das, auf dem Sie das Produkt anbieten AWS Marketplace. Ihre Messintegration 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). Auf diese Weise kann das AWS Marketplace Betriebsteam Ihre Arbeit anhand der Protokolle in dieser Region überprüfen.

Anmerkung

Wenn Ihr Produkt ECS sowohl Amazon als auch Amazon unterstütztEKS, müssen Sie es nur bei Amazon starten, EKS damit wir Ihre Integration validieren können.

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 Team für den AWS Marketplace Katalogbetrieb den Eingang Ihrer Messdaten im Vorschaumodus überprüfen.

Fehlerbehandlung für RegisterUsage

Wenn Ihr Container-Image in das integriert ist AWS Marketplace Metering Service und eine Ausnahme auftrittThrottlingException, sollten Sie den Container beenden, um eine unbefugte Verwendung zu verhindern.

Andere Ausnahmen als ThrottlingException werden nur beim ersten Aufruf des RegisterUsage API Vorgangs 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 nach dem Abbestellen weiterhin der Betrieb von Containern in Rechnung gestellt, und ihre Nutzung wird nachverfolgt.

In der folgenden Tabelle werden die Fehler beschrieben, die durch den RegisterUsage API Vorgang ausgelöst werden können. Für jede AWS SDK Programmiersprache gibt es eine Reihe von Richtlinien zur Fehlerbehandlung, in denen Sie weitere Informationen finden können.

Fehler Beschreibung
InternalServiceErrorException RegisterUsage ist nicht verfügbar.
CustomerNotEntitledException Der Kunde verfügt über kein gültiges Abonnement für das Produkt.
InvalidProductCodeException Der als Teil der Anforderung übergebene ProductCode-Wert ist nicht vorhanden.
InvalidPublicKeyException Der als Teil der Anforderung übergebene PublicKeyVersion-Wert ist nicht vorhanden.
PlatformNotSupportedException AWS Marketplace unterstützt nicht die Messung der Nutzung von der zugrunde liegenden Plattform aus. Nur Amazon ECSEKS, Amazon und E AWS Fargate werden unterstützt.
ThrottlingException Die Aufrufe von RegisterUsage werden gedrosselt.
InvalidRegionException RegisterUsagemuss in derselben Weise aufgerufen werden, in der AWS-Region die ECS Amazon-Aufgabe oder der EKS Amazon-Pod gestartet wurde. Damit wird verhindert, dass ein Container eine Region (beispielsweise withRegion(“us-east-1”)) auswählt, wenn RegisterUsage aufrufen wird.