

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.

# Integrationen für die Abrechnung, Messung und Lizenzierung von Container-Produkten
<a name="container-products-billing-integration"></a>

AWS Marketplace lässt sich in andere Systeme integrieren AWS-Services , um sowohl die Abrechnung als auch die vertragsbasierte Preisgestaltung für Ihr Container-Produkt bereitzustellen. Bei containerbasierten Produkten mit nutzungsabhängiger Preisgestaltung können Sie den sowohl [AWS Marketplace Metering Service](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html)für die Überprüfung der Nutzungsberechtigung Ihres Produkts als auch für die Messung der Nutzung für die Abrechnung verwenden. Bei containerbasierten Produkten mit Vertragspreisen können Sie die verwenden, um Ihrem Produkt Lizenzen AWS License Manager zuzuordnen. In den folgenden Abschnitten finden Sie weitere Informationen zur stündlichen und kundenspezifischen Abrechnung sowie zur Preisgestaltung mit AWS Marketplace Metering Service Verträgen. AWS License Manager

**Topics**
+ [Stündliche und benutzerdefinierte Messung mit AWS Marketplace Metering Service](#entitlement-and-metering-for-paid-products)
+ [Vertragliche Preisgestaltung mit AWS License Manager](#container-products-contracts-license-manager)
+ [Konfiguration der stündlichen Messung mit dem AWS Marketplace Metering Service](container-metering-registerusage.md)
+ [Konfiguration der benutzerdefinierten Messung für Containerprodukte mit dem AWS Marketplace Metering Service](container-metering-meterusage.md)
+ [Vertragspreise für Containerprodukte mit AWS License Manager](container-license-manager-integration.md)

## Stündliche und benutzerdefinierte Messung mit AWS Marketplace Metering Service
<a name="entitlement-and-metering-for-paid-products"></a>

Nutzen Sie den [Messservice, um sowohl die Nutzungsberechtigung Ihres Produkts als auch die Nutzung der AWS Marketplace Messgeräte](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html) für die Abrechnung zu überprüfen. Wenn Sie Ihre eigenen Preiseinheiten definieren und uns diese Nutzung für die Abrechnung berechnen möchten, können Sie die Integration mithilfe der [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)API-Operation durchführen. Wenn Sie den Preis für Ihr Produkt auf der Grundlage der Anzahl der verwendeten Aufgaben oder Pods festlegen und diese AWS Nutzung automatisch berechnen lassen möchten, integrieren Sie es mithilfe der [RegisterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_RegisterUsage.html)API-Operation. Für beide Preisarten können Sie einen langfristigen Vertragspreis hinzufügen, ohne die Art der Integration zu ändern AWS Marketplace Metering Service.

Wenn Sie in der ein neues Containerprodukt erstellen AWS Marketplace Management Portal, stellen wir Ihnen eine Reihe von Produktkennzeichnungen (den Produktcode und den öffentlichen Schlüssel) zur Verfügung, die für die Integration Ihres Produkts in den AWS Marketplace Metering Service verwendet werden.

### Berechtigung
<a name="seller-container-entitlement"></a>

Durch die Integration mit AWS Marketplace Metering Service können Sie überprüfen, ob der Kunde, auf dem Ihre kostenpflichtige Software ausgeführt wird, Ihr Produkt abonniert hat AWS Marketplace, sodass Sie beim Start des Containers vor unbefugter Nutzung geschützt sind. Um den Anspruch zu überprüfen, verwenden Sie je nach Preismodell die Operationen [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)oder [RegisterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_RegisterUsage.html)API. Verwenden Sie für stündliche und feste monatliche Preismodelle den `RegisterUsage` API-Vorgang. Verwenden Sie für Preismodelle mit benutzerdefinierter Zählermessung den `MeterUsage` API-Vorgang.

Wenn ein Käufer keinen Anspruch auf Ihr Produkt hat, geben diese API-Operationen die `CustomerNotEntitledException` 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
<a name="integration-guidelines"></a>

Beachten Sie die folgenden Richtlinien, wenn Sie Ihre Container-Produkte erstellen und veröffentlichen und die `MeterUsage` oder `RegisterUsage` API-Operationen für die Lizenzierung und Abrechnung verwenden:
+ Konfigurieren Sie keine AWS Anmeldeinformationen in Ihrer Software oder im Docker-Container-Image. AWS Anmeldeinformationen für den Käufer werden automatisch zur Laufzeit abgerufen, wenn Ihr Container-Image innerhalb einer Amazon ECS-Aufgabe oder eines Amazon EKS-Pods ausgeführt wird.
+  Um die `MeterUsage` oder `RegisterUsage` API-Operationen von Amazon EKS aus aufzurufen, müssen Sie [ein unterstütztes AWS SDK verwenden](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts-minimum-sdk.html). Um Amazon EKS zu testen `MeterUsage` oder zu `RegisterUsage` integrieren, müssen Sie einen Amazon EKS-Cluster mit Kubernetes 1.13.x oder höher ausführen. Kubernetes 1.13 ist für AWS Identity and Access Management (IAM-) Rollen für die Pod-Unterstützung erforderlich. IAM-Rollen sind erforderlich, damit der laufende Pod die AWS 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 auf AWS Container-Services (Amazon ECS, Amazon EKS und Fargate) starten.

### Unterstützt AWS-Regionen
<a name="supported-regions-metering"></a>

Eine Liste aller AWS Marketplace unterstützten AWS-Regionen Produkte finden Sie in der [Regionentabelle](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) auf der Global Infrastructure-Website.

#### Beschaffung der AWS-Region für die Messung
<a name="metering-aws-region-configuration"></a>

Wenn Sie Ihren Container für die Messung entweder in den API-Betrieb `MeterUsage` oder in den `RegisterUsage` API-Betrieb integrieren, konfigurieren Sie das AWS SDK nicht für die Verwendung eines bestimmten AWS-Region. Die Region muss dynamisch zur Laufzeit abgerufen werden. 

**Example**  
Ein Kunde startet beispielsweise eine Amazon ECS-Task oder einen Amazon EKS-Pod. Der `RegisterUsage` API-Vorgang wird in einer Region aufgerufen, die sich von der Region unterscheidet, in der die Amazon ECS-Task oder der Amazon EKS-Pod gestartet wurde. Daher gibt der `RegisterUsage` API-Vorgang einen `InvalidRegionException` Fehler aus.



AWS SDK-Sprachen bestimmen das `AWS_REGION` nicht auf konsistente Weise. Wenn Ihr SDK das nicht automatisch erkennt`AWS_REGION`, muss die Software manuell geschrieben werden, um das zu ermitteln`AWS_Region`. Beispielsweise verwendet der AWS SDK für Java automatisch [Amazon EC2 EC2-Instance-Metadaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) (insbesondere`ec2InstanceMetadata`), um die Region abzurufen, wenn Umgebungsvariablen oder andere Konfigurationen nicht vorhanden sind. Rufen Sie in diesem Fall nur `ec2InstanceMetadata` auf, wenn die `AWS_REGION`-Umgebungsvariable nicht vorhanden ist.

Informationen zum dynamischen Abrufen eines zur AWS-Region Laufzeit finden Sie im [AWS SDK Developer Guide](https://aws.amazon.com/tools) für Ihre Programmiersprache.

### Verhindern von Änderungen an der Gebührenerfassung
<a name="prevent-metering-modification"></a>

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. Es wird dringend empfohlen, die Mess- und Berechtigungslogik zu integrieren.

Wenn Sie Ihr Produkt so konstruieren, dass eine Änderung der Messwerte verhindert wird, sollten Sie Folgendes berücksichtigen:
+ Wenn Käufer neue Bildebenen einfügen können, die unsere `ENTRYPOINT` Anweisungen enthalten`CMD`, integrieren Sie `RegisterUsage` oder direkt `MeterUsage` in die Software, mit der der Käufer Ihr Container-Image durchläuft. Andernfalls werden Aufrufe, die über `RegisterUsage` `CMD` oder `ENTRYPOINT` über das Basis-Image `MeterUsage` ausgeführt werden, wahrscheinlich vom Käufer außer Kraft gesetzt.
+ Wir empfehlen Ihnen, die AWS Marketplace Produktcodes, die Ihre Software als Eingabe verwendet, so zu `RegisterUsage` verwalten, dass Käufer sie nicht ändern können. `MeterUsage` Wenn Ihr Produkt Produktcodes jedoch so verwaltet, dass Kunden sie überschreiben können AWS CloudFormation, wie z. B. Helm Chart oder Kubernetes-Manifest, müssen Sie eine Liste *vertrauenswürdiger* AWS Marketplace Produktcodes führen. Dadurch wird sichergestellt, dass der Produktcode, an den Ihre Software als Eingabe weitergibt `RegisterUsage` oder gültig `MeterUsage` 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.

## Vertragliche Preisgestaltung mit AWS License Manager
<a name="container-products-contracts-license-manager"></a>

Bei containerbasierten Produkten mit Vertragspreisen verknüpfen Sie AWS License Manager damit Lizenzen mit Ihrem Produkt. 

AWS License Manager ist ein Lizenzverwaltungstool, mit dem Ihre Anwendung Lizenzen (auch als Berechtigungen bezeichnet), die von einem Kunden gekauft wurden, verfolgen und aktualisieren kann. Dieser Abschnitt enthält Informationen zur Integration Ihres Produkts mit AWS License Manager. Nach Abschluss der Integration können Sie Ihre Produktliste am veröffentlichen AWS Marketplace.

Weitere Informationen zu AWS License Manager finden Sie im [AWS License Manager Benutzerhandbuch](https://docs.aws.amazon.com/license-manager/latest/userguide/license-manager.html) und im [AWS License Manager](https://docs.aws.amazon.com/cli/latest/reference/license-manager/index.html)Abschnitt der *AWS CLI Befehlsreferenz*.

**Anmerkung**  
Kunden können nach Ablauf des Vertrags 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 ausgeführt wird, kann die Lizenz auschecken, sofern ihr die zugewiesenen AWS Anmeldeinformationen vorliegen.
**Erstellung von privaten Angeboten** — Verkäufer können mithilfe des Tools zur Erstellung privater Angebote in der private Angebote private Angebote für die Produkte erstellen AWS Marketplace Management Portal.
**Berichterstattung** — Sie können Datenfeeds einrichten, indem Sie im **Berichtsbereich** in der einen Amazon S3 S3-Bucket einrichten AWS Marketplace Management Portal. Weitere Informationen finden Sie unter [Verkäuferberichte, Datenfeeds und Dashboards in AWS Marketplace](reports-and-data-feed.md).

### Arbeitsablauf bei der Integration
<a name="container-LM-LM-workflow"></a>

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

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

1. Der Verkäufer listet das Produkt auf AWS Marketplace.

1. Der Käufer findet das Produkt auf AWS Marketplace und kauft es.

1. Eine Lizenz wird dem Käufer in seiner Datei zugeschickt AWS-Konto.

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

1. Die Software liest die Lizenz im AWS License Manager Konto des Käufers, ermittelt die erworbenen Rechte und stellt die Funktionen entsprechend bereit. 
**Anmerkung**  
License Manager führt keine Nachverfolgung oder Updates durch. Dies erfolgt über die Anwendung des Verkäufers.