Zuordnen von Lizenzen zu AMI-basierten Produkten mithilfe von AWS License Manager - AWS Marketplace
LizenzmodelleArbeitsablauf bei der IntegrationVoraussetzungen für die License Manager Manager-IntegrationIntegration eines AMI-basierten Produkts mit AWS License ManagerVerlängerungen und Upgrades von Lizenzen

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.

Zuordnen von Lizenzen zu AMI-basierten Produkten mithilfe von AWS License Manager

Für auf Amazon Machine Image (AMI) basierende Produkte mit Vertragspreisen können Sie AWS License Manager verwenden, um Lizenzen mit Ihrem Produkt zu verknüpfen. 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. Nach Abschluss der Integration können Sie Ihre Produktliste am AWS Marketplace veröffentlichen. In den folgenden Abschnitten finden Sie weitere Informationen dazu AWS License Manager , wie Sie Lizenzen mit Ihrem AMI-basierten Produkt verknüpfen können.

Weitere Informationen AWS License Manager dazu finden Sie im AWS License Manager Benutzerhandbuch und im AWS License ManagerAbschnitt der AWS CLI Befehlsreferenz.

Weitere Informationen zur Integration AWS License Manager mit AMI-basierten Produkten mit Vertragspreisen finden Sie im Labor „Liste der AMI-Produkte mit Vorauszahlung“ der AWS Marketplace Verkäuferwerkstatt.

Anmerkung

  • Kunden können nach Ablauf des Vertrags keine neuen AMI-Instanzen mehr starten. Während der Vertragsdauer können sie jedoch eine beliebige Anzahl von Instances starten. Diese Lizenzen sind nicht knotengebunden oder an bestimmte Instanzen gebunden.

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

Lizenzmodelle

AWS Marketplace Integration mit AWS License Manager unterstützt zwei Lizenzmodelle:

Konfigurierbares Lizenzmodell

Das konfigurierbare Lizenzmodell (auch als quantifizierbares Lizenzmodell bezeichnet) berechtigt einen Käufer zu einer bestimmten Menge an Ressourcen, nachdem er eine Lizenz erworben hat.

Sie legen eine Preisdimension und einen Preis pro Einheit fest. Anschließend kann der Käufer die Menge der Ressourcen wählen, die er kaufen möchte.

Beispiel nach Preisgröße und Preis pro Einheit

Sie können eine Preisdimension (z. B. Datensicherung) und einen Preis pro Einheit (z. B. 30 USD/Einheit) festlegen

Der Käufer kann wählen, ob er 5, 10 oder 20 Einheiten kaufen möchte.

Ihr Produkt verfolgt und misst den Verbrauch, um die Menge der verbrauchten Ressourcen zu messen.

Beim Konfigurationsmodell werden die Berechtigungen auf eine von zwei Arten gezählt:

Drawdown-Lizenzen

Die Lizenz wird bei der Nutzung aus dem Pool der zulässigen Anzahl an Lizenzen entnommen. Diese Berechtigung ist dauerhaft ausgecheckt und kann nicht wieder in den Lizenzpool aufgenommen werden.

Beispiel der Verarbeitung einer begrenzten Datenmenge

Ein Benutzer ist berechtigt, 500 GB Daten zu verarbeiten. Während sie weiterhin Daten verarbeiten, wird die Menge aus dem Pool von 500 GB entnommen, bis alle 500-GB-Lizenzen aufgebraucht sind.

Bei Drawdown-Lizenzen können Sie den CheckoutLicense API-Vorgang verwenden, um verbrauchte Lizenzeinheiten auszuchecken.

Beispiel von Backups auf S3 für eine bestimmte Anzahl von Einheiten/Jahr

Sie haben ein Speicherprodukt, das die Sicherung von Daten auf Amazon Simple Storage Service (Amazon S3) für bis zu 1024 Einheiten für ein Jahr ermöglicht. Ihre Anwendung kann mithilfe mehrerer EC2 Amazon-Instances gestartet werden. Ihre Anwendung verfügt über einen Mechanismus zum Verfolgen und Aggregieren von Daten. Ihre Software ruft den CheckoutLicense API-Vorgang mit der Produkt-ID bei jedem Backup oder in festen Intervallen auf, um die verbrauchten Mengen zu aktualisieren.

In diesem Beispiel ruft Ihre Software auf, CheckoutLicense um 10 Dateneinheiten auszuchecken. Wenn die Gesamtkapazität das vom Kunden gekaufte Backup-Limit erreicht, schlägt der API-Aufruf fehl.

Anforderung

linux-machine ~]$ aws license-manager checkout-license\
--product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \
--checkout-type "PERPETUAL" \
--key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \
--entitlements "Name=DataConsumption, Value=l0, Unit=Count" \
--client-token "AKIAIOSFODNN7EXAMPLE"

Antwort

{
  "CheckoutType": "PERPETUAL",
  "EntitlementsAllowed": [
    {      
      "Name": "DataConsumption", 
      "Count": 10,
      "Units": "Count",
      "Value": "Enabled"
    }
},
  "Expiration":    "2021-04-22Tl9:02: 36",
  "IssuedAt": "2021-04-22Tl8:02:36",
  "LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...",
  "LicenseConsumptionToken":  "AKIAIOSFODNN7EXAMPLE"
}

Flexible Lizenzen

Die Lizenz wird nach der Verwendung wieder in den Pool mit der zulässigen Anzahl an Lizenzen zurückgeführt.

Beispiel der Anzahl der Benutzer ab einer festen Obergrenze

Ein Benutzer hat Anspruch auf 500 gleichzeitige Benutzer in der Anwendung. Wenn sich Benutzer an- und abmelden, werden die Benutzer gezogen und wieder dem Pool von 500 Benutzern zugewiesen. Die Anwendung kann jedoch nicht mehr als 500 Benutzer aus dem Pool ziehen, da 500 gleichzeitige Benutzer die feste Obergrenze sind.

Bei variablen Lizenzen können Sie den CheckInLicense API-Vorgang verwenden, um die Lizenzeinheiten an den Berechtigungspool zurückzugeben.

Beispiel der Anzahl gleichzeitiger Benutzer für ein Jahr

Der Preis Ihres Produkts basiert auf der Anzahl der gleichzeitigen Benutzer. Der Kunde erwirbt eine Lizenz für 10 Benutzer für ein Jahr. Der Kunde startet die Software, indem er AWS Identity and Access Management (IAM-) Berechtigungen erteilt. Wenn sich ein Benutzer anmeldet, ruft Ihre Anwendung den CheckoutLicense API-Vorgang auf, um die Menge um 1 zu reduzieren. Wenn sich der Benutzer abmeldet, gibt die Anwendung diese Lizenz an den Pool zurück, indem sie den CheckInLicense API-Vorgang aufruft. Wenn Sie nicht anrufenCheckInLicense, wird die Lizenzeinheit nach 1 Stunde automatisch eingecheckt.

Anmerkung

In der folgenden Anfrage handelt es sich key-fingerprint nicht um einen Platzhalterwert, sondern um den tatsächlichen Wert des Fingerabdrucks, mit dem alle Lizenzen veröffentlicht werden.

Anforderung

linux-machine ~]$ aws license-manager checkout-license\
--product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \
--checkout-type "PROVISIONAL" \
--key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \
--entitlements "Name=ReadOnlyUSers, Value=l0, Unit=Count" \
--client-token "AKIAIOSFODNN7EXAMPLE"

Antwort

{
  "CheckoutType": "PROVISIONAL",
  "EntitlementsAllowed": [
    {
      "Name": "ReadOnlyUsers", 
      "Count": 10,
      "Units": "Count",
      "Value": "Enabled"
    }
},
  "Expiration": "2021-04-22Tl9:02: 36",
  "IssuedAt": "2021-04-22Tl8:02:36",
  "LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...",
  "LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE"
}

Gestaffeltes Lizenzmodell

Das gestaffelte Lizenzmodell berechtigt einen Käufer, eine bestimmte Stufe oder Stufe von Anwendungsfunktionen zu nutzen, nachdem der Käufer eine Lizenz erworben hat.

Sie erstellen Stufen für Ihr Produkt, z. B. Basic, Intermediate und Premium. Der Käufer wählt dann eine der vordefinierten Stufen aus.

Die Anwendung muss die Nutzung der Anwendung nicht verfolgen oder messen.

Beim abgestuften Lizenzmodell werden die Berechtigungen nicht mitgezählt, sondern stehen für eine vom Kunden bereitgestellte Servicestufe.

Wenn Sie gebündelte Funktionen anbieten möchten, empfehlen wir die Verwendung des gestaffelten Lizenzmodells.

Beispiel der Tarife Basic, Intermediate und Premium

Ein Kunde kann einen Vertrag für eine von drei möglichen Stufen der Software unterzeichnen: Basic, Intermediate oder Premium. Jede dieser Stufen hat ihre eigenen Preise. Ihre Software kann die Stufe identifizieren, für die sich der Kunde angemeldet hat, indem sie den CheckoutLicense API-Vorgang aufruft und alle möglichen Stufen in der Anfrage angibt.

Die Antwort auf die Anfrage enthält den Anspruch, der der Stufe entspricht, die der Kunde erworben hat. Auf der Grundlage dieser Informationen kann die Software das entsprechende Kundenerlebnis bieten.

Anforderung

linux-machine  ~]$ aws  license-manager   checkout-license\
--product-sku  "2205b290-19e6-4c76-9eea-377d6bf7la47"  \
--checkout-type  "PROVISIONAL"  \
--key-fingerprint  "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \
--entitlements  "Name=BasicTier,  Unit=None"   "Name=IntermediateTier,  Unit=None"	\ "Name=PremiumTier, Unit=None"

Antwort

{ 
  "CheckoutType": "PROVISIONAL",
  "EntitlementsAllowed": [
    {
      "Name": "IntermediateTier", 
      "Units": "None"
    }
},
  "Expiration": "2021-04-22Tl9:02:36",
  "IssuedAt": "2021-04-22Tl8:02:36",
  "LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...",
  "LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE"
}

Arbeitsablauf bei der Integration

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

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

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

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

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

  5. Der Käufer verwendet die Software, indem er die Amazon Elastic Compute Cloud (Amazon EC2) -Instance, die Amazon Elastic Container Service (Amazon ECS) -Task oder die Amazon Elastic Kubernetes Service (Amazon EKS) -Pod-Software startet. Der Kunde verwendet für die Bereitstellung eine IAM-Rolle.

  6. 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.

Voraussetzungen für die License Manager Manager-Integration

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

  1. Erstellen Sie ein neues AMI-Produkt in der AWS Marketplace Management Portal und notieren Sie sich dessen Produktcode.

  2. Füllen Sie das Product Load Form (PLF) mit den erforderlichen Preisinformationen aus und senden Sie es zur Bearbeitung an uns zurück.

  3. Verwenden Sie eine IAM-Rolle für die Aufgabe oder den Pod, auf dem Ihre Anwendung ausgeführt wird, mit den IAM-Berechtigungen, die zum Aufrufen vonCheckoutLicense, ExtendLicenseConsumption und erforderlich sind. CheckInLicense

    Die erforderlichen IAM-Berechtigungen werden in der folgenden IAM-Richtlinie detailliert beschrieben.

    {
   "Version":"2012-10-17",
   "Statement":[
      {
         "Sid":"VisualEditorO",
         "Effect":"Allow",
         "Action":[
            "license-manager:CheckoutLicense",
            "license-manager:GetLicense",
            "license-manager:CheckInLicense",
            "license-manager:ExtendLicenseConsumption",
            "license-manager:ListReceivedLicenses"
         ],
         "Resource":"*"
      }
   ]
}

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

Integration eines AMI-basierten Produkts mit AWS License Manager

Sie können Ihr AMI-basiertes Produkt mithilfe der API in License Manager integrieren. AWS License Manager Starten Sie die EC2 Amazon-Instances mithilfe von AWS Marketplace AMI-basierten Produkten.

Anmerkung

Stellen Sie sicher, dass Sie das abgeschlossen haben, Voraussetzungen für die License Manager Manager-Integration bevor Sie das folgende Verfahren durchführen.

Um Ihr AMI-basiertes Produkt mit License Manager zu integrieren

  1. Schließen Sie das Verfahren in a Testlizenz im License Manager erstellen. Sie müssen im License Manager eine Testlizenz erstellen, um Ihre Integration zu testen.

  2. Führen Sie den GetLicenseAPI-Vorgang mit der Lizenz Amazon Resource Name (ARN) aus, die Sie in Schritt 1 erworben haben. Notieren Sie sich den Wert des KeyFingerprint Attributs der GetLicense Antwort für die spätere Verwendung.

  3. Laden Sie das neueste öffentliche AWS SDK herunter und fügen Sie es in Ihre Anwendung ein.

  4. Um zu überprüfen, ob der Käufer berechtigt ist, eine Lizenz für Ihre Anwendung zu verwenden, führen Sie den CheckoutLicenseAPI-Vorgang aus. Verwenden Sie die Berechtigungsdetails und den Schlüsselfingerabdruck der Testlizenz, die Sie in Schritt 1 erhalten haben.

    Wenn für die Lizenz keine Berechtigungen gefunden wurden oder die maximale Anzahl von Berechtigungen überschritten wurde, kehrt der CheckoutLicense API-Vorgang zurück. NoEntitlementsAllowedException Wenn die Berechtigungen gültig sind oder verwendet werden können, gibt der CheckoutLicense Vorgang eine erfolgreiche Antwort mit den angeforderten Berechtigungen und ihren Werten zurück.

  5. (Nur für variable Berechtigungen erforderlich) Führen Sie den CheckinLicenseAPI-Vorgang unter Verwendung der in der Antwort LicenseConsumptionToken empfangenen Daten aus. CheckoutLicense Durch diese Aktion werden zuvor ausgecheckte Berechtigungen wieder in den Pool verfügbarer Berechtigungen aufgenommen.

  6. Nachdem Sie die License Manager Manager-Integration mit der Testlizenz, die Sie in Schritt 1 erstellt haben, erfolgreich verifiziert haben, aktualisieren Sie den Schlüsselfingerabdruck in Ihrem Code aufaws:294406891311:AWS/Marketplace:issuer-fingerprint. Jetzt können Sie mit den Lizenzen arbeiten, die von ausgestellt wurden AWS Marketplace.

Folgen Sie dem Freigabeprozess, um die Anwendung für ein AMI-Produkt zu erstellen, und reichen Sie das Produkt anschließend AWS Marketplace gemäß dem Produktveröffentlichungsprozess ein.

Testlizenz im License Manager erstellen

Sie verwenden Version 2 von AWS Command Line Interface (AWS CLI), um eine Testlizenz in zu erstellen AWS License Manager. Diese Testlizenz wird nur zur Überprüfung und zum Testen der AWS License Manager Integration verwendet. Nach Abschluss der Tests können Sie die Testlizenz löschen. Die eigentliche Lizenz wird AWS Marketplace mit einem anderen Schlüssel-Fingerabdruck generiert.

AWS Marketplace unterstützt zwei Arten von Berechtigungen in AWS License Manager. Für ein Produkt kann jedoch nur ein Typ aktiviert werden. Wenn Sie eine Lizenz, einschließlich einer Testlizenz, erstellen, müssen Sie eine der folgenden Arten von Berechtigungen angeben:

Gestaffelte Berechtigungen — Das gestaffelte Lizenzmodell berechtigt den Kunden zu bestimmten Anwendungsfunktionen. Kunden können die Anzahl der Einheiten, die sie kaufen möchten, nicht definieren. Sie können jedoch ein einzelnes vordefiniertes Paket oder eine einzelne Stufe auswählen. Kunden können den Vertrag später ändern, um eine andere Stufe zu abonnieren.

Konfigurierbare Berechtigungen — Das konfigurierbare Lizenzmodell gewährt Berechtigungen für eine bestimmte Anzahl von Ressourcen, wenn der Kunde eine Lizenz erwirbt. Der Kunde wählt während des Abonnementvorgangs die Anzahl der Einheiten aus, die er kaufen möchte. Die Abrechnung erfolgt auf der Grundlage des Einzelpreises. Kunden können auch mehrere Dimensionen abonnieren.

Die erforderlichen Parameter für die Verwendung im CheckoutLicense API-Vorgang lauten wie folgt:

  • CheckoutType— Die gültigen Werte sind Perpetual oderProvisional:

    • Perpetual— Wird verwendet, wenn die Anzahl der ausgecheckten Ansprüche aus dem Pool aufgebraucht ist. Beispiel: Der Käufer ist berechtigt, 500 GB an Daten zu verarbeiten. Bei der weiteren Verarbeitung der Daten wird die Menge aus dem Pool von 500 GB entnommen und ausgeschöpft. Ruft den Status einer gekauften Lizenz ab und gibt an, ob die Lizenz abgelaufen ist oder bald abläuft, um eine Benachrichtigung an den Kunden zu senden.

    • Provisional— Wird für variable Lizenzberechtigungen verwendet, bei denen Berechtigungen aus dem Pool ausgecheckt und nach Gebrauch zurückgegeben werden. Beispiel: Der Benutzer hat Anspruch auf 500 gleichzeitige Benutzer in der Anwendung. Wenn sich Benutzer an- und abmelden, werden die Benutzer gezogen und wieder dem Pool von 500 Benutzern zugewiesen. Weitere Informationen zu variablen Lizenzberechtigungen finden Sie unter Vom Verkäufer ausgestellte Lizenzen in AWS License Manager.

  • ClientToken— Eindeutige Kennung, bei der Groß- und Kleinschreibung berücksichtigt wird, um sicherzustellen, dass das genaue Ergebnis eintritt und dasselbe ist, unabhängig davon, wie oft es versucht wird. Wir empfehlen, für jede Anfrage einen zufälligen Universally Unique Identifier (UUID) zu verwenden.

  • Entitlements— Liste der Berechtigungen, die ausgecheckt werden müssen.

    • Geben Sie für gestaffelte Ansprüche die Unit Eigenschaften wie Name folgt an:

      {

      "Name": "<Entitlement_Name>",

      "Unit": "None"

      }

    • Geben Sie für konfigurierbare Berechtigungen die Value Eigenschaften NameUnit, und wie folgt an:

      {

      "Name": "<Entitlement_Name>",

      "Unit": "<Entitlement_Unit>",

      "Value": <Desired_Count>{

      }

  • KeyFingerprint— Verwenden Sie diesen Schlüsselfingerabdruck, um zu überprüfen, ob die Lizenz ausgestellt wurde von AWS Marketplace. Der Schlüssel-Fingerabdruck für Lizenzen, die von ausgestellt wurden, AWS Marketplace lautet wie folgt:

    aws:294406891311:AWS/Marketplace:issuer-fingerprint

  • Product SKU— Produkt-ID im GUID-Format (Globally Unique Identifier), die einem AWS Marketplace Produkt zugeordnet ist.

Beispiel einer konfigurierbaren Berechtigung

Im Folgenden finden Sie ein Beispiel für eine Anfrage, die den CheckoutLicense API-Vorgang verwendet, um eine konfigurierbare Berechtigung mit dem Namen auszuchecken. PowerUsers

aws license-manager checkout-license \
   product-sku "2205b290-19e6-4c76-9eea-377d6bf71a47" \
   checkout-type "PROVISIONAL" \
   client-token "79464194dca9429698cc774587a603a1" \"Statement":[
   entitlements "Name=PowerUsers,Value=1,Unit=Count" \ 
   key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint"
Beispiel eines abgestuften Anspruchs

Im Folgenden finden Sie ein Beispiel für eine Anfrage, die den CheckoutLicense API-Vorgang verwendet, um eine Funktionsberechtigung mit dem Namen auszuchecken. EnterpriseEdition

aws license-manager checkout-license \
   --product-sku "2205b290-19e6-4c76-9eea-377d6bf71a47" \
   --checkout-type "PROVISIONAL" \
   --client-token "79464194dca9429698cc774587a603a1" \
   --entitlements "Name=EnterpriseEdition,Unit=None" \
   --key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint"
Um eine Testlizenz für Ihr AMI-basiertes Produkt zu erstellen

  1. Führen Sie in Ihrer lokalen Umgebung, in der AWS CLI Version v2 installiert ist, das folgende Skript aus. Das Skript erstellt die Testlizenz und konfiguriert die entsprechenden Produktdetails.

    Anmerkung

    Verwenden Sie einen anderen AWS-Konto als den Test, AWS-Konto in dem Sie Ihre Software bereitstellen und testen. Lizenzen können nicht gleichzeitig erstellt, erteilt und ausgecheckt werden AWS-Konto.

    #!/bin/bash

# Replace with intended product ID on AWS Marketplace
PRODUCT_ID=<REPLACE-WITH-PRODUCT-ID>

# Replace with license recipient's AWS Account ID
BENEFICIARY_ACCOUNT_ID=<REPLACE-WITH-BENEFICIARY-ACCOUNT-ID>

# Replace with your product's name
PRODUCT_NAME="Test Product"

# Replace with your seller name on AWS Marketplace
SELLER_OF_RECORD="Test Seller" 

# Replace with intended license name
LICENSE_NAME="AWSMP Test License"

# Replace the following with desired contract dimensions
# More info here: https://docs.aws.amazon.com/license-manager/latest/APIReference/API_Entitlement.html
# Example "configurable entitlement"
ENTITLEMENTS='[
  {
    "Name": "ReadOnly",
    "MaxCount": 5,
    "Overage": false,
    "Unit": "Count",
    "AllowCheckIn": true
  }
]'
# Example "tiered entitlement"
# ENTITLEMENTS='[
#   {
#     "Name": "EnterpriseUsage", 
#     "Value": "Enabled",
#     "Unit": "None"
#   }
# ]'

# Format "yyyy-mm-ddTHH:mm:ss.SSSZ"
# This creates a validity period of 10 days starting the current day
# Can be updated to desired dates
VALIDITY_START=$(date +%Y-%m-%dT%H:%M:%S.%SZ)
VALIDITY_END=$(date --date="+10 days" +%Y-%m-%dT%H:%M:%S.%SZ)

# Configuration for consumption of the license as set on Marketplace products
CONSUMPTION_CONFIG='{
 "RenewType": "None",
 "ProvisionalConfiguration": {
   "MaxTimeToLiveInMinutes": 60
 }
}'

# License's home Region
HOME_REGION=us-east-1

# License issuer's name
ISSUER=Self  

# Run AWS CLI command to create a license
aws license-manager create-license \
  --license-name "${LICENSE_NAME}" \
  --product-name "${PRODUCT_NAME}" \
  --product-sku "${PRODUCT_ID}" \
  --issuer Name="${ISSUER}" \
  --beneficiary "${BENEFICIARY_ACCOUNT_ID}" \
  --validity 'Begin="'"${VALIDITY_START}"'",End="'"${VALIDITY_END}"'"' \
  --entitlements "${ENTITLEMENTS}" \
  --home-region "${HOME_REGION}" \
  --region "${HOME_REGION}" \
  --consumption-configuration "${CONSUMPTION_CONFIG}" \
  --client-token $(uuidgen)

  2. Erteilen Sie die Lizenz mithilfe der AWS License Manager Konsole. Weitere Informationen finden Sie unter Verteilen einer Berechtigung im License Manager Manager-Benutzerhandbuch.

  3. Melden Sie sich bei dem Konto an AWS-Konto , das als Käuferkonto fungiert, über das Sie Ihre Software bereitstellen und testen können. Dieses muss sich AWS-Konto von dem unterscheiden AWS-Konto , das die Lizenz erstellt und erteilt hat.

  4. Gehen Sie zur AWS License Manager Konsole, um die erteilten Lizenzen zu akzeptieren und zu aktivieren. Weitere Informationen finden Sie im License Manager Manager-Benutzerhandbuch unter Verwalten Ihrer erteilten Lizenzen.

  5. Führen Sie den folgenden Befehl in Ihrer Umgebung aus.

    # The following example uses a key fingerprint that should match the test license you created.
# When checking out an actual AWS Marketplace created license, use the following fingerprint:
# aws:294406891311:AWS/Marketplace:issuer-fingerprint
aws license-manager checkout-license \
  --product-sku <REPLACE-WITH-PRODUCT-ID> \
  --checkout-type PROVISIONAL \
  --key-fingerprint "aws:<ACCOUNT-ID-WHERE-YOU-CREATED-TEST-LICENSE>:Self:issuer-fingerprint" \
  --entitlements "Name=ReadOnly,Value=1,Unit=Count" \
  --client-token $(uuidgen)

    Der vorherige Befehl verwendet PROVISIONAL als Wert für den CheckoutType Parameter. Wenn für die Berechtigung eine Drawdown-Lizenz verwendet wird, verwenden Sie diese als PERPETUAL Wert.

License Manager Manager-API-Aufrufe

Um die im License Manager-Konto des Kunden gespeicherten Lizenzen zu verwalten, kann Ihre Software die folgenden API-Aufrufe verwenden:

  • GetLicense— Ruft den Status einer gekauften Lizenz ab und gibt an, ob die Lizenz abgelaufen ist oder bald abläuft, und sendet eine Benachrichtigung an den Kunden.

  • CheckoutLicense— Erkennt Lizenzen, die der Benutzer gekauft hat. Sie können es auch verwenden, um die Lizenzmenge zu aktualisieren, wenn der Benutzer eine bestimmte Anzahl von Lizenzen verbraucht hat. Mit CheckoutLicense können Sie immer wieder die Anzahl der vom Kunden verwendeten Lizenzen überprüfen. Wenn der Kunde alle Lizenzen aufgebraucht hat, gibt dieser Aufruf einen Fehler zurück. Informationen zur empfohlenen Schrittfrequenz finden Sie CheckoutLicense unter. Verlängerungen und Upgrades von Lizenzen

  • ExtendLicenseConsumption— Im Fall von variablen Dimensionen gibt die Software beim Auschecken einer Lizenz die Lizenz nach 60 Minuten automatisch an den Pool zurück. Wenn Sie den Zeitraum verlängern möchten, für den die Lizenz ausgecheckt bleibt, kann Ihre Software anrufen, ExtendLicenseConsumption um die Lizenz um weitere 60 Minuten zu verlängern.

  • CheckInLicense— Wenn Sie bei flexiblen Dimensionen die Lizenz wieder in den Berechtigungspool aufnehmen möchten, verwenden SieCheckInLicense.

  • ListReceivedLicenses— Listet die vom Käufer gekauften Lizenzen auf.

Verlängerungen und Upgrades von Lizenzen

Kunden können ihre Lizenzen auf der verlängern oder aktualisieren. AWS Marketplace Management Portal AWS Marketplace Generiert nach einem zusätzlichen Kauf eine neue Version der Lizenz, die die neuen Rechte widerspiegelt. Ihre Software liest die neuen Berechtigungen mit denselben API-Aufrufen. Sie müssen in Bezug auf die License Manager Manager-Integration nichts anderes tun, um Verlängerungen und Upgrades abzuwickeln.

Aufgrund von Lizenzverlängerungen, Upgrades, Stornierungen usw. empfehlen wir, dass Ihr Produkt den CheckoutLicense API-Aufruf in regelmäßigen Abständen ausführt, während das Produkt verwendet wird. Wenn der CheckoutLicense API-Vorgang in regelmäßigen Abständen ausgeführt wird, kann das Produkt Änderungen an Berechtigungen erkennen, z. B. Upgrades und deren Ablauf.

Wir empfehlen, den CheckoutLicense API-Aufruf alle 15 Minuten durchzuführen.