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ços contratuais para produtos em contêineres com AWS License Manager
Para produtos baseados em contêineres com preços contratuais, você pode usar 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. Esta seção fornece informações sobre como integrar seu produto ao AWS License Manager. Depois que a integração for concluída, você poderá publicar sua lista de produtos no AWS Marketplace.
Se você estiver integrando o License Manager a um AWS Marketplace produto for Containers Anywhere para Amazon EKS Anywhere, Amazon ECS Anywhere, Amazon Elastic Compute Cloud EC2 (Amazon) ou infraestrutura local, siga as instruções em. Integrando um AWS Marketplace para contêineres em qualquer lugar com o License Manager
Para obter mais informações sobre AWS License Manager, consulte o Guia AWS License Manager do usuário e a AWS License Managerseção da Referência de AWS CLI comandos.
Tópicos
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
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.
exemplo 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ça emitida
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.
exemplo 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 de retirada, você pode usar a CheckoutLicense
API operação para verificar as unidades de licença (direitos) que são consumidas.
exemplo de backup no S3 para várias unidades/ano
Você tem um produto de armazenamento que permite fazer backup no Amazon Simple Storage Service (Amazon S3) de até 1.024 unidades de dados por um ano. Seu aplicativo pode ser lançado usando várias EC2 instâncias da Amazon. Seu aplicativo tem um mecanismo para rastrear e agregar dados. Seu software chama a CheckoutLicense
API operação com a ID do produto em cada backup ou em intervalos fixos para atualizar as quantidades consumidas.
Neste exemplo, seu software chama a CheckoutLicense
API operação para verificar 10 unidades de dados. Quando a capacidade total atinge o limite de backup que o cliente comprou, a API chamada 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": "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" }
Licenças flutuantes
A licença é devolvida ao conjunto da quantidade permitida de licenças após o uso.
Para licenças flutuantes, o aplicativo verifica os direitos do pool de direitos usando a CheckoutLicense
API operação quando o recurso está sendo usado. A resposta da CheckoutLicense
API operação inclui um token de consumo de licença, que é um identificador exclusivo para a finalização da compra. O token de consumo de licença pode ser usado para realizar ações adicionais nos direitos que são retirados, como devolvê-los ao conjunto de licenças ou estender a finalização da compra.
Para devolver o direito ao pool, use a CheckInLicense
API operação quando o recurso não estiver mais em uso.
aws license-manager check-in-license --license-consumption-token "f1603b3c1f574b7284db84..."
Em caso de falha de verificação do direito (no caso de o aplicativo falhar), o direito volta para o conjunto automaticamente após 60 minutos. Se o recurso estiver em uso por mais de 60 minutos, é uma prática recomendada manter o direito retirado do pool usando a ExtendLicenseConsumption
API operação enquanto o recurso estiver sendo usado.
aws license-manager extend-license-consumption --license-consumption-token "f1603b3c1f574b7284..."
exemplo 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 direitos flutuantes, você pode usar a CheckInLicense
API operação para devolver as unidades de licença ao pool de direitos.
exemplo 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 inicia o software fornecendo AWS Identity and Access Management (IAM) permissões. Quando um usuário faz login, seu aplicativo chama a CheckoutLicense
API operação para reduzir a quantidade em 1. Quando o usuário se desconecta, o aplicativo retorna essa licença para o pool chamando a CheckInLicense
API operação. 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
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, os níveis são preferíveis.
exemplo 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 no qual o cliente se inscreveu invocando a CheckoutLicense
API operação 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" }
AWS License Manager pré-requisitos de integração
Antes de publicar o produto, você deve fazer o seguinte:
-
Crie um novo produto de contêiner no Portal de gerenciamento do AWS Marketplace e anote o código do produto.
Para obter mais informações, consulte Visão geral: Crie um produto em contêiner.
-
Use uma IAM função para a tarefa ou o pod que executa seu aplicativo com IAM as permissões necessárias para chamar as
CheckInLicense
API operaçõesCheckoutLicense
ExtendLicenseConsumption
, e.As IAM permissões necessárias estão detalhadas na IAM política a seguir.
{ "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":"*" } ] }
-
Faça uma chamada de teste para a
RegisterUsage
API operação com um registro de todas as dimensões de preço que você definir.
Integração de um produto de contêiner ao License Manager
Para integrar seu produto baseado em contêiner ao License Manager
-
Defina IAM permissões para chamar o License Manager. Para obter mais informações, consulte AWS License Manager pré-requisitos de integração.
-
Faça o download do AWS SDK.
nota
Não configure AWS credenciais em seu software. AWS as credenciais do comprador são obtidas automaticamente em tempo de execução quando seu contêiner está sendo executado em uma EC2 instância da Amazon, ECS tarefa da Amazon ou EKS pod da Amazon.
-
Adicione verificações de licença ao seu produto.
Seu produto pode iniciar a
CheckoutLicense
API operação onde quer que a verificação da licença deva ser realizada. Para verificar a licença, seu produto deve saber:-
O emissor confiável da licença (AWS Marketplace)
-
O produto do aplicativo SKU (ID do produto)
-
O direito de verificar este aplicativo
As API chamadas variam de acordo com o tipo de preço das licenças que você configurou.
-
-
Publique sua lista de produtos em AWS Marketplace.
APIOperações do License Manager
Para gerenciar as licenças armazenadas na conta do License Manager do cliente, seu software pode usar as seguintes API operações:
-
GetLicense
— E API que o software possa consultar. Ela recupera o status de uma licença comprada (ou seja, expirada ou expirando em breve) e envia uma notificação de status ao cliente. -
CheckoutLicense
: descobre as licenças que o usuário comprou. Você também pode usar aCheckoutLicense
API operação para atualizar a quantidade de licenças quando o usuário tiver consumido alguma quantidade de licenças. ComCheckoutLicense
, 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 deCheckoutLicense
, consulte Renovações e upgrades de licenças. -
ExtendLicenseConsumption
: no caso de dimensões flutuantes, quando o software comprar uma licença, a licença retornará ao conjunto automaticamente após 60 minutos. Se você quiser estender o tempo de retirada da licença, use aExtendLicenseConsumption
API operação para estender a licença por mais 60 minutos. -
CheckInLicense
— No caso de dimensões flutuantes, quando quiser devolver a licença ao pool de direitos, use aCheckInLicense
API operação. -
ListReceivedLicenses
API— 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 API operações. 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 chame a CheckoutLicense
API operação regularmente enquanto o produto estiver em uso. Ao usar a CheckoutLicense
API operação em um ritmo regular, o produto pode detectar alterações nos direitos, como atualizações e expiração.
Recomendamos que você realize a CheckoutLicense
API chamada a cada 15 minutos.