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

# 使用 檢查權利 AWS Marketplace Entitlement Service
<a name="checking-entitlements"></a>

 如果您的產品是 SaaS 合約產品，您的產品會使用 [GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html) API 呼叫 AWS Marketplace Entitlement Service 來擷取客戶的權利。您的產品應該針對 AWS Marketplace Entitlement Service 驗證該帳戶的後續用量。例如，如果客戶在帳戶中佈建 10 個使用者，您的產品應該檢查 AWS Marketplace 權利服務是否有該容量的權利。

若要驗證客戶對您的產品的權利，請使用 AWS Marketplace Entitlement Service 中的 `GetEntitlements`操作。 AWS Marketplace 權利服務僅適用於美國東部 （維吉尼亞北部） 區域，可透過 `entitlement.marketplace.us-east-1.amazonaws.com`或 存取`entitlement-marketplace.us-east-1.api.aws`。

 `GetEntitlements` 接受客戶 AWS 帳戶 ID、客戶識別符、授權 ARN 和維度做為篩選條件。 `ProductCode` 是必要的參數。操作會傳回分頁的權限清單。結果有一個 `ExpirationDate` 欄位，顯示權利有效的最短期間。如果客戶已設定自動續約，則 ExpirationDate 欄位中的日期是續約日期。

如需程式碼範例，請參閱 [SaaS 產品整合的程式碼範例](saas-code-examples.md)。

## 擷取使用者動作的權限
<a name="retrieving-entitlement-on-user-actions"></a>

 下列範例可協助您進一步了解擷取使用者動作權利的程序。

### 範例：以使用者為基礎的產品
<a name="example-user-based-application"></a>

 您提供的產品允許特定客戶存在多個帳戶。客戶可以造訪儀表板來佈建新使用者 （例如，指派登入資料）。當客戶佈建新的使用者時，您的產品會呼叫 `GetEntitlements` 來驗證容量是否存在。如果沒有，您可以呼叫 AWS Marketplace Metering Service 來為其他使用者計費。

### 範例：資料儲存產品
<a name="example-data-storage-application"></a>

 您提供的產品可讓客戶以加密或未加密的形式存放特定數量的資料。客戶可以檢視儀表板，顯示產品中現有和配置的資料量。您的儀表板會透過 擷取配置金額`GetEntitlements`。