

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Verificando direitos usando o AWS Marketplace Entitlement Service
<a name="checking-entitlements"></a>

 Se seu produto for um produto contratado de SaaS, seu produto liga AWS Marketplace Entitlement Service para o para recuperar o direito do cliente usando a API. [GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html) Seu produto deve verificar o uso subsequente dessa conta em relação ao AWS Marketplace Entitlement Service. Por exemplo, se o cliente provisionar 10 usuários na conta, seu produto deverá verificar o AWS Marketplace direito a essa capacidade no Entitlement Service. 

Para verificar o direito de um cliente ao seu produto, use a `GetEntitlements` operação no AWS Marketplace Entitlement Service. O AWS Marketplace Entitlement Service está disponível somente na região Leste dos EUA (Norte da Virgínia), acessível por meio `entitlement.marketplace.us-east-1.amazonaws.com` de ou. `entitlement-marketplace.us-east-1.api.aws`

 `GetEntitlements`aceita o ID da conta da AWS, o identificador do cliente, o ARN da licença e a dimensão do cliente como filtros. `ProductCode`é um parâmetro obrigatório. A operação retorna uma lista paginada de autorizações. O resultado tem um campo `ExpirationDate` que mostra o período mínimo pelo qual a autorização é válida. Se o cliente tiver configurado a renovação automática, a data no ExpirationDate campo será a data de renovação.

Para obter exemplos de código, consulte [Exemplos de código para integração de produtos de SaaS](saas-code-examples.md).

## Recuperar autorização sobre ações do usuário
<a name="retrieving-entitlement-on-user-actions"></a>

 Os exemplos a seguir podem ajudar você a entender melhor o processo para recuperar autorizações sobre ações do usuário. 

### Exemplo: Produto baseado em usuário
<a name="example-user-based-application"></a>

 Você oferece um produto que permita um determinado número de contas para um cliente específico. O cliente pode acessar um painel para provisionar novos usuários (por exemplo, para atribuir credenciais). Quando o cliente provisiona um novo usuário, seu produto chama `GetEntitlements` para verificar se a capacidade existe. Caso contrário, você pode ligar para o Serviço de AWS Marketplace Medição para cobrar por usuários adicionais. 

### Exemplo: Produto de armazenamento de dados
<a name="example-data-storage-application"></a>

 Você oferece um produto que permite que os clientes armazenem uma determinada quantidade de dados em formato criptografado ou não criptografado. O cliente pode visualizar um painel que exibe a quantidade de dados existentes e alocados em seu produto. Seu painel recupera a quantidade de alocação por meio de `GetEntitlements`. 