AMI 產品的合約價格AWS License Manager - AWS Marketplace

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

AMI 產品的合約價格AWS License Manager

對於以合約定價為基礎的 Amazon 機器映像 (AMI) 產品,您可以使用 LicAWS ense Manager 將授權與產品建立關聯。

AWS License Manager是一種授權管理工具,可讓您的應用程式追蹤和更新客戶已購買的授權 (也稱為權利)。本節提供有關如何將產品與產品整合的相關資訊AWS License Manager。整合完成後,您可以在上發佈產品清單AWS Marketplace。

若要取得有關的更多資訊AWS License Manager,請參閱《AWS License Manager使用指南》和《指AWS CLI令參考》一AWS License Manager節。

注意
  • 客戶無法在合約到期後啟動 AMI 的新執行個體。但是,在合約期間,他們可以啟動任意數量的執行個體。這些授權不會鎖定節點或繫結至特定執行個體。

  • 建立不公開優惠 — 賣家可以使用中的「私人選件」建立工具,為產品產生私人優惠AWS Marketplace 管理入口網站。

  • 告 — 您可以在中的報告區段中設定 Amazon S3 儲存貯體來設定資料饋送AWS Marketplace 管理入口網站。如需詳細資訊,請參閱賣家報告、資料饋送和儀表板

授權模式

AWS Marketplace整合AWS License Manager支援兩種授權模式:

可配置授權模式

購買者購買授權後,可設定的授權模式 (也稱為可量化授權模式) 可讓購買者獲得特定數量的資源。

您可以設定定價維度和每單價。然後,買方可以選擇他們想要購買的資源數量。

範例 定價範圍與單價

您可以設定定價維度 (例如資料備份) 和每單價 (例如 $30 美元/單位)

買家可以選擇購買 5 個,10 個或 20 個單位。

您的產品會追蹤並測量使用情況,以測量消耗的資源數量。

使用組態模式,授權利會在下列兩種方式中有兩種方式計算授權:

提取授權

授權是從使用時允許數量的授權集區中抽取。該權利會永久簽出,且無法返回授權集區。

範例 處理有限數量的數據

使用者有權處理 500 GB 的資料。當它們繼續處理資料時,數量會從 500 GB 的集區中取出,直到消耗所有 500 GB 的授權為止。

對於提取授權,您可以使用CheckoutLicense API 作業來簽出已使用的授權單位。

範例 備份到S3 的多個單位/年

您有一個儲存產品,允許備份到 Amazon Simple Storage Service (Amazon S3),一年中最多可用 1024 個單位的資料。您可以使用多個 Amazon EC2 執行個 Amazon EC2 執行個體來啟動您的應用 您的應用程式具有追蹤和彙總資料的機制。您的軟體會在每次備份時使用 Product ID 呼叫CheckoutLicense API 作業,或以固定時間間隔來更新耗用的數量。

在此範例中,您的軟體會呼叫CheckoutLicense檢出 10 個資料單位。當總容量達到客戶購買的備份限制時,API 呼叫會失敗。

請求

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"

回應

{ "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" }

浮動授權

使用後,授權會返回至允許數量的授權集區。

範例 固定上限的使用者人數

使用者有權在應用程式上同時存取 500 位使用者。當使用者登入和登出時,會吸引使用者並返回 500 個使用者的集區。但是,該應用程序無法從池中吸引超過 500 個用戶,因為 500 個同時用戶是固定的上限。

對於浮動授權,您可以使用CheckInLicense API 作業將授權單位傳回權益集區。

範例 一年的同時使用者人數

您的產品是根據同時使用者的數量來定價。客戶為 10 位使用者購買了一年的授權。客戶透過提供AWS Identity and Access Management (IAM) 許可來啟動軟體。當使用者登入時,您的應用程式會呼叫CheckoutLicense API 作業,將數量減少 1。當使用者登出時,應用程式會呼叫CheckInLicense API 作業,將該授權傳回至集區。如果您未撥打電話CheckInLicense,授權單位將在 1 小時後自動簽入。

注意

在下列要求中,key-fingerprint不是預留位置值,而是發佈所有授權時所使用之指紋的實際值。

請求

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"

回應

{ "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" }

分層授權模式

在購買者購買授權後,階層式授權模式可讓買家使用特定等級或應用程式功能層級。

您可以為產品建立層級,例如「基本」、「中級」和「高級」。然後,採購員會選取其中一個預先定義的層級。

該應用程序不需要跟踪或計量應用程序的使用情況。

使用分層授權模式時,不會計算授權,而是代表客戶採購的服務層。

如果您想要一起提供捆綁的功能,我們建議您使用分層授權模式。

範例 基本、中級和高級層

客戶可以簽署軟件的三個可能層之一的合同:基本,中級或高級。這些層中的每一個都有自己的定價。您的軟體可以透過呼叫CheckoutLicense API 作業並指定要求中所有可能的層級,來識別客戶已註冊的層級。

請求的回應包含與客戶所購買的層級相對應的權利。根據此資訊,軟體可以佈建適當的客戶經驗。

要求

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"

回應

{ "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" }

集成工作流

以下步驟顯示了將 AMI 產品與整合的工作流程AWS License Manager:

  1. 賣方創建具有AWS License Manager集成的產品。

  2. 賣家將產品刊登於AWS Marketplace。

  3. 買家在上找到產品AWS Marketplace並購買它。

  4. 授權會在其中傳送給買方AWS 帳戶。

  5. 購買方透過啟動 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體、Amazon Elastic Kubernetes Service (Amazon EKS) 網繭軟體、使用該軟體,客戶可以使用該軟體,客戶使用 IAM 角色進行部署。

  6. 軟體會讀取買方AWS License Manager帳戶中的授權、探索所購買的權利,並相應地佈建這些功能。

    注意

    License Manager 不會進行任何跟踪或更新;這是由賣方的應用程序完成的。

License Manager 整合必備

在發佈產品之前,您必須執行下列動作:

  1. 在中建立新的 AMI 產品AWS Marketplace 管理入口網站,並記下其產品代碼。

  2. 填寫「產品裝載表格」(PLF),並提供必要的價格信息,然後將其交回給我們進行處理。

  3. 針對執行應用程式的工作或網繭使用 IAM 角色,並具有呼叫CheckoutLicenseExtendLicenseConsumption、和所需的 IAM 權限CheckInLicense

    下列 IAM 政策詳細說明了必要的 IAM 許可。

    { "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. RegisterUsage API 操作進行測試調用,並記錄您選擇的所有定價維度。

整合以 AMI 為基礎的產品AWS License Manager

您可以使用 AWS License ManagerAPI 將您的 AMI 產品與 License Manager 整合。使用以AWS Marketplace AMI 為基礎的產品啟動 Amazon EC2 執行個體。

注意

請確定您已完成,License Manager 整合必備然後再執行下列程序。

將您的 AMI 產品與 License Manager 整合
  1. 完成在 License Manager 中建立測試授權中的程序。您必須在 License Manager 中建立測試授權,才能測試整合。

  2. 使用您在步驟 1 中獲得的授權亞馬遜資源名稱 (ARN) 執行 GetLicenseAPI 作業。請注意GetLicense響應的KeyFingerprint屬性的值以供以後使用。

  3. 在您的應用程式中下載並包含最新的公用AWS SDK。

  4. 若要確認購買者有權為您的應用程式使用授權,請執行 CheckoutLicenseAPI 作業。使用您在步驟 1 中獲得的測試許可證的權利詳細信息和密鑰指紋。

    如果找不到授權的權利,或超過權利計數上限,則會傳回CheckoutLicense API 作業NoEntitlementsAllowedException。如果權利文件有效或可供使用,則CheckoutLicense作業會傳回成功的回應,其中包含要求的權利及其值。

  5. (僅適用於浮動權利) 使用CheckoutLicense回應中收到的 CheckinLicenseLicenseConsumptionTokenAPI 作業執行 API 作業。此動作會將先前已出庫的權利文件釋放回可用權利集區。

  6. 在您成功驗證 License Manager 與您在步驟 1 中建立的測試授權整合後,請將程式碼中的金鑰指紋更新為aws:294406891311:AWS/Marketplace:issuer-fingerprint。現在,您可以使用授權方授權AWS Marketplace。

按照將應用程序構建到 AMI 產品的發布過程,然後將產品提交到AWS Marketplace遵循產品發布過程。

在 License Manager 中建立測試授權

您可以使用AWS Command Line Interface (AWS CLI) 的版本 2 在中建立測試授權AWS License Manager。此測試授權僅用於驗證和測試AWS License Manager整合。測試完成後,您可以刪除測試許可證。實際的許可證是由不同AWS Marketplace的密鑰指紋生成的。

AWS Marketplace支援中的兩種權利類型AWS License Manager。但是,一個產品只能啟用一種類型。建立包括測試授權時,您必須指定下列權利類型的其中一種權利:

分層授權 — 分層授權模式可讓客戶使用某些應用程式功能。客戶無法定義要購買的單位數量。不過,他們可以選取單一預先定義的套件或層級。客戶稍後可以修改合約以訂閱其他層級。

可配置的權利 — 當客戶購買授權時,可配置的授權模式會授與特定數量資源的權利。客戶在訂閱過程中選擇要購買的單位數量,並根據單價開立帳單。客戶也可以訂閱多個維度。

CheckoutLicense API 作業中使用的必要參數如下:

  • CheckoutType— 有效值為PerpetualProvisional

    • Perpetual— 當從集區中簽出的權利數量將用盡時使用。範例:買方有權處理 500 GB 的資料。隨著他們繼續處理資料,數量會從 500 GB 的集區中抽出並用盡。取得已購買授權的狀態,瞭解授權是否已到期或即將到期,以便傳送通知給客戶。

    • Provisional— 用於浮動授權權利,其中權利從集區中出庫並在使用後返回。示例:用戶有權在應用程序中同時使用 500 個用戶。當使用者登入和登出時,會吸引使用者並返回 500 個使用者的集區。如需浮動授權權利的詳細資訊,請參閱 AWS License Manager 中的賣方核發授權。

  • ClientToken— 唯一且區分大小寫的識別碼,可確保發生確切的結果,無論嘗試多少次都是相同的。建議您針對每個請求使用隨機的通用唯一識別碼 (UID)。

  • Entitlements— 要出庫的軟體權利文件清單。

    • 對於階層權利文件,提供NameUnit屬性如下:

      {

      "Name": "<Entitlement_Name>",

      "Unit": "None"

      }

    • 對於可配置的權利,提供NameUnit、和Value屬性,如下所示:

      {

      "Name": "<Entitlement_Name>",

      "Unit": "<Entitlement_Unit>",

      "Value": <Desired_Count>{

      }

  • KeyFingerprint— 使用此金鑰指紋來驗證授權是由核發AWS Marketplace。發出授權的金鑰指紋如下:AWS Marketplace

    aws:294406891311:AWS/Marketplace:issuer-fingerprint

  • Product SKU— 具有與產品相關聯之全域唯一識別碼 (GUID) 格式的AWS Marketplace產品 ID。

範例 的可設定權利

以下是使用CheckoutLicense API 作業簽出名為的可設定權利的請求範例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"
範例 分層權利

以下是使用CheckoutLicense API 作業簽出名為的功能權利的請求範例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"
為您的 AMI 產品建立測試授權
  1. 從已安裝AWS CLI v2 的本機環境中,執行下列指令碼。指令碼會建立測試授權,並設定適當的產品詳細資料。

    注意

    使用與AWS 帳戶您要部署和測試AWS 帳戶軟體的測試不同的方式。無法建立、授與授權,以及在同一授權中簽出授權AWS 帳戶。

    #!/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. 使用AWS License Manager主控台授予授權。如需詳細資訊,請參閱 L icense Manager 使用者指南散佈權利

  3. 登入作為購買者帳戶AWS 帳戶的帳戶,您將在其中部署並測試您的軟體。這必須與建立並授予AWS 帳戶許可證的不同AWS 帳戶。

  4. 移至AWS License Manager主控台以接受並啟用授與的授權。如需詳細資訊,請參閱 Lic ense Manager 使用者指南的管理授權

  5. 在您的環境中執行下列命令。

    # 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)

    上一個指令使用PROVISIONAL做為CheckoutType參數的值。如果軟體權利文件使用提取授權,請使PERPETUAL用該值。

License Manager API 呼叫

若要管理儲存在客戶的 License Manager 帳戶中的授權,您的軟體可以使用下列 API 呼叫:

  • GetLicense— 取得授權是否已到期或即將到期的已購買授權狀態,以便傳送通知給客戶。

  • CheckoutLicense— 發現用戶已購買的許可證。您也可以在使用者使用一定數量的授權時,使用它來更新授權數量。使用CheckoutLicense,您可以繼續簽出客戶使用的許可證數量。當客戶用盡所有授權時,此呼叫會傳回錯誤。如需有關建議執行節奏的資訊CheckoutLicense,請參閱授權續約和升級

  • ExtendLicenseConsumption— 在浮動維度的情況下,當軟體簽出授權時,它會在 60 分鐘後自動將授權歸還至集區。如果您想延長許可證保持簽出的時間,您的軟件可ExtendLicenseConsumption以調用將許可證延長 60 分鐘。

  • CheckInLicense— 如果是浮動維度,當您想要將授權傳回權益集區時,請使用CheckInLicense

  • ListReceivedLicenses— 列出購買者購買的授權。

授權續約和升級

客戶可以在上續約或升級其授權AWS Marketplace 管理入口網站。在他們進行額外購買之後,AWS Marketplace會產生反映新授權的新版本。您的軟體會使用相同的 API 呼叫讀取新的權利。您不必在許可證管理器集成方面做任何不同的事情來處理續訂和升級。

由於授權續約、升級、取消等原因,我們建議您的產品在產品使用期間定期執行CheckoutLicense API 呼叫。藉由定期使用CheckoutLicense API 作業,產品可偵測權利的變更,例如升級和到期。

我們建議您每 15 分鐘執行一次CheckoutLicense API 呼叫。