Integrationen für Abrechnung, Messung und Lizenzierung von Container-Produkten

AWS Marketplacelässt sich mit anderen kombinierenAWS-Services, um sowohl die Messung als auch die vertraglich vereinbarte Preisgestaltung für Ihr Containerprodukt bereitzustellen.

Stündliche und benutzerdefinierte Zählung mitAWS Marketplace Metering Service

Verwenden Sie den AWS MarketplaceMetering Service, um sowohl zu überprüfen, ob Sie berechtigt sind, Ihr Produkt zu nutzen, als auch, um die Nutzung für die Abrechnung zu messen. Wenn Sie Ihre eigenen Preiseinheiten definieren und diese Nutzung an uns für die Abrechnung weiterleiten möchten, integrieren Sie dies mithilfe der MeterUsageAPI-Operation. Wenn Sie den Preis für Ihr Produkt auf der Grundlage der Anzahl der verwendeten Tasks oder Pods festlegen und dieseAWS Nutzung automatisch messen lassen möchten, integrieren Sie es mithilfe der RegisterUsageAPI-Operation. Für beide Preisarten können Sie einen langfristigen Vertragspreis hinzufügen, ohne die Art der Integration mit dem zu ändernAWS Marketplace Metering Service.

Wenn Sie ein neues Container-Produkt in der erstellenAWS Marketplace Management Portal, stellen wir eine Reihe von Produktkennzeichnungen (den Produktcode und den öffentlichen Schlüssel) zur Verfügung, die verwendet werden, um Ihr Produkt in den zu integrierenAWS Marketplace Metering Service.

Berechtigung

Durch die Integration mitAWS Marketplace Metering Service können Sie überprüfen, ob der Kunde, der Ihre kostenpflichtige Software ausführtAWS Marketplace, Ihr Produkt auf abonniert hat. So können Sie sich vor nicht autorisierter Nutzung schützen. Um die Berechtigung zu überprüfen, verwenden Sie je nach Preismodell die MeterUsageoder RegisterUsageAPI-Operationen. Verwenden Sie für Stundenmodelle und feste monatliche Preismodelle denRegisterUsage API-Vorgang. Verwenden Sie für benutzerdefinierte Messpreismodelle denMeterUsage API-Vorgang.

Wenn ein Käufer keinen Anspruch auf Ihr Produkt hat, geben diese API-Operationen dieCustomerNotEntitledException Ausnahme zurück.

Anmerkung

Wenn ein Käufer das Abonnement Ihres Produkts beendet, während er es betreibt, ist er berechtigt, es weiter zu betreiben. Sie können jedoch keine zusätzlichen Container für Ihr Produkt starten.

Integrationsrichtlinien

Beachten Sie bei der Erstellung und Veröffentlichung Ihrer Container-Produkte und der Verwendung derMeterUsageRegisterUsage API-Operationen für die Rechtevergabe und Abrechnung die folgenden Richtlinien:

• Konfigurieren Sie keineAWS Anmeldeinformationen in Ihrer Software oder im Docker-Container-Image. AWSDie Anmeldeinformationen für den Käufer werden zur Laufzeit automatisch abgerufen, wenn Ihr Container-Image innerhalb einer Amazon ECS-Aufgabe oder eines Amazon EKS-Pods ausgeführt wird.

• Um dieMeterUsageRegisterUsage Oder-API-Operationen von Amazon EKS aus aufzurufen, müssen Sie ein unterstütztesAWS SDK verwenden. Um Amazon EKS zu testenMeterUsage oder zuRegisterUsage integrieren, müssen Sie einen Amazon EKS-Cluster ausführen, auf dem Kubernetes 1.13.x oder höher ausgeführt wird. Kubernetes 1.13 ist fürAWS Identity and Access Management (IAM-) Rollen für die Pod-Unterstützung erforderlich. IAM-Rollen sind erforderlich, damit der laufende Pod dieAWS Anmeldeinformationen erhält, die zum Aufrufen dieser Aktionen auf Amazon EKS erforderlich sind.

• Sie können zwar eine lokale Entwicklung vornehmen, Sie werden jedoch eine PlatformNotSupportedException-Ausnahme erhalten. Diese Ausnahme tritt nicht auf, wenn Sie den Container aufAWS Container-Diensten (Amazon ECS, Amazon EKS und Fargate) starten.

Unterstützte AWS-Regionen

Eine Liste allerAWS Marketplace unterstütztenAWS-Regionen Regionen finden Sie in der Regionstabelle auf der Website Global Infrastructure.

Beschaffung derAWS-Region für die Messung

Wenn Sie Ihren Container für die Messung entweder mit demMeterUsage oder demRegisterUsage API-Vorgang integrieren, konfigurieren Sie dasAWS SDK nicht so, dass es einen bestimmten verwendetAWS-Region. Die Region muss dynamisch zur Laufzeit abgerufen werden.

Ein Kunde startet beispielsweise eine Amazon ECS-Aufgabe oder einen Amazon EKS-Pod. DerRegisterUsage API-Vorgang wird in einer Region aufgerufen, die sich von der Region unterscheidet, in der die Amazon ECS-Aufgabe oder der Amazon EKS-Pod gestartet wurde. Daher löst derRegisterUsage API-Vorgang einenInvalidRegionException Fehler aus.

AWSSDK-Sprachen bestimmen das nichtAWS_REGION auf konsistente Weise. Wenn Ihr SDK das nicht automatisch erkenntAWS_REGION, muss die Software manuell geschrieben werden, um das zu ermittelnAWS_Region. Beispielsweise verwendet erAWS SDK for Java automatisch Metadaten der Amazon EC2 EC2-Instance (insbesondereec2InstanceMetadata), um die Region abzurufen, wenn keine Umgebungsvariablen oder andere Konfigurationen vorhanden sind. Rufen Sie in diesem Fall nur ec2InstanceMetadata auf, wenn die AWS_REGION-Umgebungsvariable nicht vorhanden ist.

Informationen zum dynamischen Abrufen einer At-Runtime finden SieAWS-Region im AWS SDK Developer Guide für Ihre Programmiersprache.

Verhindern von Änderungen an der Gebührenerfassung

Das Einbringen von Möglichkeiten für Käufer, Aufrufe von RegisterUsage oder MeterUsage zu ändern oder zu überschreiben, könnte zu unerwünschten Abrechnungs- und Zahlungsproblemen führen. Wir empfehlen Ihnen dringend, die Zähmiger- und Berechtigungslogik zu integrieren.

Wenn Sie Ihr Produkt so entwickeln, dass Änderungen der Messung nicht, müssen Sie Folgendes beachten:

• Wenn Käufer neue Bildebenen einfügen können, die unsereENTRYPOINT Anweisungen enthaltenCMD, integrierenRegisterUsage oderMeterUsage integrieren Sie sie direkt in die Software, die der Käufer über Ihr Container-Image ausführt. Andernfalls hat der Käufer wahrscheinlich Vorrang vor Aufrufen, die über dasCMD oderENTRYPOINT vom Basis-Image ausMeterUsage ausgeführt werden.RegisterUsage

• Wir empfehlen Ihnen, dieAWS Marketplace Produktcodes, die Ihre Software als Eingabe verwendet,RegisterUsage oderMeterUsage so zu verwalten, dass Käufer sie nicht ändern können. Wenn Ihr Produkt Produktcodes jedoch so verwaltet, dass Kunden sie überschreiben können, z. B.AWS CloudFormation in einem Helm-Diagramm oder einem Kubernetes-Manifest, müssen Sie eine Liste vertrauenswürdigerAWS Marketplace Produktcodes führen. Dadurch wird sichergestellt, dass der Produktcode, den Ihre Software als EingabeRegisterUsage übergibt, gültigMeterUsage ist.

• Wenn einer Ihrer vertrauenswürdigen Produkt-Codes für kostenlose Produkte gilt, stellen Sie sicher, dass er nicht anstelle eines kostenpflichtigen Produkt-Codes verwendet werden kann.

Vertragspreise mitAWS License Manager

Für containerbasierte Produkte mit Vertragspreisen verwenden Sie,AWS License Manager um Ihrem Produkt Lizenzen zuzuordnen.

AWS License Managerist ein Lizenzverwaltungstool, mit dem Ihre Anwendung Lizenzen (auch als Berechtigungen bezeichnet), die von einem Kunden erworben wurden, nachverfolgen und aktualisieren kann. In diesem Abschnitt finden Sie Informationen dazu, wie Sie Ihr Produkt in integrierenAWS License Manager. Nach Abschluss der Integration können Sie Ihre Produktliste auf veröffentlichenAWS Marketplace.

Weitere InformationenAWS License Manager dazu finden Sie im AWS License ManagerBenutzerhandbuch und im AWS License ManagerAbschnitt der AWS CLIBefehlsreferenz.

Anmerkung

• Kunden können nach Ablauf der Vertragslaufzeit keine neuen Instances des Containers starten. Während der Vertragsdauer können sie jedoch eine beliebige Anzahl von Instances starten. Diese Lizenzen sind nicht an einen bestimmten Knoten oder eine bestimmte Instanz gebunden. Jede Software, die auf einem beliebigen Container auf einem beliebigen Knoten läuft, kann die Lizenz auschecken, sofern sie über die zugewiesenenAWS Anmeldeinformationen verfügt.

• Private Angebotserstellung — Verkäufer können private Angebote für die Produkte erstellen, indem sie das Tool zur Erstellung privater Angebote in der verwendenAWS Marketplace Management Portal.

• Berichterstattung — Sie können Datenfeeds einrichten, indem Sie im Abschnitt Bericht in der einen Amazon S3 S3-Bucket einrichtenAWS Marketplace Management Portal. Weitere Informationen finden Sie unter Verkäuferberichte, Datenfeeds und Dashboards.

Workflow zur Integration von Integra

Die folgenden Schritte zeigen den Arbeitsablauf für die Integration Ihres Container-Produkts mitAWS License Manager:

1. Der Verkäufer erstellt ein Produkt mitAWS License Manager Integration.

2. Der Verkäufer bietet das Produkt aufAWS Marketplace.

3. Der Käufer findet das Produkt aufAWS Marketplace und kauft es.

4. Eine Lizenz wird dem Käufer in seinemAWS-Konto.

5. Der Käufer verwendet die Software, indem er die Amazon EC2 EC2-Instance, die Amazon ECS-Aufgabe oder die Amazon EKS-Pod-Software startet. Der Kunde verwendet für die Bereitstellung eine IAM-Rolle.

6. Die Software liest die Lizenz imAWS License Manager Konto des Käufers, ermittelt die erworbenen Rechte und stellt die Funktionen entsprechend bereit.

   Anmerkung

   License Manager führt keine Nachverfolgung oder Aktualisierungen durch. Dies erfolgt durch die Anwendung des Verkäufers.