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á.
# Preço do produto de AMI para AWS Marketplace
AWS MarketplaceO tem vários modelos de definição de preço para produtos de imagem de máquina da Amazon (AMI). Com ofertas privadas do vendedor, há opções disponíveis para contratos com duração de vários anos e personalizada. Para obter mais informações sobre contratos com duração de vários anos e personalizada, consulte [Preparando uma oferta privada para seu AWS Marketplace produto](private-offers-overview.md) e [Planos de parcelamento da oferta privada](installment-plans.md). As seções a seguir fornecem informações sobre modelos de definição de preço para produtos baseados em AMI.
**nota**
É necessário fornecer um formulário de impostos W-9 (para entidades com sede nos EUA) ou um formulário W-8 (para entidades com sede na UE), conforme descrito em [Registrando-se como vendedor em AWS Marketplace](seller-account-registering.md).
**Topics**
+ [Modelos de definição de preço da AMI](#pricing-models-for-ami-products)
+ [Cobranças da AWS versus cobranças de software](#aws-charges-vs-software-charges)
+ [Definição de preço de medição personalizada para produtos de AMI com o Serviço de medição do AWS Marketplace](custom-metering-pricing-ami-products.md)
+ [Preços contratuais para produtos de AMI no AWS Marketplace](ami-contracts.md)
+ [Associando licenças a produtos baseados em AMI usando AWS License Manager](ami-license-manager-integration.md)
## Modelos de definição de preço da AMI
A tabela a seguir fornece informações gerais sobre modelos de definição de preço para produtos baseados em AMI.
| Modelo de definição de preços | Descrição |
| --- | --- |
| Gratuito | Os clientes podem executar tantas instâncias quantas forem compatíveis com o Amazon Elastic Compute Cloud (Amazon EC2) sem cobranças de software adicionais. As definições de preço da avaliação gratuita e anual não podem ser combinadas com a definição de preço mensal. |
| Traga sua própria licença (BYOL) | O AWS Marketplace não cobra os clientes pelo uso do software, mas os clientes devem fornecer uma chave de licença para ativar o produto. Essa chave é comprada fora do AWS Marketplace. É necessário processar a aplicação do licenciamento e da autorização, bem como todas as definições de preço e faturamentos. |
| Pago por hora ou por hora/ano | **Por hora**: o software é cobrado por hora. Cada tipo de instância pode ser cobrado de forma diferente (não obrigatoriamente) e o uso é arredondado para cima até a próxima hora. **Por hora com avaliação gratuita**: os clientes estão limitados a executar exatamente uma instância do software sem receber cobranças. Você define a duração, entre 5 e 30 dias. A avaliação gratuita se aplica ao tipo de instância mais cara em execução e qualquer uso simultâneo fora dessa 1 instância será cobrado de acordo com a taxa por hora. OBSERVAÇÃO: esse é um modelo diferente do Nível gratuito da AWS para uso do Amazon EC2 em que os clientes recebem 750 horas de uso gratuito por mês. **Por hora e mensal**: as cobranças por hora e mensal são aplicadas de forma independente. A taxa mensal é cobrada a cada mês independentemente do uso; a taxa por hora é aplicada com base no uso por hora apenas. **Por hora com anual:** os clientes têm a opção de comprar um ano de uso adiantado para uma instância do Amazon EC2 de um tipo de instância. Você define o preço de cada tipo de instância e pode oferecer economias líquidas em relação ao preço por hora. Qualquer uso do cliente acima do número de assinaturas anuais compradas é cobrado de acordo com a taxa por hora definida por você para esse tipo de instância. **Por hora com duração multianual e personalizada**: esse tipo de oferta só está disponível por meio de ofertas privadas do vendedor. Usando ofertas privadas do vendedor, você especifica uma duração de contrato personalizada, de até 3 anos. É possível especificar o pagamento adiantado ou incluir uma programação de pagamento flexível. Você determina a definição de preço para cada tipo de instância. Se houver uma programação de pagamento flexível na oferta, você também definirá as datas da fatura, os valores de pagamento e o número de instâncias para cada tipo de instância incluído na oferta. Para uma oferta privada de vendedor ativa com uma programação de pagamento flexível, depois que o cliente executar o número especificado de instâncias, todas as instâncias adicionais executadas serão cobradas de acordo com a taxa por hora especificada na oferta privada do vendedor. Para obter mais informações sobre contratos com duração de vários anos e personalizada, consulte [Preparando uma oferta privada para seu AWS Marketplace produto](private-offers-overview.md) e [Planos de parcelamento da oferta privada](installment-plans.md). **Por hora com anual (inclui avaliação gratuita)**: idêntico ao modelo por hora com uma opção de anual, exceto que inclui uma avaliação gratuita que permite que um cliente execute uma instância de qualquer tipo de instância gratuitamente durante um número de dias determinado por você. As assinaturas anuais podem ser adquiridas a qualquer momento e são combinadas com a Avaliação gratuita. **Anual com por hora**: igual ao modelo de definição de preço por hora com anual. Os clientes têm a opção de comprar um ano de uso adiantado para uma instância do Amazon EC2 de um tipo de instância. Você define o preço de cada tipo de instância e pode oferecer economias líquidas em relação ao preço por hora, mas não é necessário oferecer economias. Qualquer uso do cliente acima do número de assinaturas anuais compradas é cobrado de acordo com a taxa por hora definida por você para esse tipo de instância. **Duração multianual e personalizada com por hora**: isso só está disponível por meio do [Preparando uma oferta privada para seu AWS Marketplace produto](private-offers-overview.md). Usando ofertas privadas do vendedor, você pode especificar um contrato de duração personalizada de até três anos. É possível exigir pagamento adiantado ou oferecer uma programação de pagamento flexível para o cliente. Você define o preço para cada tipo de instância durante o contrato e a definição de preço por hora para instâncias adicionais executadas. Se você oferecer uma programação de pagamento flexível, também definirá as datas da fatura, os valores de pagamento e o número de instâncias para cada tipo de instância incluído na oferta. Para uma oferta privada ativa com uma programação de pagamento flexível, após o número especificado de instâncias ter sido executado, todas as instâncias adicionais executadas pelo cliente serão cobradas de acordo com a taxa por hora especificada na oferta privada. Para obter mais informações sobre contratos com duração de vários anos e personalizada, consulte [Preparando uma oferta privada para seu AWS Marketplace produto](private-offers-overview.md) e [Planos de parcelamento da oferta privada](installment-plans.md). As definições de preço da avaliação gratuita e anual não podem ser combinadas com a definição de preço mensal. |
| Pago mensalmente | **Mensal**: o software é pago mensalmente, independentemente do número de instâncias executadas pelo cliente. As cobranças mensais são proporcionais no registro e no cancelamento. Exemplo: o cliente que assina por 1 dia do mês será cobrado por 1/30 do mês. **Mensal com por hora**: as cobranças por hora e mensal são aplicadas de forma independente. A taxa mensal é cobrada a cada mês independentemente do uso; a taxa por hora é aplicada com base no uso por hora apenas. As definições de preço da avaliação gratuita e anual não podem ser combinadas com a definição de preço mensal. |
| Preços de uso pago | O software é cobrado diretamente pelo valor fornecido por você junto com uma das quatro categorias de uso: usuários, dados, largura de banda ou hosts. É possível definir até 24 dimensões para o produto. Todas as cobranças ainda são feitas por hora ao cliente. Todo o uso é calculado e faturado mensalmente usando o mesmo mecanismo que um software do AWS Marketplace existente. A definição de preço pelo uso também é chamada de Serviço de medição do AWS Marketplace. |
| O modelo de preços do contrato | **AMI com preço de contrato**: um produto de AMI única ou AMI única com uma pilha do AWS CloudFormation pela qual o comprador paga uma taxa inicial. |
## Cobranças da AWS versus cobranças de software
As tarifas de produtos com base na imagem de máquina da Amazon (AMI) se enquadram em duas categorias:
+ **Detalhes de preço da infraestrutura**: todos os produtos baseados em AMI implicarão cobranças de infraestrutura da AWS associadas dependendo dos serviços e infraestrutura usados. Essas tarifas e taxas são definidas e controladas pela AWS e podem variar entre Regiões da AWS. Para obter mais informações, consulte [Preço do Amazon EC2](https://aws.amazon.com/ec2/pricing/).
+ **Detalhes de preço do software**: para produtos pagos, o vendedor define as cobranças pelo uso do software.
Essas duas categorias de cobrança de produto são exibidas separadamente nas páginas de detalhes do AWS Marketplace para ajudar os compradores a entender o possível custo de uso dos produtos.
### Avaliação gratuita dos produtos por hora da AMI
Os produtos por hora da AMI estão qualificados para o programa opcional de avaliação gratuita. Em uma avaliação gratuita, o cliente pode assinar o produto e usar uma única instância por até 31 dias sem pagar qualquer cobrança do software sobre o produto. As cobranças de infraestrutura da AWS ainda se aplicam. As avaliações gratuitas serão convertidas automaticamente em uma assinatura paga após o vencimento. Os clientes serão cobrados pelo uso adicional acima das unidades gratuitas fornecidas. Para oferecer uma avaliação gratuita do produto por hora, defina a duração do período de teste e notifique a equipe de [operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/). O período de teste pode ser de 5 a 31 dias.
Quando um cliente assina um produto com avaliação gratuita ele recebe uma mensagem de e-mail de boas-vindas que inclui o período de vigência da avaliação gratuita, uma data de expiração calculada e detalhes sobre como cancelar a assinatura. Uma mensagem de e-mail de lembrete é enviada três dias antes da data de expiração.
Ao oferecer um produto com Avaliação gratuita no AWS Marketplace, você concorda com as políticas específicas de reembolso descritas em **Política de reembolso**.
### Recursos adicionais
Para obter mais informações sobre definições de preços de AMI, consulte os tópicos a seguir:
+ [Definição de preço de medição personalizada para produtos de AMI com o Serviço de medição do AWS Marketplace](custom-metering-pricing-ami-products.md)
+ [Preços contratuais para produtos de AMI no AWS Marketplace](ami-contracts.md)
Para mais informações sobre as integrações de faturamento, medição e licenciamento dos produtos baseados em AMI, consulte os tópicos a seguir:
sobre definições de preços de AMI, consulte os tópicos a seguir:
+ [Configurando a medição personalizada para produtos AMI com AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md)
+ [Associando licenças a produtos baseados em AMI usando AWS License Manager](ami-license-manager-integration.md)
# Definição de preço de medição personalizada para produtos de AMI com o Serviço de medição do AWS Marketplace
Com o Serviço de medição do AWS Marketplace, você pode modificar o software para enviar registros de medição a um endpoint para capturar o uso. Você pode selecionar uma categoria de uso e definir até 24 dimensões dessa categoria. Essas dimensões são medidas uma vez por hora, agregadas e cobradas em relação a um plano de preços que você define. Como vendedor, você precisa determinar qual dimensão deseja usar. Depois que a AMI for publicada, não será possível alterá-la. As seções a seguir fornecem informações sobre o Serviço de medição do AWS Marketplace.
**Topics**
+ [Conceitos do serviço de medição](#metering-service-concepts)
+ [Definir o preço do software](#pricing-your-software)
+ [Adicionando seu produto ao AWS Marketplace](#listing-your-product-on-aws-marketplace)
+ [Modificar o software para usar o serviço de medição](#modifying-your-software-to-use-the-metering-service)
+ [Marcação medida pelo fornecedor (opcional)](#ami-vendor-metered-tagging)
+ [Configuração da medição personalizada](#configure-custom-metering)
+ [Configurando a medição personalizada para produtos AMI com AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md)
## Conceitos do serviço de medição
Antes de usar o Serviço de medição do AWS Marketplace, observe os seguintes conceitos de serviço importantes:
+ **Categoria de uso**: qualquer produto de software precificado por meio do uso do Serviço de medição é categorizado de acordo com uma categoria de uso, que determina a forma apropriada de cobrar dos clientes. As categorias de uso incluem, mas não estão limitadas a:
+ **Usuários**: um conjunto de permissões associadas a um único identificador. Essa categoria é apropriada para software em que os usuários de um cliente se conectam ao software diretamente (por exemplo, para gerenciamento de relacionamento com clientes ou relatórios de inteligência de negócios).
+ **Hosts**: qualquer servidor, nó, instância, endpoint ou outra parte de um sistema de computação. Essa categoria é apropriada para software que monitora ou verifica muitas instâncias de propriedade do cliente (por exemplo, monitoramento de segurança ou de desempenho).
+ **Dados**: armazenamento ou informações medidos em MB, GB ou TB. Essa categoria é apropriada para software que gerencia dados armazenados ou processa dados em lotes.
+ **Largura de banda**: medida em Mbps ou Gbps. Essa categoria é apropriada para software que permite aos clientes especificar uma quantidade de largura de banda a ser provisionada.
+ **Unidade**: unidade de medida; veja os exemplos descritos a seguir.
+ **Unidade de uso**: uma unidade de uso específica de um produto de software correspondente à categoria de uso selecionada. Essa unidade de uso descreve a unidade com a qual o software será cobrado. Os exemplos incluem:
+ **NodesHrs**(correspondente à categoria Anfitriões)
+ **UserHrs**(correspondente à categoria Usuário)
+ **GBStored**(correspondente à categoria de dados)
+ **Consumo**: produtos de software com definição de preço por meio do uso do Serviço de medição cobram pelo consumo de uma destas três formas:
+ Provisionado: o software permite que os clientes configurem uma determinada quantidade de recursos para uso (por exemplo, número de usuários ou uma quantidade fixa de largura de banda). A cada hora, os clientes pagam por aquilo que provisionaram.
+ Simultâneo: o software permite que um número de hosts ou usuários distintos se conectem ao software. A cada hora, os clientes pagam com base no número de hosts ou usuários que acessaram o software.
+ Acumulado: o software permite que os clientes usem qualquer quantidade de dados, processados ou armazenados. A cada hora, os clientes pagam pelo valor agregado.
+ **Definição de preço**: produtos de software com definição de preço por meio do uso do Serviço de medição devem especificar um preço único ou definir até 24 dimensões, cada uma com seu próprio preço. Os detalhes sobre as opções de preços incluem:
+ Dimensão única: é a opção de preço mais simples. Os clientes pagam um único preço por unidade do recurso por hora, independentemente do tamanho ou volume (por exemplo, US\$1 0,014 por usuário por hora ou US\$1 0,070 por host por hora).
+ Várias dimensões: esta opção de definição de preço é apropriada quando a categoria de uso selecionada varia em eixos diferentes. Por exemplo, para monitoramento de host, um preço diferente poderia ser definido de acordo com o tamanho do host. Ou, para a definição de preço baseada em usuário, um preço diferente pode ser definido com base no tipo de usuário (por exemplo, administrador, usuário avançado e usuário somente leitura).
+ **Medição**: todo o uso é registrado como um evento de medição, uma vez por hora. Seu software deve estar configurado para enviar a dimensão apropriada e a quantidade de uso para o Serviço de medição do AWS Marketplace.
+ Alocações: se desejar, você pode distribuir o uso em alocações de acordo com as propriedades rastreadas. Essas alocações são representadas como tags para o comprador. As tags permitem que o comprador visualize os custos divididos em uso por tag. Por exemplo, se você cobrar pelo usuário e os usuários tiverem uma propriedade “Departamento”, será possível criar alocações de uso com tags que tenham uma chave de “Departamento” e uma alocação por valor. Essa abordagem não altera o preço, as dimensões ou o uso total que você relata. No entanto, ela permite que o cliente visualize os custos por categorias apropriadas ao seu produto.
## Definir o preço do software
Ao definir o preço do software com o Serviço de medição do AWS Marketplace, primeiro é necessário decidir uma categoria de uso e como ele será consumido. O serviço oferece suporte para seis cenários de definição de preço distintos. É necessário selecionar apenas um desses produtos:
+ Usuário provisionado (por hora)
+ Usuário simultâneo (por hora)
+ Host provisionado (por hora)
+ Host simultâneo (por hora)
+ Largura de banda provisionada (por hora)
+ Dados acumulados (por hora)
Em seguida, decida como definir o preço da categoria de uso selecionada:
+ Preço único
+ Várias dimensões (até 24)
[Adicionando seu produto ao AWS Marketplace](#listing-your-product-on-aws-marketplace) descreve como fornecer uma descrição amigável para o cliente da dimensão e da definição de preço.
### Exemplo: Largura de banda provisionada com definição de preço não linear
Imagine que você ofereça software de equipamento de rede. Você decidiu cobrar por largura de banda provisionada. Para a categoria de uso, selecione **Largura de banda**. Além de cobrar pela largura de banda, você deseja cobrar um preço diferente à medida que os compradores expandem. Você pode definir várias dimensões dentro da categoria de largura de banda. Defina um preço distinto para 25 Mbps, 100 Mbps e 1 Gbps.
### Exemplo: Hosts simultâneos com várias dimensões
Imagine que você ofereça software que monitora outras instâncias do Amazon EC2. Você escolheu cobrar pelo número de hosts monitorados. Para a categoria de uso, selecione **Host**. Além de cobrar por host, você deseja cobrar pelo valor adicionar para monitoramento de hosts maiores. Você pode usar várias dimensões dentro da categoria de host. Defina um preço distinto para instâncias micro, pequeno, médio, grande, extra grande, 2XL, 4XL e 8XL. O software é responsável por mapear cada host específico para uma das dimensões definidas. O software é responsável por enviar um registro de medição separado para cada dimensão da categoria de uso, se aplicável.
## Adicionando seu produto ao AWS Marketplace
Para aproveitar as vantagens do serviço de medição, você deve criar um novo produto AWS Marketplace para listar. Se seu produto já estiver no AWS Marketplace, você precisará decidir se o novo produto do AWS Marketplace Metering Service será disponibilizado além do seu produto atual ou se substituirá seu produto atual como a única versão disponível para novos usuários. Se você escolher a substituição, o produto existente será removido do AWS Marketplace para que não esteja mais disponível para novos compradores. Os clientes existentes continuarão a ter acesso a seus produtos e instâncias antigos, mas poderão migrar para o novo produto caso desejem. O novo produto deve medir o uso para o Serviço de medição do AWS Marketplace, conforme descrito em [Modificar o software para usar o serviço de medição](#modifying-your-software-to-use-the-metering-service).
Depois de ter a AMI, siga o processo padrão para compartilhar e verificar a AMI usando a ferramenta de autoatendimento. Além disso, para usar o modelo disponível no portal de gerenciamento, preencha o formulário de carregamento do produto e faça upload dele para iniciar o processo de ingestão.
Use as definições a seguir para preencher os campos do formulário de carregamento de produto para o Serviço de medição do AWS Marketplace. No formulário de carregamento de produto, esses campos são identificados como **Definição de preço de consumo flexível (FCP)** para diferenciá-los dos produtos com preços mensais e por hora.
+ **Título** — Se você já tem um produto AWS Marketplace e está adicionando o mesmo produto ao AWS Marketplace Metering Service, inclua a categoria e a dimensão do FCP entre parênteses para diferenciá-las (por exemplo, “TÍTULO DO PRODUTO (Dados)”).
+ **Modelo da definição de preço**: na lista suspensa, selecione **Uso**.
+ **Categoria FCP**: a categoria na qual os clientes serão cobrados pelos produtos pagos com um componente de definição de preço de **Uso**. Na lista suspensa, selecione **Usuários**, **Hosts**, **Dados** ou **Largura de banda**.
+ **Unidade FCP**: a unidade de medida pela qual os clientes serão cobrados pelos produtos pagos com um componente **Uso** da definição de preço. Serão exibidas opções na lista suspensa com base na categoria FCP selecionada. A tabela a seguir lista as unidades válidas para cada categoria.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/marketplace/latest/userguide/custom-metering-pricing-ami-products.html)
+ **Nome da dimensão FCP**: o nome usado ao enviar registros de medição chamando a operação `MeterUsage`. Esse nome é visível em relatórios de faturamento. No entanto, como não é voltado para o exterior, o nome não precisa ser fácil de usar. O nome não pode ultrapassar os 15 caracteres e só pode incluir caracteres alfanuméricos e sublinhados. Depois de definir o nome e tornar o produto público, não será possível alterá-lo. Alterar o nome requer uma nova AMI.
+ **Descrição da dimensão FCP**: a declaração destinada ao cliente que descreve a dimensão do produto. A descrição não pode ter mais ultrapassar os 70 caracteres e deve ser acessível. Exemplos de descrições incluem: administradores por hora e por Mbps de largura de banda provisionada. Assim que o produto for publicado, você não poderá alterar essa descrição.
+ **Taxa FCP**: a cobrança por unidade de software deste produto. Este campo dá suporte a oito casas decimais.
**Observações:**
Não é necessário preencher os campos de definição de preço por hora e anual.
Os preços de avaliação gratuita e anual não são compatíveis.
Produtos que usam uma AMI e o recurso Clusters and AWS Resources não podem usar o AWS Marketplace Metering Service.
O preço, o tipo de instância ou a Região da AWS alteração seguirão o mesmo processo de outros AWS Marketplace produtos.
Produtos com o Serviço de medição do AWS Marketplace não podem ser convertidos em outros modelos da definição de preço como por hora, mensal ou traga a sua própria licença (BYOL).
AWS Marketplace recomenda adicionar informações da política do IAM em suas instruções de uso ou documento.
Até 24 dimensões do FCP podem ser incluídas no total. Depois de criadas e publicadas, você não pode modificar as dimensões existentes, mas pode adicionar novas (até o limite de 24).
Se você tiver dúvidas, entre em contato com a equipe de [Operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/).
## Modificar o software para usar o serviço de medição
Será necessário modificar o software para registrar o uso do cliente, enviar relatórios de uso por hora ao Serviço de medição e lidar com novos modos de falha. O software opera de forma independente do preço, mas ele precisará saber sobre a categoria de uso, como ele é consumido e todas as dimensões.
### Medir o consumo
O software deve determinar a quantidade da categoria de uso selecionada e quais dimensões o cliente consumiu. Esse valor será enviado, uma vez a cada hora, ao Serviço de medição. Em todos os casos, presume-se que o software tenha a capacidade de medir, registrar e ler o consumo de recursos com a finalidade de enviá-los de hora em hora ao Serviço de medição.
Para o consumo provisionado, isso geralmente será lido a partir da configuração do software como um valor amostrado, mas também pode ser um valor máximo configurado, registrado a cada hora. Para o consumo simultâneo, isso pode ser uma amostra periódica ou um valor máximo registrado a cada hora. Para o consumo acumulado, isso será um valor acumulador a cada hora.
Para a definição de preço em várias dimensões, vários valores devem ser medidos e enviados ao Serviço de medição, um por dimensão. Isso requer que o software seja programado ou configurado com o conjunto de dimensões conhecidas quando você fornece a AMI. O conjunto de dimensões não pode ser alterado depois que um produto é criado.
Para cada cenário da definição de preço, a tabela a seguir descreve maneiras recomendadas para medir o consumo a cada hora.
| **Cenário** | **Como medir ** |
| --- | --- |
| Usuário provisionado | Número atual de usuários provisionados (amostrado). -OU- Número máximo de usuários provisionados (visto naquela hora). |
| Usuário simultâneo | Número atual de usuários simultâneos (amostrado). -OU- Número máximo de usuários simultâneos (visto naquela hora). -OU- Número total de usuários distintos (visto naquela hora). |
| Host provisionado | Número atual de hosts provisionados (amostrado). -OU- Número máximo de hosts provisionados (visto naquela hora). |
| Host simultâneo | Número atual de hosts simultâneos (amostrado). -OU- Número máximo de hosts simultâneos (visto naquela hora). -OU- Número total de hosts distintos (visto naquela hora). |
| Largura de banda provisionada | Configuração atual de largura de banda provisionado (amostrada). -OU- Máximo de largura de banda provisionada (visto naquela hora). |
| Dados acumulados | GB de dados armazenados atualmente (amostrado). -OU- Máximo de GB de dados armazenados (visto naquela hora). -OU- Total de GB de dados adicionados ou processados naquela hora. -OU- Total de GB de dados processados naquela hora. |
## Marcação medida pelo fornecedor (opcional)
A marcação medida pelo fornecedor ajuda os fornecedores independentes de software (ISVs) a fornecer ao comprador uma visão mais granular sobre o uso do software e pode ajudá-lo a realizar a alocação de custos.
Para marcar o uso do software de um comprador, você precisa determinar como os custos são alocados. Primeiro pergunte aos compradores o que eles querem ver na alocação de custos. Em seguida, você pode dividir o uso entre as propriedades rastreadas para a conta do comprador. Exemplos de propriedades incluem `Account ID`, `Business Unit`, `Cost Centers` e outros metadados relevantes para seu produto. Essas propriedades são expostas ao comprador como tags. Usando tags, os compradores podem ver seus custos divididos em uso pelos valores das tags em seu console de AWS faturamento ([https://console.aws.amazon.com/costmanagement/](https://console.aws.amazon.com/costmanagement/)). A marcação medida pelo fornecedor não altera o preço, as dimensões ou o uso total que você relata. Ela permite que o cliente visualize os custos por categorias apropriadas ao seu produto.
Em um caso de uso comum, um comprador assina seu produto com uma Conta da AWS. O comprador também tem vários usuários associados à mesma assinatura do produto. Você pode criar alocações de uso com tags que tenham uma chave de `Account ID` e, em seguida, alocar o uso para cada usuário. Nesse caso, os compradores podem ativar a tag `Account ID` no console do Billing and Cost Management e analisar o uso individual do usuário.
### Experiência do vendedor
Os vendedores podem agregar os registros de medição dos recursos com o mesmo conjunto de tags em vez de agregar o uso de todos os recursos. Por exemplo, os vendedores podem criar o registro de medição que inclui diferentes buckets de `UsageAllocations`. Cada bucket representa `UsageQuantity` para um conjunto de tags, como `AccountId` e `BusinessUnit`.
No diagrama a seguir, o **Recurso 1** tem um conjunto exclusivo de tags `AccountId` e `BusinessUnit` e aparece no **Registro de medição** como uma única entrada.
O **Recurso 2** e o **Recurso 3** têm a mesma tag `AccountId`, `2222`, e a mesma tag `BusinessUnit`, `Operations`. Como resultado, eles são combinados em uma única entrada `UsageAllocations` no **Registro de medição**.
![\[Diagrama que mostra como as tags de medição do fornecedor combinam os dados de uso. Três recursos (Recursos 1, 2 e 3) diferentes AccountIds e BusinessUnits consolidados em um único Registro de Medição, UsageAllocations agrupados por AccountId e BusinessUnit antes de serem enviados ao AWS Marketplace Metering Service.\]](http://docs.aws.amazon.com/pt_br/marketplace/latest/userguide/images/seller-vendor-meter-tag.png)
Os vendedores também podem combinar recursos sem tags em uma única `UsageAllocation` com a quantidade de uso alocada e enviá-los como uma das entradas em `UsageAllocations`.
Os limites incluem:
+ Número de tags: 5
+ Quantidade de `UsageAllocations` (cardinalidade): 2.500
As validações incluem:
+ Caracteres permitidos para a chave e o valor da tag — a-zA-Z 0-9\$1 -= . \$1:\$1 /@
+ Máximo de tags na lista `UsageAllocation`: 5
+ Duas `UsageAllocations` não podem ter as mesmas tags (ou seja, a mesma combinação de chaves e valores de tag). Se for esse o caso, elas devem usar a mesma `UsageAllocation`.
+ A soma de `AllocatedUsageQuantity` de `UsageAllocation` deve ser igual a `UsageQuantity`, que é o uso agregado.
### Experiência do comprador
A tabela a seguir mostra um exemplo da experiência do comprador depois que ele ativa as tags de fornecedor `AccountId` e `BusinessUnit`.
Neste exemplo, o comprador pode ver o uso alocado no **Relatório de uso de custos**. As tags medidas pelo fornecedor usam o prefixo `“aws:marketplace:isv”`. Os compradores podem ativá-las no Billing and Cost Management, em **Tags de alocação de custos**, **Tags de alocação de custos geradas pela AWS**.
A primeira e a última linha do **Relatório de uso de custos** são relevantes para o que o vendedor envia ao Serviço de medição (conforme mostrado no exemplo [Experiência do vendedor](container-metering-meterusage.md#container-vendor-metered-tag-seller)).
**Relatório de uso de custos (simplificado)**
| ProductCode | Comprador | UsageDimension | UsageQuantity | `aws:marketplace:isv:AccountId ` | `aws:marketplace:isv:BusinessUnit` |
| --- | --- | --- | --- | --- | --- |
| xyz | 111122223333 | Rede: por (GB) inspecionado | 70 | 2222 | Operações |
| xyz | 111122223333 | Rede: por (GB) inspecionado | 30 | 3333 | Finanças |
| xyz | 111122223333 | Rede: por (GB) inspecionado | 20 | 4444 | IT |
| xyz | 111122223333 | Rede: por (GB) inspecionado | 20 | 5555 | Marketing |
| xyz | 111122223333 | Rede: por (GB) inspecionado | 30 | 1111 | Marketing |
Para ver um exemplo de código, consulte [`MeterUsage` com marcação de alocação de uso (opcional)](custom-metering-with-mp-metering-service.md#ami-meterusage-code-example)
## Configuração da medição personalizada
Para obter mais informações sobre como trabalhar com o Serviço de medição do AWS Marketplace, consulte [Configurando a medição personalizada para produtos AMI com AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md).
# Configurando a medição personalizada para produtos AMI com AWS Marketplace Metering Service
**nota**
Para produtos baseados em AMI com preços de medição personalizados, seu software deve chamar a [MeterUsage API](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-metering_MeterUsage.html) usando AWS credenciais temporárias da função do IAM para o Amazon Elastic Compute Cloud anexado à instância do Amazon EC2. O uso das chaves de acesso de longo prazo não é compatível.
O Serviço de medição do AWS Marketplace é um recurso de definição de preço e de medição que os vendedores podem usar para cobrar diretamente por seu software por categoria de uso. Há cinco categorias de uso: usuários, dados, largura de banda, hosts ou unidade. É possível usar o Serviço de medição com produtos baseados em imagem de máquina da Amazon (AMI), em contêiner e em software como serviço (SaaS). As seções a seguir fornecem mais informações sobre como configurar a medição personalizada com o AWS Marketplace Metering Service.
O Serviço de medição do AWS Marketplace permite vários novos cenários. Por exemplo, se o seu software monitora hosts, você pode cobrar pelos hosts monitorados. Você pode ter preços diferentes com base no tamanho do host e cobrar pelo número de hosts simultâneos monitorados por hora. Da mesma forma, se o seu software permite que muitos usuários em uma organização façam login, você pode cobrar pelo número de usuários. A cada hora, o cliente será cobrado pelo número total de usuários provisionados.
Para obter mais informações, consulte a [https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html).
*Para obter mais informações sobre a integração AWS Marketplace Metering Service da API para produtos baseados em AMI com preços de medição personalizados, consulte o laboratório Listar [produtos AMI com preços por unidades personalizadas](https://catalog.workshops.aws/mpseller/en-US/ami/list-ami-custom-units) do workshop do vendedor.AWS Marketplace *
**Topics**
+ [Requisitos](#metering-service-requirements)
+ [Chamar o Serviço de medição do AWS Marketplace](#call-aws-marketplace-metering-service)
+ [Tratamento de falhas](#important-information-about-failure-handling)
+ [Limitações](#limitations)
+ [Exemplo de código](#ami-metering-code-example)
## Requisitos
Todos os softwares baseados na AMI que usam o Serviço de medição devem atender aos seguintes requisitos:
+ Seu software deve ser lançado AWS Marketplace por meio de uma Amazon Machine Image (AMI).
+ Se você já tiver um produto em AWS Marketplace, deverá enviar uma nova AMI e criar um novo produto para habilitar esse recurso.
+ Todo software deve ser provisionado com uma função AWS Identity and Access Management (IAM). Será necessário que o cliente final adicione um perfil do IAM à instância do Amazon Elastic Compute Cloud (Amazon EC2) que o usuário estiver provisionando com o software. O uso de uma função do IAM é opcional quando você implanta software por meio de AWS Marketplace. É obrigatório quando você implanta o software do Serviço de medição do AWS Marketplace.
+ O software deve ser capaz de determinar o consumo de alguma forma.
## Chamar o Serviço de medição do AWS Marketplace
O software deve chamar o Serviço de medição a cada hora e registrar o valor do consumo relativo a essa hora.
Quando o software é iniciado, ele deve registrar o minute-of-the-hour local em que foi iniciado. Isso é chamado de *start-minute*. A cada hora no start-minute, o software deve determinar o valor do consumo relativo a essa hora e chamar o Serviço de medição. Para obter informações sobre como obter esse valor, consulte [Modificação do software para usar o Serviço de medição](https://docs.aws.amazon.com/marketplace/latest/userguide/custom-metering-pricing-ami-products.html#modifying-your-software-to-use-the-metering-service).
Para despertar a cada hora no start-minute, o software deverá usar uma das seguintes abordagens:
+ Uma thread dentro do software.
+ Um processo de daemon que é iniciado com a instância ou o software.
+ Um trabalho cron que é configurado durante a inicialização do aplicativo.
**nota**
O software deve chamar o Serviço de medição do AWS Marketplace usando o perfil do IAM configurada na instância do cliente e especificar a quantidade e dimensão do consumo.
Seu software pode usar o AWS SDK para chamar o AWS Marketplace Metering Service, semelhante ao exemplo de implementação a seguir:
1. Use o perfil de instância para criar um cliente de serviço. Isso requer a função configurada para a instância do EC2. As credenciais da função são atualizadas automaticamente pelo SDK.
1. A cada hora, leia o estado e a configuração do software par determinar os valores de consumo para essa hora. Isso pode incluir a coleta de um value-per-dimension.
1. Chame o método `meterUsage` no cliente do SDK com os seguintes parâmetros (faça chamadas adicionais para cada dimensão com uso):
+ `timestamp`: timestamp da hora que está sendo registrada (em UTC).
+ `productCode`: código do produto atribuído ao software.
+ `dimension`: dimensão (ou dimensões) atribuída ao software.
+ `quantity`: valor de consumo da hora.
+ `allocations`: (opcional) você pode fornecer alocações para o uso nas propriedades rastreadas. Essas alocações devem somar o consumo total no registro. Para o comprador, elas são exibidas como possíveis etiquetas de alocação de custos em suas ferramentas de cobrança (como o Gerenciamento de Faturamento e Custos da AWS console). O comprador deve ativar as tags em sua conta para rastrear os custos usando essas tags.
Além disso, o software deve chamar um endpoint do Serviço de medição do AWS Marketplace na região. O produto deve ter uma configuração de endpoint regional correta, para que `us-east-1` envie registros para o endpoint `us-east-1` e `us-west-2` envie registros para o endpoint `us-west-2`. Fazer chamadas na região fornece aos compradores uma experiência mais estável e evita situações em que a disponibilidade de uma região não relacionada pode afetar a execução do software em outra região.
Ao enviar registros de medição ao serviço, é necessário se conectar ao Serviço de medição do AWS Marketplace na sua região. Use o método auxiliar `getCurrentRegion()` para determinar a região na qual a instância do EC2 está sendo executada e passe essas informações de região para o construtor `MeteringServiceClient`. Se você não especificar um Região da AWS no construtor do SDK, a `us-east-1` região padrão será usada. Se o aplicativo tentar realizar chamadas entre regiões para o serviço, elas serão rejeitadas. Para obter mais informações, consulte [Determinando a região atual de um aplicativo](https://java.awsblog.com/post/Tx3GBOIEN1JJMQ5/Determining-an-Application-s-Current-Region) e [getCurrentRegion()](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/regions/Regions.html#getCurrentRegion()).
## Tratamento de falhas
O produto deve enviar registros de medição ao serviço, um endpoint de Internet pública, para que o uso possa ser capturado e faturado. Como é possível que um cliente modifique as configurações de rede de tal forma que impeça que os registros de medição sejam entregues, o produto deve considerar isso escolhendo um modo de falha.
**nota**
Algumas falhas de medição podem ser problemas transitórios na conexão com o. AWS Marketplace Metering Service AWS Marketplace recomenda fortemente a implementação de novas tentativas por até 30 minutos, com recuo exponencial, para evitar interrupções de curto prazo ou problemas de rede.
Normalmente, o software pode falhar aberto (fornecer uma mensagem de aviso, mas mantém toda a funcionalidade) ou falhar fechado (desativar todas as funcionalidades no aplicativo até que uma conexão seja restabelecida). Você pode optar por falhar aberto, fechado ou algo específico par ao aplicativo. É altamente recomendável que você evite deixar de encerrar depois de menos de duas horas de falhas de medição.
Como exemplo de falha parcialmente aberto, você pode continuar a permitir o acesso ao software, mas não permitir que o comprador modifique as configurações do software. Ou, um comprador ainda pode acessar o software, mas não seria capaz de criar usuários adicionais. O software é responsável por definir e impor esse modo de falha. O modo de falha do software deve ser incluído ao enviar a AMI e não pode ser alterado posteriormente.
## Limitações
Mantenha as seguintes limitações em mente ao projetar e enviar software habilitado para Serviço de medição:
+ **Requisitos do perfil do IAM e do gateway da Internet para seus clientes**: os clientes devem ter um gateway da Internet e devem iniciar o software com um perfil do IAM com permissões específicas. Para obter mais informações, consulte [AWS Marketplace permissões da API de medição e titulação](iam-user-policy-for-aws-marketplace-actions.md). O software não poderá se conectar ao Serviço de medição se essas duas condições não forem atendidas.
+ **Incapacidade de adicionar ou alterar nova categoria de uso ao produto existente no Serviço de medição**: quando os clientes assinam seu produto de software, estão concordando com os termos e condições. A alteração das categorias de uso em produtos com o Serviço de medição exige um novo produto e uma nova assinatura.
+ **Incapacidade de alterar dimensões no produto existente no Serviço de medição**: quando os clientes assinam seu produto de software, estão concordando com os termos e condições. A alteração das dimensões em produtos com o Serviço de medição exige um novo produto e uma nova assinatura. Você *pode* adicionar novas dimensões aos produtos existentes, até o limite de 24.
+ **Falta de avaliação gratuita e de assinaturas anuais**: os produtos no Serviço de medição não são compatíveis com avaliações gratuitas e assinaturas anuais na inicialização.
+ **Considerações sobre a implantação de várias instâncias ou com base em cluster**: alguns softwares serão implantados como parte de uma implantação de várias instâncias. Ao projetar o software, considere como e onde o consumo é medido e onde os registros de medição são emitidos.
## Exemplo de código
O exemplo de código a seguir é fornecido para ajudá-lo a integrar seu produto AMI com o AWS Marketplace APIs necessário para publicar e manter seu produto.
### `MeterUsage` com marcação de alocação de uso (opcional)
O exemplo de código a seguir é relevante para produtos de AMI com modelos de definição de preço de consumo. O exemplo do Python envia um registro de medição com as tags de alocação de uso apropriadas para AWS Marketplace cobrar taxas de seus clientes. pay-as-you-go
```
# NOTE: Your application will need to aggregate usage for the
# customer for the hour and set the quantity as seen below.
# AWS Marketplace can only accept records for up to an hour in the past.
#
# productCode is supplied after the AWS Marketplace Ops team has
# published the product to limited
# Import AWS Python SDK
import boto3
import time
usageRecord = [
{
"AllocatedUsageQuantity": 2,
"Tags":
[
{ "Key": "BusinessUnit", "Value": "IT" },
{ "Key": "AccountId", "Value": "123456789" },
]
},
{
"AllocatedUsageQuantity": 1,
"Tags":
[
{ "Key": "BusinessUnit", "Value": "Finance" },
{ "Key": "AccountId", "Value": "987654321" },
]
}
]
marketplaceClient = boto3.client("meteringmarketplace")
response = marketplaceClient.meter_usage(
ProductCode="testProduct",
Timestamp=int(time.time()),
UsageDimension="Dimension1",
UsageQuantity=3,
DryRun=False,
UsageAllocations=usageRecord
)
```
Para obter mais informações sobre`MeterUsage`, consulte [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)na *Referência da API do AWS Marketplace Metering Service*.
### Exemplo de resposta
```
{ "MeteringRecordId": "string" }
```
# Preços contratuais para produtos de AMI no AWS Marketplace
O preço do contrato para produtos baseados na imagem de máquina da Amazon (AMI) significa que o comprador paga uma taxa inicial por um produto de AMI única ou por uma única AMI com pilha do AWS CloudFormation. Para produtos de AMI com preços contratuais, o AWS Marketplace fatura seus clientes com antecedência ou de acordo com a programação de pagamento definida por você, com base no contrato entre você e o cliente. A partir daí, eles estarão autorizados a usar os recursos. Este tópico fornece mais informações sobre preços de contratos.
Para definir seu preço, escolha uma ou mais durações de contrato para oferecer aos clientes. Você pode inserir preços diferentes para cada duração de contrato. Suas opções são durações de 1 mês, 12 meses, 24 meses e 36 meses. Para ofertas privadas, você pode especificar uma duração personalizada em meses (até 60 meses).
**nota**
Os testes gratuitos não estão disponíveis para produtos de AMI com definição de preço do contrato.
Escolha a categoria que melhor descreve a definição de preço do seu produto. A categoria de definição de preço é exibida para os clientes no site do AWS Marketplace. Você pode escolher entre **Largura de banda** (GB/s, MB/s), **Dados** (GB, MB, TB), **Hosts**, **Solicitações**, **Níveis** ou **Usuários**. Se nenhuma das categorias predefinidas atender às suas necessidades, você poderá escolher a categoria mais genérica **Unidades**.
A oferta permite que até 24 dimensões sejam adicionadas a ela. Cada dimensão exige os seguintes dados:
+ **Categoria de contratos**: para produtos contratados sem preços baseados em consumo, você pode escolher uma categoria que mais se assemelhe à categoria de dimensão no contrato ou escolher **Unidades** se nenhum valor se assemelhar às unidades da dimensão no contrato
+ **Unidade de contratos**: escolha um dos valores disponíveis para as unidades que correspondam melhor às dimensões com base na categoria selecionada.
+ **Dimensão de contratos: Permitir várias compras**: esse campo é usado para indicar se uma oferta é uma oferta de preço em camadas ou uma oferta não hierárquica:
Oferta em níveis: permite que o comprador assine somente uma das dimensões disponíveis na oferta. As dimensões em uma oferta em níveis não têm o conceito de quantidades. Assinar um contrato com uma dimensão específica indica basicamente que o comprador escolheu a característica específica indicada por essa dimensão.
Oferta não em níveis: permite que o cliente adquira mais de uma dimensão como parte do contrato e permite que ele adquira várias unidades de cada uma dessas dimensões.
Definir um valor *verdadeiro* para esse campo indica que a oferta não é em níveis. Definir um valor *falso* para esse campo indica que a oferta é uma oferta em níveis.
Ao usar o Formulário de Carregamento do Produto (PLF) para criar os contratos para seu produto de AMI, você deve definir os seguintes campos para suas dimensões de definição de preço:
+ **Nome da API DimensionX dos contratos**: o nome que deve aparecer na licença gerada na conta do AWS License Manager do comprador. Esse nome também é usado como o valor para `Name` em `Entitlement` na chamada de API `Checkoutlicense`.
+ **Nome de exibição da DimensionX dos contratos**: o nome da dimensão voltado para o cliente que será exibido nas páginas de detalhes do produto e compras do site do AWS Marketplace. Crie um nome que seja fácil de usar. O comprimento máximo do nome é 24 caracteres. Depois que a lista for pública, o valor de `Name` não poderá ser alterado.
+ **Descrição da DimensionX dos contratos**: a descrição destinada ao cliente de uma dimensão que fornece informações adicionais sobre a dimensão do produto, como os recursos que a dimensão específica fornece. O comprimento máximo para a descrição é de 70 caracteres.
+ **Quantidade de DimensionX dos contratos**: é usada para calcular a proporção em casos de emendas de contrato em um produto. O valor desse campo deve ser definido como 1 para todas as ofertas de contrato. Não deve ser editado.
+ ****Taxa de 1 mês** de DimensionX dos contratos**: a taxa do contrato a ser cobrada por um mês de direitos em relação a essa dimensão. Para ofertas não em níveis, essa taxa é cobrada para cada unidade da dimensão que é adquirida. Esse campo oferece suporte a valores com até três casas decimais.
+ ****Taxa de 12 meses** de DimensionX dos contratos**: a taxa do contrato a ser cobrada por 12 meses de direitos em relação à dimensão. Para ofertas não em níveis, essa taxa é cobrada para cada unidade da dimensão que é adquirida. Esse campo oferece suporte a valores com até três casas decimais.
+ ****Taxa de 24 meses** de DimensionX dos contratos**: a taxa do contrato a ser cobrada por 24 meses de direitos em relação à dimensão. Para ofertas não em níveis, essa taxa é cobrada para cada unidade da dimensão que é adquirida. Esse campo oferece suporte a valores com até três casas decimais.
+ ****Taxa de 36 meses** de DimensionX dos contratos**: a taxa do contrato a ser cobrada por 36 meses de direitos em relação à dimensão. Para ofertas não em níveis, essa taxa é cobrada para cada unidade da dimensão que é adquirida. Esse campo oferece suporte a valores com até três casas decimais.
**Exemplo: aplicação de armazenamento de dados**
| | Preço para 1 mês | Preço para 12 meses | Preço para 24 meses | Preço para 36 meses |
| --- | --- | --- | --- | --- |
| Dados não criptografados (GB) | 1,50 USD/GB | 16,00 USD/GB | 30,00 USD/GB | 60,00 USD/GB |
| Dados criptografados (GB) | 1,55 USD/GB | 16,60 USD/GB | 31,20 USD/GB | 61,20 USD/GB |
**Exemplo: produto de monitoramento de log**
| | Preço para 1 mês | Preço para 12 meses | Preço para 24 meses | Preço para 36 meses |
| --- | --- | --- | --- | --- |
| Básico (10 hosts monitorados, 5 contêineres monitorados) | 100 USD | 1000 USD | 2000 USD | 4000 USD |
| Padrão (20 hosts monitorados, 10 contêineres monitorados) | 200 USD | 2000 USD | 4000 USD | USD 8.000 |
| Pro (40 hosts monitorados, 20 contêineres monitorados) | 400 USD | 4000 USD | USD 8.000 | USD 16.000 |
| Outros hosts monitorados por hora | USD 10 | 100 USD | 200 USD | 400 USD |
| Outros contêineres monitorados por hora | USD 10 | 100 USD | 200 USD | 400 USD |
**nota**
Os preços podem ser para as seguintes durações: um mês, 12 meses, 24 meses ou 36 meses. Você pode optar por oferecer uma ou mais dessas opções para o seu produto. As durações devem ser as mesmas em cada dimensão.
**Example**
Por exemplo, em um caso em que você tem dimensões `ReadOnlyUsers` e `AdminUsers`, se você oferecer um preço anual para ReadOnlyUsers, você deve oferecer um preço anual para `AdminUsers` também.
## Renovações automáticas
Quando os clientes compram seu produto por meio do AWS Marketplace usando contratos de AMI, eles podem concordar com a renovação automática dos termos do contrato. Os clientes continuam pagando pelas autorizações a cada mês ou por um, dois ou três anos.
Os clientes podem modificar as configurações de renovação a qualquer momento. Para obter mais informações, consulte [Modificação de um contrato existente](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-ami-contracts.html#modify-existing-contract) no *Guia do comprador do AWS Marketplace*.
# Associando licenças a produtos baseados em AMI usando AWS License Manager
Para produtos baseados em Amazon Machine Image (AMI) com preços contratuais, você pode usar o AWS License Manager para associar licenças ao seu produto. AWS License Manager é uma ferramenta de gerenciamento de licenças que permite que seu aplicativo rastreie e atualize licenças (também conhecidas como direitos) que foram adquiridas por um cliente. Depois que a integração for concluída, você poderá publicar sua lista de produtos no AWS Marketplace. As seções a seguir apresentam mais informações sobre o uso do AWS License Manager para associar licenças ao seu produto baseado em AMI.
Para obter mais informações sobre AWS License Manager, consulte o [Guia AWS License Manager do usuário](https://docs.aws.amazon.com/license-manager/latest/userguide/license-manager.html) e a [AWS License Manager](https://docs.aws.amazon.com/cli/latest/reference/license-manager/index.html)seção da *Referência de AWS CLI comandos*.
*Para obter mais informações sobre a integração AWS License Manager com produtos baseados em AMI com preços contratuais, consulte a lista de [produtos AMI com preços por laboratório de pagamento antecipado](https://catalog.workshops.aws/mpseller/en-US/ami/list-ami-upfront-payment) do workshop do vendedor.AWS Marketplace *
**nota**
Os clientes não podem executar novas instâncias da AMI após o período de expiração do contrato. No entanto, durante a vigência do contrato, eles podem executar qualquer número de instâncias. Essas licenças não estão bloqueadas por nós nem estão vinculadas a instâncias específicas.
**Criação de oferta privada**: os vendedores podem gerar ofertas privadas para os produtos usando a ferramenta de criação de ofertas privadas no Portal de gerenciamento do AWS Marketplace.
**Relatórios**: você pode configurar feeds de dados configurando um bucket do Amazon S3 na seção **Relatório** no Portal de gerenciamento do AWS Marketplace. Para obter mais informações, consulte [Relatórios de vendedores, feeds de dados e painéis em AWS Marketplace](reports-and-data-feed.md).
**Topics**
+ [Modelos de licença](#license-models)
+ [Fluxo de trabalho de integração](#LM-workflow)
+ [Pré-requisitos de integração do License Manager](#LM-prereqs)
+ [Integrando um produto baseado em AMI com AWS License Manager](#integrate-with-LM)
+ [Renovações e upgrades de licenças](#lic-renew-upgrade)
## Modelos de licença
AWS Marketplace a integração com AWS License Manager suporta dois modelos de licença:
+ [Modelo de licença configurável](#config-lic-model)
+ [Modelo de licença em nível](#tiered-lic-model)
### Modelo de licença configurável
O modelo de licença configurável (também conhecido como modelo de licença quantificável) autoriza o comprador a uma quantidade específica de recursos após a aquisição da licença.
Você define uma dimensão de preço e um preço unitário. Em seguida, o comprador pode escolher a quantidade de recursos que deseja comprar.
**Example da dimensão de preços e do preço unitário**
Você pode definir uma dimensão de preço (como backup de dados) e um preço unitário (como USD 30/unidade)
O comprador pode optar por comprar 5, 10 ou 20 unidades.
Seu produto rastreia e mede o uso para medir a quantidade de recursos consumidos.
Com o modelo de configuração, os direitos são contados de uma destas duas maneiras:
+ [Licenças emitidas](#drawndown-lic)
+ [Licenças flutuantes](#floating-lic)
#### Licenças emitidas
A licença é extraída do conjunto de quantidades permitidas de licenças após o uso. Esse direito é verificado permanentemente e não pode ser devolvido ao pool de licenças.
**Example de processar uma quantidade limitada de dados**
Um usuário tem o direito de processar 500 GB de dados. À medida que continuam processando os dados, a quantidade é extraída do pool de 500 GB até que todas as licenças de 500 GB sejam consumidas.
Para licenças emitidas, você pode usar a operação de API `CheckoutLicense` para verificar as unidades de licença que são consumidas.
**Example de backup no Amazon S3 para várias unidades/ano**
Você tem um produto de armazenamento que permite fazer backup no Amazon Simple Storage Service de até 1.024 unidades de dados por um ano. Seu aplicativo pode ser executado usando várias instâncias do Amazon EC2. Seu aplicativo tem um mecanismo para rastrear e agregar dados. Seu software chama a operação de API `CheckoutLicense` com o ID do produto em cada backup ou em intervalos fixos para atualizar as quantidades consumidas.
Neste exemplo, seu software chama `CheckoutLicense` para verificar 10 unidades de dados. Quando a capacidade total atinge o limite de backup que o cliente comprou, a chamada da API falha.
**Solicitação**
```
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"
```
**Resposta**
```
{
"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"
}
```
#### Licenças flutuantes
A licença é devolvida ao conjunto da quantidade permitida de licenças após o uso.
**Example do número de usuários a partir de um limite superior fixo**
Um usuário tem direito a 500 usuários simultâneos no aplicativo. Conforme os usuários fazem login e se desconectam, eles são retirados e retornados ao conjunto de 500 usuários. No entanto, o aplicativo não pode retirar mais de 500 usuários do conjunto porque 500 usuários simultâneos é o limite máximo fixo.
Para licenças flutuantes, você pode usar a operação de API `CheckInLicense` para devolver as unidades de licença ao conjunto de direitos.
**Example do número de usuários simultâneos por um ano**
O preço do produto é baseado no número de usuários simultâneos. O cliente compra uma licença para 10 usuários por um ano. O cliente executa o software fornecendo permissões do AWS Identity and Access Management (IAM). Quando um usuário faz login, seu aplicativo chama a operação de API `CheckoutLicense` para reduzir a quantidade em 1. Quando o usuário se desconecta, o aplicativo retorna essa licença para o conjunto chamando a operação de API `CheckInLicense`. Se você não chamar `CheckInLicense`, o check-in da unidade de licença será feito automaticamente depois de 1 hora.
**nota**
Na solicitação a seguir, `key-fingerprint` não é um valor reservado, mas o valor real da impressão digital com a qual todas as licenças serão publicadas.
**Solicitação**
```
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"
```
**Resposta**
```
{
"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"
}
```
### Modelo de licença em nível
O modelo de licença em nível dá ao comprador o direito a um nível específico de recursos do aplicativo após a aquisição da licença.
Você cria níveis para seu produto, como Básico, Intermediário e Premium. Em seguida, o comprador seleciona um dos níveis predefinidos.
O aplicativo não precisa rastrear ou medir o uso do aplicativo.
Com o modelo de licença em nível, os direitos não são contados, mas significam um nível de serviço que foi adquirido pelo cliente.
Se você quiser oferecer recursos agrupados, recomendamos usar o modelo de licença em nível.
**Example dos níveis Básico, Intermediário e Premium**
Um cliente pode assinar um contrato para um dos três níveis possíveis do software: Básico, Intermediário ou Premium. Cada um desses níveis tem seu próprio preço. Seu software pode identificar o nível que o cliente assinou invocando a operação de API `CheckoutLicense` e especificando todos os níveis possíveis na solicitação.
A resposta da solicitação contém o direito correspondente ao nível que o cliente adquiriu. Com base nessas informações, o software pode fornecer a experiência adequada ao cliente.
#### Solicitação
```
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"
```
#### Resposta
```
{
"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"
}
```
## Fluxo de trabalho de integração
As etapas a seguir mostram o fluxo de trabalho para integrar seu produto de AMI ao AWS License Manager:
1. O vendedor cria um produto com AWS License Manager integração.
1. O vendedor lista o produto em AWS Marketplace.
1. O comprador encontra o produto AWS Marketplace e o compra.
1. Uma licença é enviada para a Conta da AWS do comprador.
1. O comprador usa o software executando a instância do Amazon Elastic Compute Cloud (Amazon EC2), a tarefa do Amazon Elastic Container Service (Amazon ECS) ou o software de pod do Amazon Elastic Kubernetes Service (Amazon EKS). O cliente implanta usando um perfil do IAM.
1. O software lê a licença na AWS License Manager conta do comprador, descobre os direitos adquiridos e provisiona os recursos adequadamente.
**nota**
O License Manager não faz nenhum rastreamento ou atualização; isso é feito pelo aplicativo do vendedor.
## Pré-requisitos de integração do License Manager
Antes de publicar o produto, você deve fazer o seguinte:
1. Crie um novo produto AMI no Portal de gerenciamento do AWS Marketplace e anote o código do produto.
1. Preencha o Formulário de Carregamento do Produto (PLF) com as informações de preço necessárias e devolva-o para processamento.
1. Use um perfil do IAM para a tarefa ou o pod que está executando o aplicativo com as permissões do IAM necessárias para chamar `CheckoutLicense`, `ExtendLicenseConsumption` e `CheckInLicense`.
As permissões do IAM obrigatórias são detalhadas na política do IAM.
------
#### [ JSON ]
****
```
{
"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":"*"
}
]
}
```
------
1. Faça uma chamada de teste para a operação de API `RegisterUsage` com um registro para todas as dimensões de preço definidas.
## Integrando um produto baseado em AMI com AWS License Manager
Você pode integrar seu produto baseado em AMI ao License Manager usando a API do [AWS License Manager](https://docs.aws.amazon.com/license-manager/latest/APIReference/Welcome.html). Inicie as instâncias do Amazon EC2 usando produtos baseados em AWS Marketplace AMI.
**nota**
Verifique se você concluiu os [Pré-requisitos de integração do License Manager](#LM-prereqs) antes de executar o procedimento a seguir.
**Para integrar seu produto baseado em AMI ao License Manager**
1. Conclua o procedimento em [Criação de uma licença de teste no License Manager](#creating-test-license). Você deve criar uma licença de teste no License Manager para testar a integração.
1. Execute a operação da [GetLicense](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_GetLicense.html)API usando a licença Amazon Resource Name (ARN) que você obteve na etapa 1. Observe o valor do atributo `KeyFingerprint` da resposta `GetLicense` para uso posterior.
1. Baixe e inclua o AWS SDK público mais recente em seu aplicativo.
1. Para verificar se o comprador tem o direito de usar uma licença para seu aplicativo, execute a operação da [CheckoutLicense](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CheckoutLicense.html)API. Use os detalhes dos direitos e a impressão digital da chave da licença de teste que você obteve na etapa 1.
Se não houver direitos encontrados para a licença ou se a contagem máxima de direitos for excedida, a operação de API `CheckoutLicense` retornará `NoEntitlementsAllowedException`. Se os direitos forem válidos ou estiverem disponíveis para uso, a operação `CheckoutLicense` retornará uma resposta bem-sucedida com os direitos solicitados e os valores.
1. (Obrigatório somente para direitos flutuantes) Execute a operação da [CheckinLicense](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CheckInLicense.html)API usando o `LicenseConsumptionToken` que foi recebido na `CheckoutLicense` resposta. Essa ação libera direitos previamente retirados de volta ao conjunto de direitos disponíveis.
1. Depois de verificar com êxito a integração do License Manager com a licença de teste que você criou na etapa 1, atualize a impressão digital da chave no código para `aws:294406891311:AWS/Marketplace:issuer-fingerprint`. Agora, você está pronto para trabalhar com licenças emitidas pelo AWS Marketplace.
Siga o processo de lançamento da criação do aplicativo para um produto AMI e, em seguida, envie o produto para AWS Marketplace seguir o processo de publicação do produto.
### Criação de uma licença de teste no License Manager
Você usa a versão 2 do AWS Command Line Interface (AWS CLI) para criar uma licença de teste em AWS License Manager. Essa licença de teste é usada somente para verificar e testar a AWS License Manager integração. Depois que o teste for concluído, você poderá excluir a licença de teste. A licença real é gerada pelo AWS Marketplace com uma impressão digital de chave diferente.
AWS Marketplace suporta dois tipos de direitos em. AWS License Manager No entanto, somente um tipo pode ser habilitado para um produto. Ao criar uma licença, incluindo uma licença de teste, você deve especificar um dos seguintes tipos de direitos:
**Direitos em nível**: o modelo de licença em nível dá ao cliente o direito a determinados recursos do aplicativo. Os clientes não podem definir a quantidade de unidades que desejam comprar. No entanto, eles podem selecionar um único pacote ou nível predefinido. Os clientes podem modificar o contrato posteriormente para assinar outro nível.
**Direitos configuráveis**: o modelo de licença configurável concede direitos a uma determinada quantidade de recursos quando o cliente adquire uma licença. O cliente escolhe a quantidade de unidades que deseja comprar durante o processo de assinatura e será cobrado com base no preço unitário. Os clientes também podem assinar várias dimensões.
Os parâmetros necessários para uso na operação de API `CheckoutLicense` são os seguintes:
+ `CheckoutType`: os valores válidos são `Perpetual` ou `Provisional`:
+ `Perpetual`: usado quando a quantidade de direitos retirados será esgotada do conjunto. Exemplo: o comprador tem o direito de processar 500 GB de dados. À medida que continua processando os dados, a quantidade é retirada e esgotada do conjunto de 500 GB. Obtém o status de uma licença comprada sobre se a licença está expirada ou prestes a expirar para enviar uma notificação ao cliente.
+ `Provisional`: usado para direitos de licença flutuante, em que os direitos são retirados do conjunto e devolvidos após o uso. Exemplo: o usuário tem direito a 500 usuários simultâneos no aplicativo. Conforme os usuários fazem login e se desconectam, eles são retirados e retornados ao conjunto de 500 usuários. Para obter mais informações sobre direitos de licença flutuante, consulte [Licenças emitidas pelo vendedor no License Manager AWS](https://docs.aws.amazon.com/license-manager/latest/userguide/seller-issued-licenses.html).
+ `ClientToken`: identificador exclusivo que diferencia maiúsculas de minúsculas para garantir que o resultado exato ocorra e seja o mesmo, não importa quantas vezes você tente. Recomendamos que você use um identificador universalmente exclusivo (UUID) aleatório para cada solicitação.
+ `Entitlements`: lista de direitos a serem verificados.
+ Para direitos em nível, forneça as propriedades `Name` e `Unit` assim:
`{`
`"Name": "",`
`"Unit": "None"`
`}`
+ Para direitos configuráveis, forneça as propriedades `Name`, `Value` e `Unit` assim:
`{`
`"Name": "",`
`"Unit": "",`
`"Value": {`
\$1
+ `KeyFingerprint`: use essa impressão digital da chave para verificar se a licença foi emitida pelo AWS Marketplace. A impressão digital chave para licenças emitidas pela AWS Marketplace é a seguinte:
`aws:294406891311:AWS/Marketplace:issuer-fingerprint`
+ `Product SKU`— ID do produto com um formato de identificador exclusivo global (GUID) associado a um AWS Marketplace produto.
**Example de um direito configurável**
Veja a seguir um exemplo de uma solicitação que usa a operação de API `CheckoutLicense` para verificar um direito configurável chamado `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"
```
**Example de um direito em nível**
Veja a seguir um exemplo de uma solicitação que usa a operação de API `CheckoutLicense` para verificar um direito de recurso chamado `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"
```
**Para criar uma licença de teste para o produto baseado em AMI**
1. Em seu ambiente local com a AWS CLI v2 instalada, execute o script a seguir. O script cria a licença de teste e configura os detalhes apropriados do produto.
**nota**
Use um teste Conta da AWS diferente daquele Conta da AWS em que você está implantando e testando seu software. As licenças não podem ser criadas, concedidas e verificadas na mesma Conta da AWS.
```
#!/bin/bash
# Replace with intended product ID on AWS Marketplace
PRODUCT_ID=
# Replace with license recipient's AWS Account ID
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)
```
1. Conceda a licença usando o AWS License Manager console. Para obter mais informações, consulte [distribuir um direito](https://docs.aws.amazon.com/license-manager/latest/userguide/granted-licenses.html#distribute-entitlement.) no *Guia do usuário do License Manager*.
1. Faça login na Conta da AWS que funciona como uma conta de comprador na qual você implantará e testará seu software. Isso deve ser diferente Conta da AWS do Conta da AWS que criou e concedeu a licença.
1. Acesse o AWS License Manager console para aceitar e ativar as licenças concedidas. Para obter mais informações, consulte [gerenciar as licenças concedidas](https://docs.aws.amazon.com/license-manager/latest/userguide/granted-licenses.html#manage-granted-licenses) no *Guia do usuário do License Manager*.
1. Execute o seguinte comando no ambiente.
```
# 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 \
--checkout-type PROVISIONAL \
--key-fingerprint "aws::Self:issuer-fingerprint" \
--entitlements "Name=ReadOnly,Value=1,Unit=Count" \
--client-token $(uuidgen)
```
O comando anterior usa `PROVISIONAL` como valor para o parâmetro `CheckoutType`. Se o direito usar uma licença extraída, use `PERPETUAL` para obter o valor.
### Chamadas de API do License Manager
Para gerenciar as licenças armazenadas na conta do License Manager do cliente, seu software pode usar as seguintes chamadas de API:
+ `GetLicense`: obtém o status de uma licença comprada sobre se a licença está expirada ou prestes a expirar para enviar uma notificação ao cliente.
+ `CheckoutLicense`: descobre as licenças que o usuário comprou. Você também pode usá-la para atualizar a quantidade de licenças quando o usuário tiver consumido alguma quantidade de licenças. Com `CheckoutLicense`, você pode continuar verificando as quantidades de licenças usadas pelo cliente. Quando o cliente esgota todas as licenças, essa chamada retorna um erro. Para obter informações sobre a cadência sugerida para execução de `CheckoutLicense`, consulte [Renovações e upgrades de licenças](#lic-renew-upgrade).
+ `ExtendLicenseConsumption`: no caso de dimensões flutuantes, quando o software comprar uma licença, ele retornará a licença ao conjunto automaticamente após 60 minutos. Se você quiser estender o tempo em que a licença permanece verificada, o software pode chamar `ExtendLicenseConsumption` para estender a licença por mais 60 minutos.
+ `CheckInLicense`: no caso de dimensões flutuantes, quando quiser devolver a licença ao conjunto de direitos, use `CheckInLicense`.
+ `ListReceivedLicenses`: lista as licenças compradas pelo comprador.
## Renovações e upgrades de licenças
Os clientes podem renovar ou atualizar as licenças no Portal de gerenciamento do AWS Marketplace. Depois de fazer uma compra adicional, AWS Marketplace gera uma nova versão da licença que reflete os novos direitos. Seu software lê os novos direitos usando as mesmas chamadas de API. Você não precisa fazer nada diferente em termos de integração do License Manager para lidar com renovações e atualizações.
Devido a renovações de licenças, upgrades, cancelamentos e assim por diante, recomendamos que seu produto execute a chamada de API `CheckoutLicense` em um ritmo regular enquanto o produto estiver em uso. Ao usar a operação de API `CheckoutLicense` em um ritmo regular, o produto pode detectar alterações nos direitos, como atualizações e expiração.
Recomendamos que você realize a chamada de API `CheckoutLicense` a cada 15 minutos.