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á.
# Produtos baseados em AMI no AWS Marketplace
Como um vendedor do AWS Marketplace, você pode entregar seus produtos aos compradores é com [imagem de máquina da Amazon (AMIs)](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#AmazonMachineImage). Uma AMI fornece as informações necessárias para executar uma instância do Amazon Elastic Compute Cloud (Amazon EC2). Você cria uma AMI personalizada para seu produto, e os compradores podem usá-la para criar instâncias do EC2 com seu produto já instalado e pronto para uso. Este tópico fornece informações sobre como usar AMIs para entregar seu produto do AWS Marketplace.
Quando os compradores usam a AMI que você fornece, eles são cobrados pelas instâncias que criam, de acordo com as opções de preço e medição que você cria para seu produto. Os compradores podem usar a AMI do produto da mesma forma que usam outras AMIs na AWS, inclusive criando novas versões personalizadas da AMI. As instâncias do EC2 criadas a partir da AMI ainda são cobradas como seu produto, com base no código do produto de AMI.
## Métodos de entrega de produtos baseados em AMI
Você pode fornecer produtos baseados em AMI de uma das maneiras a seguir:
+ **AMI única**: os compradores selecionam e usam a AMI como modelo para uma instância do EC2. Os compradores podem encontrar esses produtos usando o filtro de método de entrega **Imagem de máquina da Amazon**. Para obter mais informações, consulte [Criação de produtos baseados em AMI](ami-single-ami-products.md).
+ **Modelos do AWS CloudFormation**: você cria modelos que permitem que os compradores instalem um sistema de várias instâncias com funções diferentes como uma única unidade. Os compradores podem encontrar esses produtos usando o filtro de método de entrega do **CloudFormation**. Para obter mais informações, consulte [Adicione CloudFormation modelos ao seu produto](cloudformation.md).
## Recursos adicionais
Para obter mais informações sobre produtos de AMI, consulte os tópicos a seguir.
**AWS Marketplace**
+ [Preços do produto para AWS Marketplace](pricing.md)
+ [Configurando a medição personalizada para produtos AMI com AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md)
**Produtos baseados em AMI**
+ [Entendendo os produtos baseados em AMI em AWS Marketplace](ami-getting-started.md)
+ [Criação de produtos baseados em AMI](ami-single-ami-products.md)
+ [Gerenciando produtos baseados em AMI como vendedor AWS Marketplace](concept-chapter-servicename.md)
+ [Adicione CloudFormation modelos ao seu produto](cloudformation.md)
+ [Melhores práticas de construção AMIs para uso com AWS Marketplace](best-practices-for-building-your-amis.md)
+ [Preço do produto de AMI para AWS Marketplace](pricing-ami-products.md)
+ [Recebendo notificações do Amazon SNS para produtos AMI em AWS Marketplace](ami-notification.md)
+ [Lista de verificação de produtos da AMI para AWS Marketplace](aws-marketplace-listing-checklist.md)
+ [Requisitos de produto baseados em AMI para AWS Marketplace](product-and-ami-policies.md)
# Entendendo os produtos baseados em AMI em AWS Marketplace
Como AWS Marketplace vendedor, você pode entregar seus produtos aos compradores com [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#AmazonMachineImage). Uma AMI fornece as informações necessárias para iniciar uma instância do Amazon Elastic Compute Cloud (Amazon EC2). A seção a seguir explica os principais conceitos para trabalhar com produtos baseados em AMI.
**nota**
Você só pode usar uma AMI em um produto de AMI, mas pode adicionar versões dessa AMI ao produto.
**Topics**
+ [Ciclo de vida do produto](#ami-product-lifecycle)
+ [Códigos de produto de AMI](#ami-product-codes)
+ [Solicitações de alteração](#ami-change-requests)
+ [Formulários de carregamento de produtos](#ami-product-load-forms)
+ [Emendas do contrato anual](#annual-agreement-amendments)
+ [Produtos FPGA](#ami-fpga-products)
## Ciclo de vida do produto
Entre os produtos baseados em AMI estão uma ou mais versões do software, mais metadados sobre o produto como um todo. Ao criar o produto, você configura suas propriedades AWS Marketplace incluindo o nome, a descrição e o preço do produto. Você também determina as categorias apropriadas para seu produto e adiciona palavras-chave para que o produto apareça em pesquisas relevantes.
Você também cria a primeira versão do software. Isso pode ser apenas a AMI, ou você pode incluir AWS CloudFormation modelos ou pacotes de software que os compradores podem usar para criar seus próprios AMIs. Para obter mais informações, consulte [Métodos de entrega de produtos baseados em AMI](ami-products.md#ami-product-delivery-methods).
Para produtos pagos, os compradores são cobrados pelo número de instâncias instaladas. Para medir em uma dimensão diferente que seu software rastreia, como o número de usuários do produto, integre seu produto ao Serviço de AWS Marketplace Medição. Para obter mais informações, consulte [Configurando a medição personalizada para produtos AMI com AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md).
Quando você cria o produto e a primeira versão do software, ele é publicado inicialmente em um escopo limitado para que somente sua conta possa acessá-lo. Quando estiver pronto, você pode publicá-lo no AWS Marketplace catálogo para permitir que os compradores se inscrevam e comprem seu produto.
Você usa a página [Produto de servidor](https://aws.amazon.com/marketplace/management/products/server) para ver a lista de seus produtos. Os produtos terão um dos seguintes status:
+ **Preparação**: um produto incompleto para o qual você ainda está adicionando informações. No primeiro **Salvar e sair** da criação da experiência de autoatendimento, a solicitação de alteração bem-sucedida cria um produto não publicado com informações das etapas concluídas que você enviou. Nesse estado, você pode continuar adicionando informações ao produto ou alterar os detalhes já enviados por meio de solicitações de alteração.
+ **Limitado**: um produto é concluído após ser enviado ao sistema e passar por toda a validação no sistema. Em seguida, o produto é liberado para um estado **Limitado**. Nesse momento, o produto tem uma página de detalhes que só pode ser acessada por sua conta e por quem você colocou na lista de permissões. Você pode testar o produto na página de detalhes. Se necessário, para obter mais informações e ajuda, entre em contato com a [https://aws.amazon.com/marketplace/management/contact-us/?#](https://aws.amazon.com/marketplace/management/contact-us/?#).
+ **Público**: quando você estiver pronto para publicar o produto para que os compradores possam ver e assinar o produto, use a solicitação de alteração de **Atualizar visibilidade**. Isso inicia um fluxo de trabalho para a equipe de operações do AWS Marketplace vendedor revisar e auditar seu produto de acordo com nossas [políticas](https://docs.aws.amazon.com/marketplace/latest/userguide/product-and-ami-policies.html). Assim que o produto for aprovado e a solicitação de alteração for processada, o produto será movido do status **Limitado** para **Público**.
+ **Restrito**: se você quiser impedir que novos usuários assinem seu produto, restrinja o produto usando a solicitação de alteração de **Atualizar visibilidade**. Um status **Restrito** significa que os usuários existentes podem continuar usando o produto. No entanto, o produto não estará mais visível para o público nem estará disponível para novos usuários.
O ciclo de vida de um produto baseado em AMI para AWS Marketplace não termina depois que você publica a primeira versão. Você deve manter o produto atualizado com novas versões do software e patches de segurança para o sistema operacional básico.
Como exemplo do ciclo de vida completo de um produto baseado em AMI, imagine que um vendedor queira vender o produto baseado em AMI no AWS Marketplace. Veja a seguir como o vendedor cria e mantém o produto ao longo do tempo:
1. **Crie um produto** — O vendedor cria o produto e publica a versão 1.0.0 no. AWS Marketplace Compradores podem criar instâncias da versão 1.0.0 e usá-la.
1. **Adicionar uma nova versão**: posteriormente, o vendedor adiciona um novo recurso ao produto e adiciona uma nova versão, 1.1.0, que inclui o recurso. Compradores ainda podem usar a versão original, 1.0.0, ou podem escolher a nova versão, 1.1.0.
**nota**
Ao contrário dos novos produtos, as novas versões são publicadas com total disponibilidade pública. Você só pode testá-los AWS Marketplace sem que os clientes os vejam se o produto como um todo estiver em versão limitada.
1. **Atualizar as informações do produto**: com a versão 1.1.0 disponível, o vendedor informa os compradores sobre o novo recurso atualizando as informações do produto com o novo texto de destaque descrevendo o recurso.
1. **Adicionar uma versão secundária**: quando o vendedor corrige um bug na versão 1.1.0, ele o libera adicionando uma nova versão 1.1.1. Agora, os compradores têm a opção de usar a versão 1.0.0, 1.1.0 ou 1.1.1.
1. **Restringir uma versão**: o vendedor decide que o bug é sério o suficiente para não querer que os compradores possam usar a versão 1.1.0, então restringe essa versão. Nenhum novo cliente pode comprar a versão 1.1.0 (eles só podem escolher 1.0.0 ou 1.1.1), embora os compradores existentes ainda tenham acesso a ela.
1. **Atualizar as informações da versão**: para ajudar os compradores existentes, o vendedor atualiza as informações da versão 1.1.0 com uma sugestão de atualização para a versão 1.1.1.
1. **Monitore o uso** — À medida que os compradores compram e usam o produto, o vendedor monitora as vendas, o uso e outras métricas usando AWS Marketplace [Relatórios de vendedores, feeds de dados e painéis em AWS Marketplace](reports-and-data-feed.md) o.
1. **Remova o produto** — Quando o produto não é mais necessário, o vendedor o remove AWS Marketplace.
Neste exemplo, o vendedor criou três versões diferentes da AMI no produto, mas somente duas estavam disponíveis para novos compradores (antes de remover o produto).
Para fazer modificações nas versões ou nas informações do produto, você cria [solicitações de alteração](single-ami-create-change-request.md) no Portal de gerenciamento do AWS Marketplace.
Para obter instruções detalhadas sobre as etapas para criar e gerenciar seu produto baseado em AMI, consulte [Criação de produtos baseados em AMI](ami-single-ami-products.md).
## Códigos de produto de AMI
Um código de produto exclusivo é atribuído ao produto quando você o cria no AWS Marketplace. Esse código de produto está associado à AMI do produto e é usado para rastrear o uso do produto. Os códigos do produto são propagados automaticamente à medida que os compradores usam o software. Por exemplo, um cliente assina e executa uma AMI, a configura e produz uma nova AMI. Como a nova AMI ainda contém o código do produto original, o rastreamento de uso correto e as permissões permanecem em vigor.
**nota**
O *código* do produto é diferente do *ID* do produto. Cada produto em AWS Marketplace recebe uma ID de produto exclusiva. O ID de produto é usado para identificar o produto no catálogo do AWS Marketplace , no faturamento do cliente e nos relatórios do vendedor. O código do produto é anexado às instâncias criadas a partir da AMI como metadados da instância. Quando uma AMI com esse código de produto é usada para criar uma instância, o cliente recebe uma fatura que mostra o ID do produto associado. Depois de criar seu produto, encontre o código do produto e a ID do produto na Portal de gerenciamento do AWS Marketplace página do seu produto.
Como vendedor, seu software pode obter o código do produto para a instância do Amazon Elastic Compute Cloud (Amazon EC2) em execução em tempo de execução a partir dos metadados da instância. Use o código do produto para segurança extra, como a validação do código do produto na inicialização. As chamadas da API para um código do produto da AMI não podem ser feitas até que o produto seja publicado em um estado limitado para testes. Para obter mais informações sobre como verificar o código do produto, consulte [Verificando se o software está sendo executado na sua AMI AWS Marketplace](best-practices-for-building-your-amis.md#verifying-ami-runtime).
## Solicitações de alteração
Para fazer alterações em um produto ou versão em AWS Marketplace, você envia uma **solicitação de alteração** por meio do Portal de gerenciamento do AWS Marketplace. As solicitações de alteração são adicionadas a uma fila e podem levar de minutos a dias para serem resolvidas, dependendo do tipo de solicitação. Você pode ver o status das solicitações no Portal de gerenciamento do AWS Marketplace.
**nota**
Além do Portal de gerenciamento do AWS Marketplace, você também pode criar solicitações de alteração usando a [API de AWS Marketplace catálogo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/seller-products.html).
Os tipos de alterações que você pode solicitar para produtos baseados em AMI incluem:
+ Atualize as informações do produto exibidas aos compradores.
+ Atualize as informações da versão exibidas aos compradores.
+ Adicione uma nova versão do produto.
+ Restrinja uma versão para que novos compradores não possam mais acessá-la.
+ Atualize o em Regiões da AWS que um produto está disponível.
+ Atualize os preços e os tipos de instância de um produto.
+ Remova um produto do AWS Marketplace.
**nota**
Algumas solicitações de alteração exigem que você use formulários de carregamento de produtos para criar a solicitação. Para obter mais informações, consulte [Formulários de carregamento de produtos](#ami-product-load-forms).
### Atualizar solicitação de alteração
As solicitações de alteração que começam com uma atualização carregarão os detalhes atuais. Você então pode fazer atualizações, que substituem os detalhes existentes.
### Adicionar ou restringir a solicitação de alteração
Adicionar e restringir pares de solicitações são especificamente para etapas e atualizações que são provisionadas após o sucesso de cada solicitação. Uma solicitação é bem-sucedida depois que você escolhe as ações **Salvar e sair** e **Enviar** na experiência de autoatendimento.
Por exemplo, se o ativo da AMI for provisionado para as instâncias e regiões depois de adicionado, elas só poderão ser restringidas em vez de completamente removidas. Isso significa que os assinantes e usuários existentes podem continuar usando o produto até que a assinatura ou o contrato acabe. No entanto, nenhum novo assinante pode ser adicionado a um produto com status **Restrito**.
## Formulários de carregamento de produtos
Normalmente, você usa [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) para criar ou editar o produto. No entanto, algumas operações exigem de você usar um *Formulário de carregamento do produto* (PLF).
Um PLF é uma planilha que contém todas as informações sobre um produto. Para obter um PLF, você pode:
+ Baixar o PLF para um produto existente na página de detalhes do produto no Portal de gerenciamento do AWS Marketplace.
+ Selecionar um item de menu para uma ação que exija um PLF. Por exemplo, se você criar um novo produto de servidor de faturamento mensal, o sistema pedirá para baixar o PLF indicado.
Se a ação for uma edição em um produto existente, o PLF será pré-preenchido com as informações desse produto, então você só precisará alterar os detalhes que você quer atualizar.
+ Se você precisar de um novo PLF em branco, navegue até a página de [upload do Portal de gerenciamento do AWS Marketplace arquivo](https://aws.amazon.com/marketplace/management/product-load). A página contém links PLFs para o tipo de produto que você deseja criar.
Depois de concluir seu PLF, carregue-o na página de [upload de Portal de gerenciamento do AWS Marketplace arquivo](https://aws.amazon.com/marketplace/management/product-load). O PLF em si tem instruções mais detalhadas na guia **Instruções**.
## Emendas do contrato anual
As alterações horárias do plano anual (anual) permitem que você e seus compradores façam as seguintes alterações nos planos existentes:
+ Alterne entre famílias de tipos de EC2 instância da Amazon
+ Alterne entre tamanhos de tipo de EC2 instância da Amazon
+ Adicionar um novo tipo de instância
+ Aumentar a quantidade de um tipo de instância existente no contrato
Os compradores podem fazer uma alteração, desde que o custo proporcional da alteração seja maior que zero (eles não podem reduzir o valor da assinatura). O custo proporcional das EC2 instâncias Amazon recém-adicionadas é baseado no custo anual do tipo de instância ajustado para o prazo restante do contrato. Ao trocar de tipo de instância, o custo proporcional do tipo de EC2 instância Amazon removido é deduzido do custo proporcional do tipo de instância Amazon recém-adicionado. EC2
Nenhuma ação adicional é necessária para permitir emendas aos produtos anuais da AMI. As emendas são suportadas em todos os contratos feitos a partir de ofertas públicas e acordos de ofertas privadas que não usam planos de parcelamento.
Você pode ver as alterações feitas por seus compradores nos seguintes painéis:
+ [Painel de contratos e renovações](https://docs.aws.amazon.com/marketplace/latest/userguide/agreements-renewals-dashboard.html): a lista de contratos alterados.
+ [Painel de receita faturada](https://docs.aws.amazon.com/marketplace/latest/userguide/billed-revenue-dashboard.html): cobranças para o cliente.
+ [Painel de cobranças e despesas](https://docs.aws.amazon.com/marketplace/latest/userguide/collections-disbursement-dashboard.html): a despesa.
## Produtos FPGA
Os produtos FPGA (Field Programmable Gate Array) são produtos especializados de AMI que oferecem suporte a tipos de instância F2 com configurações Amazon FPGA Image (AFI). Diferentemente do padrão AMIs, os produtos FPGA incluem AFI IDs que são carregadas dinamicamente pela AMI para aceleração de hardware em tipos de instância compatíveis.
**Características principais:**
+ Os produtos FPGA oferecem suporte a tipos de instância F2 exclusivamente para aceleração de FPGA.
+ Cada versão do produto pode incluir uma ou mais AFI IDs, com um máximo de 15 AFI IDs por versão.
+ AFIs são carregados on-the-fly em vez de lançados AMIs, fornecendo recursos dinâmicos de aceleração de hardware.
+ Quando você adiciona novas regiões ao seu produto FPGA, a clonagem automática de AFI regional é realizada AWS Marketplace para garantir que seu produto esteja disponível em todas as regiões suportadas. AWS
+ Embora os produtos FPGA possam ser oferecidos em outros tipos de instância, eles só AFIs serão carregados e fornecerão aceleração de hardware nos tipos de instância F2. Em outros tipos de instância, a AMI funciona sem os recursos de aceleração de FPGA.
Os produtos FPGA são ideais para cargas de trabalho de computação intensiva que exigem aceleração de hardware especializada, como pesquisa genômica, análise financeira, processamento de vídeo em tempo real, análise de big data e inferência de aprendizado de máquina. O carregamento dinâmico do AFIs permite que os compradores aproveitem a aceleração do FPGA sem gerenciar a infraestrutura subjacente do FPGA.
# Criação de produtos baseados em AMI
A experiência de autoatendimento da imagem de máquina da Amazon (AMI) orienta você à medida que cria a lista de produtos e faz solicitações de alteração. Ao usar a experiência de autoatendimento, você pode atualizar sua lista de produtos diretamente com menos tempo necessário para processamento pela equipe de operações do AWS Marketplace vendedor. Muitas etapas da experiência de autoatendimento se alinham ao sistema de catálogos AWS Marketplace, o que facilita a validação direta em vez de esperar pelo processamento e validação da equipe de operações do AWS Marketplace vendedor. O procedimento a seguir explica como usar a experiência de autoatendimento da AMI para criar uma lista de produtos para uma única AMI. Os clientes usam as AMIs para criar instâncias do Amazon EC2 com seu produto já instalado e configurado.
**Topics**
+ [Pré-requisitos](#single-ami-prerequisites)
+ [Entender a experiência de autoatendimento](#understand-ami-self-service-exp)
+ [Criar a lista](#ami-create-product)
+ [Recursos adicionais do](#ami-single-create-resources)
## Pré-requisitos
Antes de criar uma lista de produtos de AMI, você precisará concluir os seguintes pré-requisitos:
1. Ter acesso ao Portal de gerenciamento do AWS Marketplace. Essa é a ferramenta que você usa para se registrar como vendedor e gerenciar os produtos nos quais você vende AWS Marketplace. Para saber mais sobre como obter acesso ao Portal de gerenciamento do AWS Marketplace, consulte[Políticas e permissões para AWS Marketplace vendedores](detailed-management-portal-permissions.md).
1. Registre-se como vendedor e, se quiser cobrar por seus produtos, envie suas informações fiscais e bancárias. Para saber mais sobre como se tornar um vendedor, consulte [Começando como AWS Marketplace vendedor](user-guide-for-sellers.md).
1. Tenha um produto que você deseja vender. Para produtos baseados em AMI, isso normalmente significa que você criou ou modificou seu software de servidor e criou uma AMI para seus clientes usarem. Para saber mais sobre como preparar uma AMI para uso em AWS Marketplace, consulte[Melhores práticas de construção AMIs para uso com AWS Marketplace](best-practices-for-building-your-amis.md).
## Entender a experiência de autoatendimento
A experiência de autoatendimento orienta você na criação de seu produto no. AWS Marketplace Ao seguir as etapas, você especifica as informações do produto e as configurações de implantação da AMI Região da AWS, como tipos de instância e detalhes da AMI. Você também configura os detalhes da transação, incluindo preços, disponibilidade do país, EULA e política de reembolso. Como opção, você pode especificar uma lista de permissões Conta da AWS IDs para acessar e testar o produto enquanto ele estiver no status **Limitado**.
Antes de começar, analise os seguintes aspectos principais da experiência de autoatendimento:
+ Você só pode ir para a próxima etapa depois de preencher os campos obrigatórios na etapa atual. Esse requisito ocorre porque há validação no nível da página no final de cada etapa. Você não pode salvar ou enviar uma etapa incompleta.
+ Se precisar encerrar a sessão antes de concluir todas as etapas do processo, você pode escolher **Salvar e sair** para enviar as etapas concluídas para a área de preparação.
+ Uma etapa incompleta e que não passa na validação não é enviada ao sistema. Uma etapa parcialmente concluída não é válida e não pode ser salva.
+ Quando você escolhe **Salvar e sair**, a caixa de diálogo **Salvar e sair** mostra as etapas que passaram pelas verificações de validação. Você pode revisar e optar por salvar até as últimas etapas concluídas e validadas. Se houver um erro de validação ou detalhes ausentes, você pode escolher **Corrigir** para voltar a essa etapa.
+ Depois de **Salvar e sair**, a solicitação será analisada durante o processamento. Pode levar alguns minutos ou horas para concluir o processamento. Você não pode continuar as etapas ou fazer alterações até que a solicitação seja bem-sucedida. Para o primeiro **Salvar e sair**, a solicitação está criando o produto paralelamente às etapas que você concluiu.
+ Depois que a solicitação for **Bem-sucedida**, você concluiu o salvamento. Para retomar as alterações na página **Visão geral do produto**, escolha **Continuar a criação do produto** ou use **Solicitar alterações** para atualizar os detalhes enviados anteriormente na última sessão. Ao continuar, observe que as etapas concluídas estão marcadas com um rótulo verde de **Bem-sucedida**. Para atualizar uma etapa enviada anteriormente, use **Solicitar alterações**. A solicitação anterior de **Salvar e sair** deve ser concluída antes que você possa continuar com essa etapa.
+ Depois de concluir todas as etapas, você pode escolher **Avançar** para ver uma avaliação. Escolha **Enviar** quais solicitações para que o sistema realize uma validação final. Depois de receber uma resposta **Bem-sucedida**, o produto passa para o status **Limitado**. Você pode ver na página de detalhes que o produto agora está disponível para qualquer pessoa na lista de permissões. Se a solicitação falhar, o produto permanecerá no status **Preparação** e exigirá que você faça correções antes de reenviar.
## Criar a lista
As etapas desta seção explicam como criar uma listagem para um produto de AMI única.
**nota**
Você só pode ir para a próxima etapa quando preencher os campos obrigatórios na etapa atual. Você não pode salvar ou enviar uma etapa incompleta. Se precisar encerrar a sessão antes de concluir todas as etapas do processo, escolha **Salvar e sair** para enviar as etapas concluídas para a área de preparação. Para obter mais informações, consulte [Entender a experiência de autoatendimento](#understand-ami-self-service-exp).
**Para criar um produto de AMI única**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. No menu **Produtos**, escolha **Servidor**. Ou você pode ir diretamente para a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server).
1. Na guia **Produtos de servidor**, selecione **Criar produto de servidor**, selecione **Imagem de máquina da Amazon (AMI)** e, em seguida, selecione um dos tipos de licenciamento para produtos de AMI única:
+ **Traga sua própria licença (BYOL)** — Um produto do qual o usuário obtém uma licença externa sua. AWS Marketplace Pode ser uma licença paga ou gratuita.
+ **Gratuito**: um produto que é gratuito para seus assinantes usarem. (Eles ainda pagarão taxas por qualquer instância associada do Amazon Elastic Compute Cloud (Amazon EC2) ou outros recursos.) AWS
+ **Pago por hora ou por** hora — Um produto pelo qual o comprador paga por hora ou por hora com um contrato anual. AWS faz a medição com base no código do produto na AMI.
+ **Pago mensalmente**: um produto pelo qual o comprador é cobrado pela AWS mensalmente.
+ **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 ao cliente.
+ **AMI com preço de contrato** — Um produto de AMI única ou AMI única com uma CloudFormation pilha pela qual o comprador paga uma taxa inicial.
1. A experiência de autoatendimento orienta você nas etapas para criar uma lista do AWS Marketplace . Você deve inserir informações do produto (metadados), detalhes de implantação do produto (instâncias da Região da AWS e detalhes da AMI) e detalhes da oferta pública (preço, EULA, disponibilidade por país, EULA, reembolso). Como opção, você pode adicionar contas à lista de permissões para testar o produto. Conclua cada etapa para passar para a próxima etapa do processo.
**nota**
Se precisar encerrar a sessão antes de concluir todas as etapas do processo, você pode usar a função **Salvar e sair** para enviar as etapas concluídas para a área de preparação. Isso cria uma solicitação para que as informações fornecidas sejam validadas. Enquanto a solicitação está sendo processada, você não pode editar o produto. Depois que a solicitação for bem-sucedida, você poderá continuar criando o produto escolhendo **Retomar a criação do produto**.
Uma solicitação com falha indica que nenhuma atualização foi feita no produto devido a um erro de validação. Isso ficará visível no log de solicitações do seu produto. Você pode selecionar a solicitação para visualizar o erro, usar **Copiar para novo** em **Ações** para corrigir o erro e reenviar a solicitação. Ao retomar as etapas, você pode continuar a partir da etapa depois da que foi salva na última sessão. Para atualizar as etapas anteriores, acesse a página de visão geral do produto e envie uma Solicitação de alteração para atualizar as etapas que você enviou anteriormente.
1. Depois de inserir as informações necessárias para todas as etapas da solicitação de alteração, escolha **Enviar**. Esse envio cria uma solicitação no sistema de catálogos do AWS Marketplace para validar as informações e liberar o produto para um estado **Limitado**, se a validação for aprovada. Enquanto a solicitação estiver sendo processada, você não poderá continuar editando o produto. Depois que a solicitação for bem-sucedida, o produto será movido para um estado **Limitado**.
+ Quando seu produto é publicado inicialmente, ele só pode ser acessado pela sua conta de teste Conta da AWS (aquela que você usou para criar o produto) e pela equipe de operações do AWS Marketplace vendedor. Se você visualizar o produto na página de **produtos do Server**, poderá escolher **Exibir ativado AWS Marketplace** para ver os detalhes do produto conforme eles aparecerão AWS Marketplace para os compradores. Essa lista detalhada não está visível para outros AWS Marketplace usuários.
+ Esse recurso permite que você teste seu produto (e até mesmo publique várias versões para teste) antes de lançá-lo publicamente.
1. Teste seu produto no estado **Limitado** e certifique-se de que ele segue os [requisitos do produto AWS Marketplace baseados na AMI](https://docs.aws.amazon.com/marketplace/latest/userguide/product-and-ami-policies.html) e a lista de verificação do [produto](https://docs.aws.amazon.com/marketplace/latest/userguide/aws-marketplace-listing-checklist.html). Em seguida, para solicitar que seu produto seja publicado para o **Público**, escolha **Atualizar visibilidade**. A equipe de operações do AWS Marketplace vendedor deve analisar seu produto antes de aprová-lo como **público**.
**nota**
A verificação e publicação do produto é um processo manual, conduzido pela equipe de operações do AWS Marketplace vendedor. A publicação da versão inicial do produto pode levar de 7 a 10 dias úteis, se não houver erros. Para obter mais detalhes sobre o tempo, consulte [Tempo e expectativas](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#timing-and-expectations).
Para obter mais informações sobre como preparar e enviar seu produto de AMI única e as informações do produto, consulte [Recursos adicionais do](#ami-single-create-resources).
## Recursos adicionais do
Para obter mais informações sobre como preparar as informações do produto e enviá-las para publicação, consulte os seguintes recursos:
+ [Preparando seu produto para AWS Marketplace](product-preparation.md)
+ [Enviando seu produto para publicação em AWS Marketplace](product-submission.md)
Para obter mais informações sobre como preparar seu produto de AMI única para envio ao AWS Marketplace, consulte os seguintes recursos:
+ [Melhores práticas de construção AMIs para uso com AWS Marketplace](best-practices-for-building-your-amis.md)
+ [Lista de verificação de produtos da AMI para AWS Marketplace](aws-marketplace-listing-checklist.md)
+ [Requisitos de produto baseados em AMI para AWS Marketplace](product-and-ami-policies.md)
# Adicione CloudFormation modelos ao seu produto
AWS Marketplace os vendedores podem listar produtos baseados em AMI que são entregues aos AWS Marketplace compradores usando modelos. AWS CloudFormation Adicionar um CloudFormation modelo ao seu produto baseado em AMI permite que seus compradores implantem sua solução sem precisar configurar manualmente os recursos e dependências. Os modelos podem ser usados para definir um cluster ou uma arquitetura distribuída para os produtos ou para selecionar diferentes combinações de AMIs ou configurações de produtos. As soluções únicas de AMI podem conter no máximo três CloudFormation modelos.
Os CloudFormation modelos podem ser configurados para fornecer uma única Amazon Machine Image (AMI) com arquivos de configuração associados e funções Lambda. Além disso, você deve incluir um diagrama arquitetônico para cada modelo.
**Topics**
+ [Preparando seu CloudFormation modelo](#aws-cloudformation-template-preparation)
+ [Diagrama de arquitetura](#topology-diagram)
+ [Converta CloudFormation modelos de produtos existentes](#convert-cloudformation-templates)
+ [Adicionar componentes de aplicativo sem servidor](cloudformation-serverless-application.md)
## Preparando seu CloudFormation modelo
Para criar seus CloudFormation modelos, você deve atender aos pré-requisitos do modelo e fornecer os parâmetros de entrada e segurança necessários. Ao enviar seu CloudFormation modelo, use as diretrizes nas seções a seguir.
### Pré-requisitos de modelos
+ Verifique se o modelo foi lançado com sucesso por meio do CloudFormation console **em todos os recursos Regiões da AWS habilitados para seu produto**. Você pode usar a [TaskCat ferramenta](https://github.com/aws-quickstart/taskcat) para testar seus modelos.
+ AMIs incluído em seu CloudFormation modelo deve ser a AMI do produto que você está publicando ou uma AMI gerenciada pela AWS, como a última versão do Amazon Linux 2. Não inclua nenhuma AMI comunitária ou AMI de propriedade e compartilhada por você ou por terceiros. Para usar uma AMI gerenciada pela AWS, use [parâmetros públicos no AWS Systems Manager Parameter Store em](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters.html) vez da AMI codificada. IDs Por exemplo, em seu CloudFormation modelo em que você especifica a ID da AMI, você usa uma referência dinâmica`ImageId: '{{resolve:ssm:/aws/service/ecs/optimized-ami/amazon-linux-2/recommended/image_id}}'`.
+ Crie modelos de forma que não dependam do uso de uma determinada zona de disponibilidade (AZ). Nem todos os clientes têm acesso a todos AZs e AZs são mapeados de forma diferente para contas diferentes.
+ Se estiver criando uma solução clusterizada usando um grupo do Auto Scaling, recomendamos considerar um evento de escalabilidade. O novo nó deve ingressar no cluster em execução automaticamente.
+ Mesmo para produtos de nó único, recomendamos o uso de um [Grupo de Auto Scaling](https://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html).
+ Se sua solução envolver um cluster de várias instâncias, considere usar placement groups para ter baixa latência de rede, alta taxa de transferência de rede ou ambas entre as instâncias.
+ Para facilitar a revisão pela AWS Marketplace equipe e transparência para o cliente, recomendamos que você adicione comentários em sua **UserData**seção.
### Requisitos para obter detalhes de AMI
**nota**
Se você criar uma **Amazon Machine Image (AMI) ou AMI CloudFormation** na página de [produtos do servidor](https://aws.amazon.com//marketplace/management/products/server) do portal do vendedor e for solicitado a baixar o [formulário de carregamento do produto](https://docs.aws.amazon.com//marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product), consulte [Requisitos para obter detalhes da AMI usando o formulário de carregamento do produto](#ami-requirements-product-load-form) em vez disso.
Ao especificar a `ImageId` propriedade dos recursos que implantam sua AMI em instâncias do EC2 [AWS::EC2::Instance](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-ec2-instance.html), como, e [AWS::EC2::LaunchTemplate](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-ec2-launchtemplate.html)recursos [AWS::AutoScaling::LaunchConfiguration](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-autoscaling-launchconfiguration.html), você deve fazer referência a um parâmetro de [modelo](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/parameters-section-structure.html). O tipo de parâmetro deve ser um `AWS::EC2::Image::Id`, `AWS::SSM::Parameter::Value` ou `String`.
Você pode nomear esse parâmetro de modelo com qualquer nome de parâmetro válido. AWS Marketplace [copia seu modelo para seus próprios buckets do Amazon S3 e substitui o parâmetro especificado por um AWS Systems Manager parâmetro do Parameter Store.](https://docs.aws.amazon.com//systems-manager/latest/userguide/systems-manager-parameter-store.html) AWS Marketplace também atualiza a descrição e o texto da restrição para deixar claro o valor correto para os compradores que estão implantando o modelo. Quando os compradores implantam o modelo, esse parâmetro é resolvido para o ID de AMI específico da Região da AWS do produto publicado.
Os exemplos de modelo a seguir ilustram a propriedade `ImageId` que referencia parâmetros de modelo usando a função intrínseca [Ref](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html).
Exemplo de YAML:
```
Parameters:
ImageId:
Type: AWS::EC2::Image::Id
Default: ami-example1234567890
Resources:
MyInstance:
Type: AWS::EC2::Instance
Properties:
ImageId: !Ref ImageId
```
Exemplo de JSON:
```
{
"Parameters": {
"ImageId": {
"Type": "AWS::EC2::Image::Id",
"Default": "ami-example1234567890"
}
},
"Resources": {
"MyInstance": {
"Type": "AWS::EC2::Instance",
"Properties": {
"ImageId": {
"Ref": "ImageId"
}
}
}
}
}
```
Se você estiver implantando instâncias do EC2 dentro de uma [pilha aninhada](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html) em vez da pilha raiz, o ID de AMI deverá herdar dinamicamente o valor da pilha raiz. Edite as pilhas raiz e aninhadas, de maneira que, na pilha raiz, a definição do valor do parâmetro do modelo substitua o ID de AMI usado nessa pilha aninhada.
### Requisitos para obter detalhes da AMI usando o formulário de carregamento do produto
**nota**
Quando você cria uma **Amazon Machine Image (AMI) ou AMI CloudFormation** na página de [produtos do servidor](https://aws.amazon.com//marketplace/management/products/server) do portal do vendedor e não é imediatamente solicitado a baixar o [formulário de carregamento do produto](https://docs.aws.amazon.com//marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product), consulte [Requisitos para obter detalhes de AMI](#ami-requirements-sse) em vez disso.
AMIs deve estar em uma tabela de mapeamento para cada região. A AWS Marketplace equipe atualiza a AMI IDs depois que ela é clonada. A AMI de origem deve estar na região `us-east-1`. As outras regiões podem usar espaços reservados.
Exemplo de YAML:
```
Mappings:
RegionMap:
us-east-1:
ImageId: ami-0123456789abcdef0
us-west-1:
ImageId: ami-xxxxxxxxxxxxxxxxx
eu-west-1:
ImageId: ami-xxxxxxxxxxxxxxxxx
ap-southeast-1:
ImageId: ami-xxxxxxxxxxxxxxxxx
Resources:
EC2Instance:
Type: AWS::EC2::Instance
Properties:
ImageId: !FindInMap
- RegionMap
- !Ref AWS::Region
- ImageId
```
### Requisitos para modelos de pilha aninhada
**nota**
Esta seção só se aplica a modelos de definição de preço que não usem o [formulário de carregamento do produto](https://docs.aws.amazon.com//marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product). Para modelos de definição de preço que *usem* o formulário de carregamento do produto, somente uma string fixa é permitida para a propriedade `TemplateURL` da pilha aninhada.
Se o modelo incluir [pilhas aninhadas](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html), a propriedade `TemplateURL` de recursos da pilha aninhada deverá referenciar os parâmetros de modelo do nome do bucket do Amazon S3, da região do bucket e do prefixo de chave do objeto do Amazon S3. Os nomes de parâmetro do nome do bucket devem ser `MPS3BucketName`, a região do bucket deve ser `MPS3BucketRegion` e o prefixo da chave de objeto deve ser `MPS3KeyPrefix`.
Defina os valores padrão para que esses parâmetros correspondam ao bucket do Amazon S3 onde os modelos aninhados são armazenados. Todos os modelos aninhados devem ser publicamente acessíveis. Quando você envia seu modelo para publicação, AWS Marketplace copia seus modelos para seus próprios buckets do Amazon S3 e modifica as propriedades desses três parâmetros para que o valor padrão e o valor permitido sejam definidos de acordo com o local em que as cópias são armazenadas. AWS Marketplace também atualiza a descrição e o texto da restrição para deixar os valores corretos claros para os compradores que estão implantando o modelo.
Se você tiver vários níveis de pilhas aninhadas, todas as pilhas aninhadas que criam pilhas aninhadas adicionais deverão ser configuradas para que a propriedade `TemplateURL` herde dinamicamente os valores do nome do bucket do Amazon S3, da região do bucket do Amazon S3 e da chave de objeto do Amazon S3 da pilha raiz. Edite as pilhas raiz e aninhadas para que, na pilha raiz, a definição do valor do parâmetro do modelo `MPS3BucketName`, `MPS3BucketRegion` e `MPS3KeyPrefix` substitua os respectivos valores na URL usada nessa pilha aninhada para criar pilhas aninhadas adicionais.
Os exemplos de modelo a seguir ilustram a propriedade `TemplateURL` que referencia parâmetros de modelo usando a função intrínseca [Fn::Sub](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-sub.html).
Exemplo de YAML:
```
AWSTemplateFormatVersion: '2010-09-09'
Metadata:
AWS::CloudFormation::Interface:
ParameterGroups:
- Label:
default: AWS Marketplace Parameters
Parameters:
- ImageId
- MPS3BucketName
- MPS3BucketRegion
- MPS3KeyPrefix
Parameters:
ImageId:
Type: AWS::EC2::Image::Id
Default: ami-example1234567890
Description: The AMI that will be used to launch EC2 resources.
MPS3BucketName:
Type: String
Default: sellerbucket
Description: Name of the S3 bucket for your copy of the nested templates.
MPS3BucketRegion:
Type: String
Default: us-east-1
Description: AWS Region where the S3 bucket for your copy of the nested templates is hosted.
MPS3KeyPrefix:
Type: String
Default: sellerproductfolder/
Description: S3 key prefix that is used to simulate a folder for your copy of the nested templates.
Resources:
EC2Instance:
Type: AWS::EC2::Instance
Properties:
ImageId: !Ref ImageId
NestedStack:
Type: AWS::CloudFormation::Stack
Properties:
TemplateURL: !Sub https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml
```
Exemplo de JSON:
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Metadata": {
"AWS::CloudFormation::Interface": {
"ParameterGroups": [
{
"Label": {
"default": "AWS Marketplace Parameters"
},
"Parameters": [
"ImageId",
"MPS3BucketName",
"MPS3BucketRegion",
"MPS3KeyPrefix"
]
}
]
}
},
"Parameters": {
"ImageId": {
"Type": "AWS::EC2::Image::Id",
"Default": "ami-example1234567890",
"Description": "The AMI that will be used to launch EC2 resources."
},
"MPS3BucketName": {
"Type": "String",
"Default": "sellerbucket",
"Description": "Name of the S3 bucket for your copy of the nested templates."
},
"MPS3BucketRegion": {
"Type": "String",
"Default": "us-east-1",
"Description": "AWS Region where the S3 bucket for your copy of the nested templates is hosted."
},
"MPS3KeyPrefix": {
"Type": "String",
"Default": "sellerproductfolder/",
"Description": "S3 key prefix that is used to simulate a folder for your copy of the nested templates."
}
},
"Resources": {
"EC2Instance": {
"Type": "AWS::EC2::Instance",
"Properties": {
"ImageId": {
"Ref": "ImageId"
}
}
},
"NestedStack": {
"Type": "AWS::CloudFormation::Stack",
"Properties": {
"TemplateURL": {
"Fn::Sub": "https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml"
}
}
}
}
}
```
**nota**
[AWS::CloudFormation::Interface](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-interface.html)é usado para definir como os parâmetros são agrupados e classificados no AWS CloudFormation console quando os compradores implantam seu modelo.
### Parâmetros de entrada de modelos
+ Os parâmetros de entrada no modelo não devem incluir AWS as credenciais do AWS Marketplace cliente (como senhas, chaves públicas, chaves privadas ou certificados).
+ Para parâmetros de entradas confidenciais, como senhas, escolha a propriedade `NoEcho` e habilite expressão regular mais forte. Para outros parâmetros de entrada, defina as entradas mais comuns juntamente com texto auxiliar apropriado.
+ Use tipos de CloudFormation parâmetros para entradas, quando disponíveis.
+ Use `AWS::CloudFormation::Interface` para agrupar e classificar parâmetros de entrada.
+ Não defina nenhum valor padrão para os seguintes parâmetros de entrada:
**nota**
Os clientes devem fornecer essas informações como parâmetros de entrada.
+ Intervalos CIDR padrão que permitem a entrada em portas de acesso remoto a partir da Internet pública
+ Intervalos CIDR padrão que permitem a entrada em portas de conexão de banco de dados a partir da Internet pública
+ Senhas padrão para usuários ou bancos de dados
### Parâmetros de rede e segurança
+ Verifique se a porta SSH padrão (22) ou a porta RDP (3389) não está aberta para 0.0.0.0.
+ Em vez de usar a nuvem privada virtual (VPC) padrão, recomendamos que você crie uma VPC com listas de controle de acesso (ACLs) e grupos de segurança apropriados.
+ Seu modelo não pode solicitar chaves de acesso de longo prazo dos usuários nem criá-las para acessar AWS recursos. Se seu aplicativo de AMI exigir acesso aos AWS serviços na conta do comprador, ele deverá usar [funções do IAM para o Amazon EC2](/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html).
+ Defina perfis e políticas do IAM para [conceder o privilégio mínimo](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) e permitir acesso de gravação apenas quando absolutamente necessário. Por exemplo, se o aplicativo precisar apenas das operações `S3:GET`, `PUT` e `DELETE`, especifique apenas essas ações. Não recomendamos o uso de `S3:*` nesse caso.
Depois que seu modelo for recebido, AWS Marketplace valida a configuração e as informações do produto e fornece feedback sobre as revisões necessárias.
## Diagrama de arquitetura
Você deve fornecer um diagrama de arquitetura para cada modelo. Para saber mais sobre diagramação, consulte [O que é diagramação de arquitetura](https://aws.amazon.com/what-is/architecture-diagramming/)?
O diagrama deve atender aos seguintes critérios:
+ Ilustre uma implantação padrão em. AWS
+ Descreva logicamente onde os recursos são implantados. Por exemplo, recursos da, como instâncias do Amazon EC2, estão na sub-rede correta.
+ Use os ícones de AWS produto mais atuais para cada um AWS service (Serviço da AWS) implantado por meio do CloudFormation modelo. Para baixar o conjunto atual de ícones de arquitetura, consulte [Ícones de arquitetura da AWS](https://aws.amazon.com/architecture/icons/).
+ Inclua metadados para todos os serviços implantados pelo CloudFormation modelo.
+ Inclua todas as VPCs redes e sub-redes implantadas pelo modelo. CloudFormation
+ Mostre pontos de integração, incluindo ativos de terceiros APIs e ativos híbridos locais.
+ Diagramas devem ter um tamanho de 1.100 x 700 pixels. Mantenha as proporções originais do diagrama sem esticar ou cortar.
## Converta CloudFormation modelos de produtos existentes
**nota**
Esta seção é para vendedores com uma AMI existente com CloudFormation produto que usaram o [formulário de carregamento de produto](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product) para publicar seus modelos e agora desejam atualizar esse modelo sem usar o formulário de carregamento de produto. Se você estiver publicando um novo produto, consulte [Preparando seus CloudFormation modelos](https://docs.aws.amazon.com/marketplace/latest/userguide/cloudformation.html#aws-cloudformation-template-preparation).
Se você criar uma **Amazon Machine Image (AMI) ou AMI CloudFormation** na página de [produtos do servidor](https://aws.amazon.com//marketplace/management/products/server) do portal do vendedor e for solicitado a baixar o [formulário de carregamento do produto](https://docs.aws.amazon.com//marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product), consulte[Requisitos para obter detalhes da AMI usando o formulário de carregamento do produto](#ami-requirements-product-load-form).
Se você quiser usar a experiência de autoatendimento para atualizar um produto existente que anteriormente usava o [formulário de carregamento de produto](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#aws-cloudformation-launched-product-free-or-paid-or-usage-based-paid-ami-product) para publicar, você deve fazer alterações no seu CloudFormation modelo existente.
A seguinte tabela descreve a diferença entre o uso do formulário de carregamento do produto e a experiência de autoatendimento:
****
| | Formulário de carregamento do produto | Experiência de autoatendimento |
| --- | --- | --- |
| Valor da propriedade ImageId para recursos do EC2 | Referencia uma tabela de mapeamento para o ID de AMI. Para obter mais informações, consulte [Requisitos para obter detalhes da AMI usando o formulário de carregamento do produto](#ami-requirements-product-load-form). | Referencia um parâmetro de modelo para o ID de AMI. Para obter mais informações, consulte [Requisitos para obter detalhes de AMI](#ami-requirements-sse). |
| Valor da propriedade TemplateURL para pilhas aninhadas | Deve ser uma string fixa e não pode usar funções intrínsecas. | Pode ser dinâmico usando funções intrínsecas. Deve referenciar um conjunto de parâmetros do modelo. Para obter mais informações, consulte [Requisitos para modelos de pilha aninhada](#nested-stack-template-requirements). |
Os modelos de exemplo a seguir ilustram um exemplo de um produto existente que usou o formulário de carregamento do produto para publicar o modelo. Neste exemplo, o ID de AMI é `ami-example123456` e um modelo aninhado está no bucket S3 de um vendedor no local `https://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml`.
Exemplo de YAML publicado com o formulário de carregamento do produto:
```
AWSTemplateFormatVersion: '2010-09-09'
Mappings:
RegionMap:
us-east-1:
AMI: ami-example123456
Resources:
EC2Instance:
Type: AWS::EC2::Instance
Properties:
ImageId: !FindInMap
- RegionMap
- !Ref AWS::Region
- AMI
NestedStack:
Type: AWS::CloudFormation::Stack
Properties:
TemplateURL: https://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml
```
Exemplo de JSON publicado com o formulário de carregamento do produto:
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Mappings": {
"RegionMap": {
"us-east-1": {
"AMI": "ami-example123456"
}
}
},
"Resources": {
"EC2Instance": {
"Type": "AWS::EC2::Instance",
"Properties": {
"ImageId": {
"Fn::FindInMap": [
"RegionMap",
{
"Ref": "AWS::Region"
},
"AMI"
]
}
}
},
"NestedStack": {
"Type": "AWS::CloudFormation::Stack",
"Properties": {
"TemplateURL": "https://sellerbucket.s3.us-east-1.amazonaws.com/sellerproductfolder/nested-template.yaml"
}
}
}
}
```
Os exemplos de modelo a seguir ilustram as alterações necessárias para usar a experiência de autoatendimento para atualizar o produto.
Exemplo de YAML publicado com a experiência de autoatendimento:
```
AWSTemplateFormatVersion: '2010-09-09'
Metadata:
AWS::CloudFormation::Interface:
ParameterGroups:
- Label:
default: AWS Marketplace Parameters
Parameters:
- ImageId
- MPS3BucketName
- MPS3BucketRegion
- MPS3KeyPrefix
Parameters:
ImageId:
Type: AWS::EC2::Image::Id
Default: ami-example123456
Description: The AMI that will be used to launch EC2 resources.
MPS3BucketName:
Type: String
Default: sellerbucket
Description: Name of the S3 bucket for your copy of the nested templates.
MPS3BucketRegion:
Type: String
Default: us-east-1
Description: AWS Region where the S3 bucket for your copy of the nested templates is hosted.
MPS3KeyPrefix:
Type: String
Default: sellerproductfolder/
Description: S3 key prefix that is used to simulate a folder for your copy of the nested templates.
Resources:
EC2Instance:
Type: AWS::EC2::Instance
Properties:
ImageId: !Ref ImageId
NestedStack:
Type: AWS::CloudFormation::Stack
Properties:
TemplateURL: !Sub https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml
```
Exemplo de JSON publicado com a experiência de autoatendimento:
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Metadata": {
"AWS::CloudFormation::Interface": {
"ParameterGroups": [
{
"Label": {
"default": "AWS Marketplace Parameters"
},
"Parameters": [
"ImageId",
"MPS3BucketName",
"MPS3BucketRegion",
"MPS3KeyPrefix"
]
}
]
}
},
"Parameters": {
"ImageId": {
"Type": "AWS::EC2::Image::Id",
"Default": "ami-example123456",
"Description": "The AMI that will be used to launch EC2 resources."
},
"MPS3BucketName": {
"Type": "String",
"Default": "sellerbucket",
"Description": "Name of the S3 bucket for your copy of the nested templates."
},
"MPS3BucketRegion": {
"Type": "String",
"Default": "us-east-1",
"Description": "AWS Region where the S3 bucket for your copy of the nested templates is hosted."
},
"MPS3KeyPrefix": {
"Type": "String",
"Default": "sellerproductfolder/",
"Description": "S3 key prefix that is used to simulate a folder for your copy of the nested templates."
}
},
"Resources": {
"EC2Instance": {
"Type": "AWS::EC2::Instance",
"Properties": {
"ImageId": {
"Ref": "ImageId"
}
}
},
"NestedStack": {
"Type": "AWS::CloudFormation::Stack",
"Properties": {
"TemplateURL": {
"Fn::Sub": "https://${MPS3BucketName}.s3.${MPS3BucketRegion}.${AWS::URLSuffix}/${MPS3KeyPrefix}nested-template.yaml"
}
}
}
}
}
```
# Adicionar componentes de aplicativo sem servidor
**Importante**
AWS Marketplace não dá mais suporte à publicação de novos produtos com CloudFormation modelos que implantam recursos do AWS Serverless Application Repository. Os vendedores podem continuar publicando produtos existentes com CloudFormation modelos que implantam recursos AWS Serverless Application Repository até uma data futura a ser anunciada.
Você pode criar um produto que inclua uma Amazon Machine Image (AMI), entregue usando um AWS CloudFormation modelo, com componentes sem servidor incorporados ao produto. Por exemplo, você pode criar um produto com uma AMI configurada como um servidor controlador e entregá-lo como uma CloudFormation pilha. O CloudFormation modelo usado para criar a pilha pode incluir a definição para configurar uma AWS Lambda função que é acionada por um evento no servidor. Ao usar essa abordagem para projetar seu produto, você pode simplificar a arquitetura e facilitar o lançamento para seus compradores. Essa abordagem também pode facilitar a atualização do produto. Estas seções mostram como criar e oferecer esse tipo de produto.
Para obter informações sobre como criar uma AMI para o produto, consulte [Produtos baseados em AMI no AWS Marketplace](ami-products.md). Para obter informações sobre como preencher AWS CloudFormation modelos para seu produto, consulte[Adicione CloudFormation modelos ao seu produto](cloudformation.md).
Ao definir seu aplicativo sem servidor, você usa um modelo AWS Serverless Application Model (AWS SAM) que você armazena no. AWS Serverless Application Repository AWS SAM é uma estrutura de código aberto para criar aplicativos sem servidor. Durante a implantação, AWS SAM transforma e expande a sintaxe em AWS Serverless Application Model sintaxe. CloudFormation O AWS Serverless Application Repository é um repositório gerenciado para aplicativos sem servidor. Ele possibilita armazenar e compartilhar aplicativos reutilizáveis para que os compradores possam montar e implantar arquiteturas sem servidor.
**nota**
AWS Marketplace analisa e valida seu produto antes da criação do anúncio. Enviaremos um e-mail se houver problemas a serem resolvidos antes que a oferta seja listada.
Como parte do cumprimento de uma assinatura, copiamos os AMIs aplicativos e CloudFormation modelos sem servidor para um repositório AWS Marketplace próprio em cada um. Região da AWS Quando um comprador assina o seu produto, damos acesso ao comprador e também o notificamos quando você atualiza o software.
**Topics**
+ [Etapa 1: criar uma aplicação de tecnologia sem servidor](#cloudformation-serverless-application-procedure-step-1)
+ [Etapa 2: publicar a aplicação no repositório](#cloudformation-serverless-application-procedure-step-2)
+ [Etapa 3: criar o CloudFormation modelo](#cloudformation-serverless-application-procedure-step-3)
+ [Etapa 4: envie seu CloudFormation modelo e arquivos de configuração](#cloudformation-serverless-application-procedure-step-4)
+ [Etapa 5: atualize as permissões AWS Serverless Application Repository do seu aplicativo](#cloudformation-serverless-application-procedure-step-5)
+ [Etapa 6: compartilhar sua AMI](#cloudformation-serverless-application-procedure-step-6)
+ [Etapa 7: Envie seu CloudFormation produto com AMI e aplicativo sem servidor](#cloudformation-serverless-application-procedure-step-7)
## Etapa 1: criar uma aplicação de tecnologia sem servidor
Sua primeira etapa é empacotar as AWS Lambda funções usadas para criar seu aplicativo sem servidor. O aplicativo é uma combinação de funções do Lambda, fontes de eventos e outros recursos que trabalham juntos para realizar tarefas. Um aplicativo sem servidor pode ser tão simples quanto uma função Lambda ou pode conter várias funções com outros recursos APIs, como bancos de dados e mapeamentos de fontes de eventos.
Use o AWS SAM para definir um modelo para seu aplicativo sem servidor. Para obter descrições de nomes e tipos de propriedades, consulte [AWS::Serverless::Application](https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessapplication)em AWS Labs on GitHub. Veja a seguir um exemplo de um AWS SAM modelo com uma única função e função AWS Identity and Access Management (IAM) do Lambda.
```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: An example of SAM template with Lambda function and IAM role
Resources:
SampleFunction:
Type: AWS::Serverless::Function
Properties:
Handler: 'com.sampleproject.SampleHandler::handleRequest'
Runtime: java8
CodeUri: 's3://amzn-s3-demo-bucket/2EXAMPLE-1234-4b12-ac37-515EXAMPLEe5-lambda.zip'
Description: Sample Lambda function
Timeout: 120
MemorySize: 1024
Role:
Fn::GetAtt: [SampleFunctionRole, Arn]
# Role to execute the Lambda function
SampleFunctionRole:
Type: "AWS::IAM::Role"
Properties:
AssumeRolePolicyDocument:
Statement:
- Effect: "Allow"
Principal:
Service:
- "lambda.amazonaws.com"
Action: "sts:AssumeRole"
ManagedPolicyArns:
- "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole"
Policies:
- PolicyName: SFNXDeployWorkflowDefinitionPolicy
PolicyDocument:
Statement:
- Effect: "Allow"
Action:
- "s3:Get*"
Resource: "*"
RoleName: "SampleFunctionRole"
```
## Etapa 2: publicar a aplicação no repositório
Para publicar um aplicativo, você precisa primeiro fazer upload do código dele. Armazene seus artefatos de código (por exemplo, funções do Lambda, scripts, arquivos de configuração) em um bucket do Amazon S3 da sua conta. Quando você carrega seu aplicativo, ele é inicialmente definido como privado, o que significa que só está disponível para Conta da AWS quem o criou. Você deve criar uma política do IAM que conceda AWS Serverless Application Repository permissões para acessar os artefatos que você enviou.
**Como publicar o aplicativo sem servidor no repositório de aplicativos sem servidor**
1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Escolha o bucket do Amazon S3 que você usou para empacotar o aplicativo.
1. Escolha a aba **Permissões**.
1. Escolha **Política do bucket**.
1. Copie e cole o seguinte exemplo de instrução de política.
**nota**
O exemplo de instrução de política produzirá um erro até que os valores de `aws:SourceAccount` e `Resource` sejam atualizados nas etapas a seguir.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "serverlessrepo.amazonaws.com"
},
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Condition" : {
"StringEquals": {
"aws:SourceAccount": "123456789012"
}
}
}
]
}
```
------
1. Substitua amzn-s3-demo-bucket no valor da propriedade `Resource` pelo nome do seu bucket.
1. *123456789012*Substitua o `Condition` elemento pelo seu Conta da AWS ID. O `Condition` elemento garante que o AWS Serverless Application Repository único tenha permissão para acessar aplicativos a partir do especificado Conta da AWS.
1. Escolha **Salvar**.
1. Abra o AWS Serverless Application Repository console em[https://console.aws.amazon.com/serverlessrepo](https://console.aws.amazon.com/serverlessrepo).
1. Na página **Meus aplicativos**, escolha **Publicar aplicativo**.
1. Preencha os campos obrigatórios e todos os campos opcionais apropriados. Os campos obrigatórios são:
+ **Nome da aplicação**
+ **Autor**
+ **Descrição**
+ **URL do código-fonte**
+ **Modelo do SAM**
1. Escolha **Publicar aplicativo**.
**Para publicar versões subsequentes do aplicativo**
1. Abra o AWS Serverless Application Repository console em[https://console.aws.amazon.com/serverlessrepo](https://console.aws.amazon.com/serverlessrepo).
1. No painel de navegação, em **Meus aplicativos**, escolha o aplicativo.
1. Escolha **Publicar nova versão**.
Para obter mais informações, consulte [Publicação de aplicativos sem servidor usando a CLI AWS SAM](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-template-publishing-applications.html).
## Etapa 3: criar o CloudFormation modelo
Para criar seus CloudFormation modelos, você deve atender aos pré-requisitos do modelo e fornecer os parâmetros de entrada e segurança necessários. Para obter mais informações, consulte [Anatomia do modelo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html) no *Guia do usuário do AWS CloudFormation *.
Em seu CloudFormation modelo, você pode referenciar seu aplicativo sem servidor e sua AMI. Você também pode usar CloudFormation modelos aninhados e fazer referência a aplicativos sem servidor tanto no modelo raiz quanto nos modelos aninhados. Para fazer referência ao aplicativo com tecnologia sem servidor, use o modelo do AWS SAM . Você pode gerar automaticamente o AWS SAM modelo para seu aplicativo a partir do AWS Serverless Application Repository. Veja um exemplo de modelo a seguir.
```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: An example root template for a SAR application
Resources:
SampleSARApplication:
Type: AWS::Serverless::Application
Properties:
Location:
ApplicationId: arn:aws:serverlessrepo:us-east-1:1234567890:applications/TestApplication
SemanticVersion: 1.0.0
SampleEC2Instance:
Type: AWS::EC2::Instance
Properties:
ImageId: "ami-79fd7eee"
KeyName: "testkey"
BlockDeviceMappings:
- DeviceName: "/dev/sdm"
Ebs:
VolumeType: "io1"
Iops: "200"
DeleteOnTermination: "false"
VolumeSize: "20"
- DeviceName: "/dev/sdk"
NoDevice: {}
```
O AWS SAM modelo contém os seguintes elementos:
+ `ApplicationID`: o nome do recurso da Amazon (ARN) da aplicação. Essas informações estão localizadas na seção **Meus aplicativos** do AWS Serverless Application Repository.
+ `SemanticVersion`: a versão do aplicativo com tecnologia sem servidor. Você pode encontrá-lo na seção **My Applications (Meus aplicativos)** do AWS Serverless Application Repository.
+ `Parameter` (opcional): parâmetros de aplicativo.
**nota**
Para `ApplicationID` e `SemanticVersion`, [funções intrínsecas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference.html) não são compatíveis. Você deve codificar essas strings. O `ApplicationID` é atualizado quando é clonado por AWS Marketplace.
Se você planeja referenciar arquivos de configuração e script em seu CloudFormation modelo, use o formato a seguir. Para modelos aninhados (`AWS::Cloudformation::Stack`), somente `TemplateURLs` sem funções intrínsecas são aceitos. Observe o conteúdo de `Parameters` no modelo.
```
AWSTemplateFormatVersion: '2010-09-09'
Metadata:
Name: Seller test product
Parameters:
CFTRefFilesBucket:
Type: String
Default: "seller-bucket"
CFTRefFilesBucketKeyPrefix:
Type: String
Default: "cftsolutionFolder/additionCFfiles"
Resources:
TestEc2:
Type: AWS::EC2::Instance
Metadata:
AWS::CloudFormation::Init:
addCloudAccount:
files:
/etc/cfn/set-aia-settings.sh:
source:
Fn::Sub:
- https://${CFTRefFilesBucket}.${S3Region}amazonaws.com/${CFTRefFilesBucketKeyPrefix}/sampleScript.sh
- S3Region:
!If
- GovCloudCondition
- s3-us-gov-west-1
- s3
owner: root
mode: '000700'
authentication: Amazon S3AccessCreds
..
..
..
SampleNestedStack:
Type: AWS::CloudFormation::Stack
Properties:
TemplateURL: 'https://sellerbucket.s3.amazon.com/sellerproductfolder/nestedCft.template'
Parameters:
SampleParameter: 'test'
Transform: AWS::Serverless-2016-10-31
```
## Etapa 4: envie seu CloudFormation modelo e arquivos de configuração
Para enviar seu CloudFormation modelo, arquivos de configuração e scripts, conceda AWS Marketplace permissões para ler o bucket do Amazon S3 em que esses arquivos estão armazenados. Para fazer isso, atualize sua política de bucket para incluir as seguintes permissões.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "assets.marketplace.amazonaws.com"
},
"Action": ["s3:GetObject", "s3:ListBucket"],
"Resource": ["arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"]
}
]
}
```
------
## Etapa 5: atualize as permissões AWS Serverless Application Repository do seu aplicativo
Para enviar sua AWS Serverless Application Repository inscrição para AWS Marketplace, você deve conceder AWS Marketplace permissões para ler sua inscrição. Para fazer isso, adicione permissões a uma política associada ao aplicativo sem servidor. Há duas maneiras de atualizar sua política de aplicativo:
+ Vá para o [AWS Serverless Application Repository](https://console.aws.amazon.com/serverlessrepo/home). Escolha o aplicativo com tecnologia sem servidor na lista. Selecione a guia **Compartilhamento** e escolha **Criar instrução**. Na página **Configuração da instrução**, insira a seguinte entidade principal de serviço **assets.marketplace.amazonaws.com**, no campo **IDs da conta**. Em seguida, escolha **Salvar**.
+ Use o AWS CLI comando a seguir para atualizar a política do seu aplicativo.
```
aws serverlessrepo put-application-policy \
--region region \
--application-id application-arn \
--statements Principals=assets.marketplace.amazonaws.com,Actions=Deploy
```
## Etapa 6: compartilhar sua AMI
Todos os produtos AMIs criados e enviados AWS Marketplace devem seguir todas as políticas do produto. A verificação de autoatendimento da AMI está disponível no Portal de gerenciamento do AWS Marketplace. Com esse recurso, você pode iniciar escaneamentos do seu. AMIs Você recebe os resultados da verificação rapidamente (geralmente em menos de uma hora) com feedback claro em um único lugar. Depois que sua AMI for digitalizada com sucesso, envie a AMI para processamento pela equipe de operações do AWS Marketplace vendedor fazendo o upload do formulário de carregamento do produto.
## Etapa 7: Envie seu CloudFormation produto com AMI e aplicativo sem servidor
Lembre-se do seguinte antes de enviar o produto:
+ Você deve fornecer um diagrama de arquitetura para cada modelo. O diagrama deve usar os ícones AWS do produto para cada AWS serviço implantado por meio do CloudFormation modelo. Além disso, o diagrama deve incluir metadados para os serviços. Para baixar os ícones de arquitetura da AWS oficiais, consulte [Ícones de arquitetura da AWS](https://aws.amazon.com/architecture/icons).
+ A estimativa de custo da infraestrutura de cada modelo exibida para os compradores é baseada em uma estimativa que você fornece usando a [Calculadora de definição de preço da AWS](https://calculator.s3.amazonaws.com/index.html). Na estimativa, inclua a lista de serviços a serem implantados como parte do modelo junto com os valores padrão de uma implantação típica.
+ Preencha o formulário de carregamento do produto. É possível encontrar o formulário de carregamento do produto no Portal de gerenciamento do AWS Marketplace. Um formulário de carregamento de produto diferente é necessário para produtos de uma única AMI e produtos de várias AMIs. No formulário de carregamento do produto, você fornecerá uma URL pública para o seu CloudFormation modelo. CloudFormation os modelos devem ser enviados na forma de um URL público.
+ Use o Portal de gerenciamento do AWS Marketplace para enviar seu anúncio. Em **Assets (Ativos)**, escolha **File upload (Upload de arquivo)**, anexe o arquivo e escolha **Upload (Fazer upload)**. Depois de recebermos seu modelo e metadados, AWS começa a processar sua solicitação.
Depois de enviar seu anúncio, AWS Marketplace revise e valide o formulário de carregamento do produto. Além disso, AWS Marketplace regionaliza aplicativos sem servidor AMIs e atualiza o mapeamento regional do seu CloudFormation modelo em seu nome. Se ocorrer algum problema, a equipe de operações do AWS Marketplace vendedor entrará em contato com você por e-mail.
# Gerenciando produtos baseados em AMI como vendedor AWS Marketplace
Como AWS Marketplace vendedor, você pode gerenciar e atualizar seus produtos exclusivos da [Amazon Machine Images (AMIs)](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#AmazonMachineImage). Os produtos baseados em AMI incluem um conjunto de uma ou mais versões do software e metadados sobre o produto como um todo. Ao criar o produto, você configura suas propriedades em AWS Marketplace, incluindo o nome, a descrição e o preço do produto. Você também determina as categorias apropriadas para seu produto e adiciona palavras-chave para que o produto apareça em pesquisas relevantes. Depois de criar seu produto de AMI única, você pode enviar solicitações de alteração para fazer alterações em seu produto ou versão.
Os tipos de alterações que você pode solicitar para produtos baseados em AMI incluem:
+ Atualize as informações do produto exibidas aos compradores.
+ Atualize as informações da versão exibidas aos compradores.
+ Adicione uma nova versão do produto.
+ Restrinja uma versão para que novos compradores não possam mais acessá-la.
+ Atualize o em Regiões da AWS que um produto está disponível.
+ Atualize os preços e os tipos de instância de um produto.
+ Remova um produto do AWS Marketplace.
Os tópicos a seguir mostram como gerenciar e atualizar um único produto AMI.
**Topics**
+ [Criando uma solicitação de alteração para um produto baseado em AMI no AWS Marketplace](single-ami-create-change-request.md)
+ [Atualização da visibilidade do produto baseado em AMI](ami-update-visibility.md)
+ [Adicionar e restringir instâncias de AMI para AWS Marketplace](single-ami-instance-types.md)
+ [Gerenciando versões para produtos baseados em AMI no AWS Marketplace](single-ami-versions.md)
+ [Atualizando as informações do produto com base em AMI no AWS Marketplace](single-ami-updating-product.md)
+ [Gerenciando a disponibilidade de produtos baseados em AMI por país Região da AWS](single-ami-regions.md)
+ [Atualização do contrato de licença de usuário final (EULA) para seu produto baseado em AMI AWS Marketplace](single-ami-update-eula.md)
+ [Atualizando a política de reembolso para seu produto baseado em AMI em AWS Marketplace](single-ami-update-refund-policy.md)
+ [Dando AWS Marketplace acesso à sua AMI](single-ami-marketplace-ami-access.md)
+ [Removendo um produto do AWS Marketplace](removing-products-from-aws-marketplace.md)
+ [Solucionando erros comuns para solicitações de mudança em AWS Marketplace](request-errors-and-issues.md)
# Criando uma solicitação de alteração para um produto baseado em AMI no AWS Marketplace
Para fazer alterações em um produto ou versão em AWS Marketplace, você envia uma **solicitação de alteração** por meio do Portal de gerenciamento do AWS Marketplace. As solicitações de alteração são adicionadas a uma fila e podem levar de minutos a dias para serem resolvidas, dependendo do tipo de solicitação. Você pode ver o status das solicitações no Portal de gerenciamento do AWS Marketplace. Este tópico fornece os procedimentos que você pode usar para criar uma solicitação de alteração para um produto de AMI única em AWS Marketplace, incluindo a opção de usar a experiência de autoatendimento.
Você pode criar uma solicitação de alteração para as seguintes situações:
+ Você salvou as etapas em andamento, mas não concluiu todo o processo, enquanto usava a experiência de autoatendimento para criar uma lista de produtos de AMI única. Para concluir as etapas restantes, você cria uma solicitação de alteração.
+ Você deseja fazer modificações nas informações do produto que estão no estado **Limitado** ou **Público**. Para atualizar as informações, você cria uma solicitação de alteração. Para obter mais informações sobre os tipos de alterações que você pode solicitar para produtos baseados em AMI, consulte [Criar uma solicitação de alteração](#single-ami-creating-change-request).
**nota**
Além do Portal de gerenciamento do AWS Marketplace, você também pode criar solicitações de alteração usando a [API de AWS Marketplace catálogo](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/seller-products.html).
**Topics**
+ [Criar uma solicitação de alteração usando o autoatendimento](#ami-self-service-change-req)
+ [Criar uma solicitação de alteração](#single-ami-creating-change-request)
+ [Obter o status de uma solicitação de alteração](#single-ami-getting-change-request-status)
+ [Recursos adicionais do](#ami-single-change-req-resources)
## Criar uma solicitação de alteração usando o autoatendimento
Para fazer modificações nas versões ou nas informações do produto, você cria uma *solicitação de alteração* no Portal de gerenciamento do AWS Marketplace. As solicitações de alteração são os alicerces de uma lista de autoatendimento que você usa para fazer alterações em seu produto. Sempre que você seleciona **Salvar e sair** nas etapas ou seleciona **Enviar** para qualquer atualização, está fazendo uma solicitação de alteração. Você pode encontrar suas solicitações na guia Portal de gerenciamento do AWS Marketplace [Solicitação](https://aws.amazon.com/marketplace/management/requests).
**Para criar uma solicitação de alteração usando o autoatendimento**
1. Abra o Portal de gerenciamento do AWS Marketplace endereço[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), faça login na sua conta de vendedor e acesse a página de [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server).
1. Na guia **Produtos de servidor**, selecione o produto que você deseja modificar.
1. Escolha uma opção no menu suspenso **Solicitar alterações**.
1. Depois de fazer uma solicitação de alteração, há um tempo de espera para que o sistema processe sua solicitação, refletido como **Em análise**. Quando a solicitação for concluída, ela resultará em **Bem-sucedida** ou **Falha**.
+ Depois que a solicitação é enviada, ela começa a ser processada por meio dos seguintes status: **Em análise**, **Preparando alterações** e **Aplicando alterações**.
+ **Bem-sucedida** significa que a alteração solicitada foi processada e as alterações são refletidas no sistema.
+ **Falha** significa que algo deu errado com a solicitação e, portanto, as alterações não foram processadas. Se o status for **Falha**, você poderá selecionar a solicitação para encontrar códigos de erro que forneçam recomendações sobre como corrigir o erro. Nesse ponto, você poderá solucionar os erros e criar uma nova solicitação para a alteração. Para agilizar o processo, você pode escolher **Copiar para nova solicitação** para copiar os detalhes da solicitação que falhou. Em seguida, você pode fazer o ajuste e reenviar a solicitação.
## Criar uma solicitação de alteração
**Importante**
Em 15 de junho de 2023, AWS Marketplace interromperá o procedimento a seguir. Depois de 15 de junho de 2023, use o procedimento [Criar uma solicitação de alteração usando o autoatendimento](#ami-self-service-change-req).
Para fazer modificações nas versões ou nas informações do produto, você cria uma *solicitação de alteração* no Portal de gerenciamento do AWS Marketplace.
**Para criar uma solicitação de alteração**
1. Abra o Portal de gerenciamento do AWS Marketplace endereço[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), faça login na sua conta de vendedor e acesse a página de [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server).
1. Na guia **Produtos de servidor**, selecione o produto que você deseja modificar.
1. Escolha uma opção na lista suspensa **Solicitar alterações**.
Para a maioria das solicitações de alteração, basta preencher o formulário na interface do usuário e enviá-lo. No entanto, para determinadas alterações, você deve baixar, preencher e, em seguida, carregar um Formulário de Carregamento de Produto (PLF). Essa é uma planilha que contém um formulário para você preencher com as informações necessárias. Ao escolher uma dessas solicitações de alteração, você precisará baixar o PLF correto para a solicitação que está tentando criar. O PLF é pré-preenchido com informações dos detalhes do produto existentes. Você pode enviar seu PLF preenchido para a página de [upload de Portal de gerenciamento do AWS Marketplace arquivos](https://aws.amazon.com/marketplace/management/product-load).
**nota**
Recomendamos baixar e usar o PLF mais recente. O formulário é atualizado regularmente com novas informações, incluindo tipos de instância e Regiões da AWS à medida que elas se tornam disponíveis. Você pode encontrar o PLF mais recente para um produto na página **Produtos de servidor**, selecionando o produto e, em seguida, escolhendo **Baixar formulário de carregamento do produto**.
Para obter informações sobre o status de uma solicitação de alteração, consulte [Obter o status de uma solicitação de alteração](#single-ami-getting-change-request-status). Para obter informações sobre possíveis problemas com solicitações de alteração, consulte [Solucionando erros comuns para solicitações de mudança em AWS Marketplace](request-errors-and-issues.md).
## Obter o status de uma solicitação de alteração
**Importante**
Em 15 de junho de 2023, AWS Marketplace interromperá o procedimento a seguir. Esse procedimento não é mais necessário para a experiência de autoatendimento.
Depois de enviar uma solicitação de alteração, você pode ver o status da solicitação na guia **Solicitações** da página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) do Portal de gerenciamento do AWS Marketplace. O status pode ser um dos seguintes:
+ **Em análise** significa que a solicitação está sendo analisada. Algumas solicitações exigem análise manual pela AWS Marketplace equipe, mas a maioria é revisada automaticamente no sistema.
+ **Bem-sucedida** significa que a solicitação foi concluída. Seu produto ou versão foi atualizado conforme solicitado.
+ **Ação necessária** significa que você precisa atualizar a solicitação para corrigir um problema ou responder a uma pergunta sobre a solicitação. Selecione a solicitação para ver os detalhes, incluindo quaisquer problemas.
+ **Falha** significa que algo deu errado com a solicitação e você deve criar uma nova solicitação para a alteração, com os mesmos dados.
## Recursos adicionais do
Para obter mais detalhes sobre solicitações de alteração para tipos específicos de atualizações, consulte os seguintes recursos:
+ [Atualizando as informações do produto com base em AMI no AWS Marketplace](single-ami-updating-product.md)
+ [Atualizar as informações da versão](single-ami-versions.md#single-ami-updating-version)
+ [Adicionar uma nova versão](single-ami-versions.md#single-ami-adding-version)
+ [Restringir uma versão](single-ami-versions.md#single-ami-restricting-version)
# Atualização da visibilidade do produto baseado em AMI
Como AWS Marketplace vendedor, você pode atualizar a visibilidade do seu produto para alterar em quais compradores podem ver seu único produto AMI AWS Marketplace. Se o status de visibilidade estiver definido como **Público**, seu produto ficará visível para todos os AWS Marketplace compradores. Se a visibilidade do seu produto estiver definida como **Limitada**, seu produto ficará visível somente para aqueles Conta da AWS IDs que você permitir na lista de permissões. Você também pode gerenciar e atualizar essa lista de permissões para Conta da AWS IDs que possa ver seu produto. As seções a seguir mostram como atualizar a visibilidade do produto e a lista de permissões de visibilidade **limitada**.
**Topics**
+ [Atualize a visibilidade do produto](#ami-update-self-service-visibility)
+ [Atualizar a lista de permissões (contas de visualização)](#single-ami-updating-allowlist)
## Atualize a visibilidade do produto
Para alterar em quais compradores podem ver seu produto AWS Marketplace, você pode usar **Atualizar visibilidade**.
**Para atualizar a visibilidade**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Atualizar visibilidade**.
**nota**
Você pode solicitar que o produto seja movido de um status **Limitado** para um status **Público** usando essa solicitação de alteração. No entanto, a solicitação de alteração deve passar por um processo de aprovação da equipe de operações do AWS Marketplace vendedor para ser transferida para o **setor público**.
1. Escolha **Enviar solicitação de alteração** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
## Atualizar a lista de permissões (contas de visualização)
Para alterar a lista dos Conta da AWS IDs que podem ver seu produto em um estado **limitado**, use **Atualizar lista de permissões**.
**Para atualizar a lista de permissões**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. Na lista suspensa **Solicitar alterações**, escolha **Atualizar lista de permissões**. A lista atual é fornecida com a lista de contas atualmente permitidas.
1. Adicione os Conta da AWS IDs que são preferidos para visibilidade e separe-os IDs com vírgulas.
1. Escolha **Enviar solicitação de alteração** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
# Adicionar e restringir instâncias de AMI para AWS Marketplace
Como AWS Marketplace vendedor, você pode gerenciar quais instâncias os compradores podem usar para seu único produto Amazon Machine Imagine (AMI). Você pode adicionar uma nova instância para seu único produto de AMI que compradores podem usar. De maneira similar, se você quiser evitar que novos compradores usem seu produto de AMI única a partir de uma instância específica, você pode restringir a instância.
Para obter mais informações sobre os tipos de instância do Amazon EC2, consulte [Tipos de instância disponíveis](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#AvailableInstanceTypes) no *Guia do usuário do Amazon EC2*.
As seções a seguir explicam como adicionar e restringir instâncias.
**Topics**
+ [Adicionar uma instância](#single-ami-adding-instance-types)
+ [Restrição de uma instância](#single-ami-restricting-instance-types)
## Adicionar uma instância
Você pode adicionar uma nova instância para a qual os compradores podem usar uma única AMI.
**Para adicionar uma instância**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Adicionar instância**.
1. Selecione uma arquitetura de instância.
1. Selecione os tipos de instância que você deseja adicionar na lista de instâncias disponíveis.
1. Escolha **Enviar solicitação** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
**nota**
Se o modelo da definição de preço atual não for gratuito ou usar um modelo traga a sua própria licença (BYOL), você também deverá adicionar preços.
Se tiver criado **Adicionar instância** com um preço para a nova instância ou **Atualizar preço** para aumentar o preço, você não poderá usar o autoatendimento para **Adicionar instância** nos 90 dias a partir do dia em que fez a alteração. Para fazer essas alterações, entre em contato com a [equipe de operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/).
Quando você adiciona suporte para um novo tipo de instância, os clientes que já assinaram ofertas privadas para seu produto não poderão iniciar a instância recém-adicionada automaticamente. Você deve criar outra oferta privada com a instância que deseja que os clientes acessem. Depois de aceitar a nova oferta, os clientes podem iniciar a instância recém-adicionada. Os clientes que assinarem seu produto em uma data futura também poderão iniciar a instância, desde que a instância esteja incluída na oferta privada. Para obter mais informações sobre como criar uma nova oferta privada, consulte [Acordos alterados em AWS Marketplace](private-offers-upgrades-and-renewals.md) mais à frente neste guia.
**nota**
**Support ao tipo de instância FPGA**
Os produtos com AFI IDs oferecem suporte somente aos tipos de instância F2. Você pode oferecer sua AMI em outros tipos de instância, mas ela não AFIs será carregada em outros tipos de instância. Quando os compradores lançam seu produto em instâncias que não sejam F2, a AMI funcionará sem os recursos de aceleração de FPGA fornecidos pela AFI. IDs
## Restrição de uma instância
Para evitar que novos compradores usem uma instância de um produto de AMI, você pode restringir a instância. Você pode adicionar a instância novamente mais tarde, se necessário. Os usuários existentes da única AMI na instância restrita podem continuar usando o produto da região durante as assinaturas.
**Para restringir uma instância**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Restringir instância**.
1. Selecione as instâncias que você deseja restringir e escolha **Restringir**.
1. Escolha **Enviar solicitação de alteração** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
**nota**
Se a caixa de seleção estiver sombreada, isso significa que a instância está associada a uma ou várias versões como um tipo de instância recomendado. Para restringir essas instâncias, use **Atualizar versões** para escolher um tipo de instância recomendado diferente. Depois que as solicitações de alteração forem concluídas e a instância que você deseja restringir não for mais um tipo de instância recomendado, volte para **Restringir instância** para restringir a instância escolhida.
# Gerenciando versões para produtos baseados em AMI no AWS Marketplace
Ao criar um produto baseado em Amazon Machine Image (AMI) no AWS Marketplace, você inclui uma versão específica do seu software. O ciclo de vida de um produto baseado em AMI AWS Marketplace não termina depois que você publica a primeira versão. Você deve manter seu produto up-to-date com novas versões do seu software. As seções a seguir mostram como gerenciar suas versões, o que inclui atualizar as informações da versão (como descrições e datas), adicionar novas versões e restringir o acesso às versões anteriores.
**Topics**
+ [Atualizar as informações da versão](#single-ami-updating-version)
+ [Adicionar uma nova versão](#single-ami-adding-version)
+ [Restringir uma versão](#single-ami-restricting-version)
## Atualizar as informações da versão
Depois que uma versão é criada, pode ser útil fornecer informações atualizadas aos compradores modificando as informações associadas à versão. Por exemplo, se você planeja restringir a versão 1.0 após o lançamento da versão 1.1, atualize a descrição da versão 1.0 para direcionar os compradores para a versão 1.1, com a data em que a versão será restrita. Você atualiza as informações da versão no Portal de gerenciamento do AWS Marketplace.
**Para atualizar as informações da versão**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server), na guia **Produtos de servidor**, e selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Atualizar informações da versão**.
1. Na página **Atualizar versão**, selecione a versão que você deseja atualizar.
1. Atualize qualquer uma das seguintes informações que você precisará modificar:
+ **Notas da versão**
+ **Instruções de uso**
+ **Imagem de máquina da Amazon (AMI) de 64 bits (x86)**: detalhes sobre uso e grupo de segurança
1. Selecione **Submit (Enviar)**.
1. Verifique se a solicitação aparece na guia **Solicitações** com o status **Em análise**.
**nota**
Você não pode usar esse procedimento para atualizar o título da versão ou a AMI associada à versão. Em vez disso, [crie uma nova versão](#single-ami-adding-version) e [restrinja a versão anterior](#single-ami-restricting-version).
Você pode verificar o status da solicitação a qualquer momento na guia **Solicitações** da página [Produtos do servidor](https://aws.amazon.com/marketplace/management/products/server). Para obter mais informações, consulte [Obter o status de uma solicitação de alteração](single-ami-create-change-request.md#single-ami-getting-change-request-status).
## Adicionar uma nova versão
Você pode adicionar uma nova versão do produto ao fazer alterações no produto, na imagem base ou em qualquer outro momento em que precisar modificar a AMI do produto. Adicione uma nova versão do seu produto a partir do Portal de gerenciamento do AWS Marketplace.
**nota**
Para obter informações sobre como criar uma AMI para AWS Marketplace, consulte[Melhores práticas de construção AMIs para uso com AWS Marketplace](best-practices-for-building-your-amis.md).
**Para adicionar uma nova versão**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Adicionar nova versão**. O formulário **Adicionar uma nova versão** é exibido, pré-preenchido com as informações da versão mais recente.
**nota**
Você também pode escolher **Testar “Adicionar versão”** para verificar a AMI e o(s) modelo(s) do CloudFormation sem adicionar uma nova versão. Para obter mais informações, consulte [Verificação dos requisitos de publicação da AMI](https://docs.aws.amazon.com/marketplace/latest/userguide/best-practices-for-building-your-amis.html#self-service-scanning).
1. Na seção **Informações da versão**, forneça as seguintes informações:
+ **Título da versão** — insira uma string válida (por exemplo, *1.1* ou*Version 2.0*). Essa opção deve ser exclusiva em todo o produto.
+ **Notas de lançamento**: insira o texto para descrever detalhes sobre essa versão.
1. Na seção **Opções de entrega**, selecione como o comprador pode implantar a solução, seja AMI (autônoma), AMI com CloudFormation ou ambas. Você pode escolher até três AMI com opções CloudFormation de entrega.
**nota**
Novas opções de entrega não podem ser adicionadas a uma versão existente. Todas as opções de entrega de uma única versão devem ser enviadas na mesma solicitação.
1. Na seção **Imagem de máquina da Amazon (AMI)**, forneça as seguintes informações:
+ **ID da imagem de máquina da Amazon**: insira o ID da AMI que você deseja usar para esta versão. Você pode encontrar o ID da AMI na [lista de AMIs no console](https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#Images:sort=name). A AMI deve existir na região Leste dos EUA (Norte da Virgínia) e na sua conta de AWS Marketplace vendedor. O instantâneo associado a essa AMI não pode ser criptografado.
+ **ARN da função de acesso do IAM** — Insira o Amazon Resource Name (ARN) para uma função AWS Identity and Access Management (IAM) que permite obter acesso AWS Marketplace à sua AMI. Para obter instruções sobre como criar o perfil do IAM, consulte [Dando AWS Marketplace acesso à sua AMI](single-ami-marketplace-ami-access.md). Use o formato padrão para um ARN do IAM, por exemplo:. *arn:aws:iam::123456789012:role/RoleName* O ARN deve existir na sua conta de AWS Marketplace vendedor.
+ **Sistema operacional (SO)**: insira o sistema operacional básico para a AMI.
+ **Versão do SO**: insira a versão do sistema operacional que a AMI está usando.
+ **Nome de usuário do sistema operacional** — Para Linux baseado AMIs, insira o nome de um usuário que pode ser usado para entrar na instância. Recomendamos usar *ec2-user*.
+ **Porta de digitalização**: insira o número da porta que pode ser usada para fazer login no sistema operacional: a porta SSH para uma AMI Linux ou a porta RDP para uma AMI Windows.
+ **Imagem Amazon FPGA (AFI) IDs (opcional)** — Insira a AFI a ser associada IDs à sua AMI. AFIs só oferecem suporte aos tipos de instância F2. Você pode oferecer sua AMI em outros tipos de instância, mas elas não AFIs serão carregadas nesses casos. Você pode adicionar até 15 AFI IDs usando o botão **Adicionar ID AFI**. Essa opção não está disponível ao usar CloudFormation modelos. Todas as AFI IDs que você fornecer devem ser originárias da região Leste dos EUA (Norte da Virgínia), residir em sua conta de vendedor do AWS Marketplace e a função de acesso do IAM fornecida deve ter permissões para compartilhar essa AFI com o AWS Marketplace.Para obter mais detalhes sobre as permissões necessárias, consulte Conceder ao [AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-marketplace-ami-access.html#single-ami-marketplace-afi-access) acesso às suas imagens FPGA.
1. Forneça as seguintes configurações para a seção **Opção de entrega da AMI**, se aplicável:
+ **Tipo de instância recomendado**: escolha o tipo de instância que os compradores recebem por padrão.
+ **Instruções de uso**: insira as instruções para usar a AMI ou um link para obter mais informações sobre o uso da AMI. Por exemplo: *To get started with the product, navigate to https://example.com/usage.htm.*
+ **URL do endpoint**: forneça informações sobre como o comprador pode acessar o software depois de criar uma instância. Insira o **protocolo** (*https* ou *http*), o **URL relativo** (por exemplo,*/index.html*) e a **porta** (por exemplo,*443*) que os compradores podem usar para acessar seu produto. (O nome do host depende da instância do EC2, então você só precisa fornecer o caminho relativo).
+ **Recomendações de grupos de segurança** — insira as informações de uma ou mais recomendações, incluindo o protocolo (*TCP* ou *UDP*), o intervalo de portas a serem permitidas e a lista de IPv4 CIDR IPs (no formato *xxx.xxx.xxx.xxx/nn*, por exemplo). *192.0.2.0/24*
1. Forneça as seguintes configurações para a **AMI com opção CloudFormation de entrega**, se aplicável:
+ **Título da opção de entrega** — Esse é um nome exclusivo para identificar essa opção de entrega de CloudFormation modelo de AMI única.
+ **Breve descrição** — Uma breve descrição do CloudFormation modelo.
+ **Descrição longa** — Uma descrição detalhada do CloudFormation modelo.
+ **Tipo de instância recomendado**: o tipo de instância que os compradores recebem por padrão.
+ **Instruções de uso**: instruções de uso da solução ou um link para obter mais informações sobre como usar a AMI.
+ **CloudFormation link do modelo** — O URL para a localização do seu CloudFormation modelo no Amazon S3. Para pilhas ou modelos aninhados, forneça o modelo do ponto de entrada, ou pai. O bucket do Amazon S3 no qual o arquivo reside deve ser acessível publicamente. Para obter mais informações, consulte [Adicionar CloudFormation modelos ao seu produto](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html).
+ **Nome do parâmetro AMI** — Adicione o nome do parâmetro no CloudFormation modelo que os recursos da instância EC2 em seu modelo estão referenciando para o valor `ImageId` da propriedade. AWS Marketplace substitui o parâmetro especificado por um parâmetro do [AWS Systems Manager Parameter Store](https://docs.aws.amazon.com//systems-manager/latest/userguide/systems-manager-parameter-store.html). Quando os compradores implantam seu modelo, esse parâmetro é resolvido para a ID da AMI AWS específica da região do seu produto publicado. Para obter mais informações, consulte [Requisitos dos detalhes de AMI](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html#ami-requirements-sse).
+ **Link do diagrama de arquitetura**: o URL da localização do diagrama de arquitetura no Amazon S3. O tamanho máximo do arquivo de imagem deve ter 1560x878 ou 1560x3120 pixels com uma proporção de 16:9 ou 1:2. O bucket do Amazon S3 no qual o arquivo de imagem reside deve ser publicamente acessível. Para obter os requisitos do diagrama, consulte [Diagrama arquitetônico](https://docs.aws.amazon.com//marketplace/latest/userguide/cloudformation.html#topology-diagram).
1. Selecione **Enviar** para enviar a solicitação para adicionar a nova versão.
**nota**
A adição de uma nova versão resulta em uma verificação da AMI. Para obter mais informações, consulte [Verificação dos requisitos de publicação da AMI](https://docs.aws.amazon.com/marketplace/latest/userguide/best-practices-for-building-your-amis.html#self-service-scanning).
**nota**
**Suporte ao AFI ID em novas versões**
Ao adicionar novas versões da AMI, a AFI IDs pode ser configurada se você selecionar o método de entrega da AMI (autônoma). As mesmas regras de validação que se aplicam durante a criação do produto também se aplicam ao adicionar novas versões, incluindo restrições de caracteres, requisitos de exclusividade, restrições regionais e verificação de propriedade da conta. Depois que uma versão é criada com o AFI IDs, esses AFI IDs se tornam imutáveis e não podem ser editados posteriormente. Se você precisar modificar o AFI IDs, deverá criar uma nova versão com a configuração atualizada. Novas versões com AFI IDs podem coexistir com versões existentes que também têm AFI IDs, permitindo que você mantenha várias configurações de FPGA em diferentes versões do produto. Durante a preparação da versão, AWS Marketplace cria clones regionais de AFI para garantir que seu produto esteja disponível em todas AWS as regiões suportadas, simplificando o processo de implantação para seus compradores. Esse processo é realizado pela equipe de operações do vendedor do AWS Marketplace e pode levar mais tempo do que outras solicitações de adição de versão da AMI. Durante esse período, sua solicitação estará “Em análise”.
1. Verifique se a solicitação aparece na guia **Solicitações** com o status **Em análise**. Se houver erros a serem corrigidos, a página exibirá os erros em uma tabela na parte superior da página e os campos específicos que precisam ser atualizados serão exibidos em vermelho.
Você pode verificar o status da solicitação a qualquer momento na guia **Solicitações** da página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server). A nova versão será analisada e, se for bem-sucedida, publicada como uma nova versão pública do produto. Se houver um problema, o status pode ser **Ação necessária**. Selecione a solicitação para ver os detalhes, incluindo quaisquer problemas.
Se a solicitação for bem-sucedida, os usuários existentes receberão a seguinte mensagem de e-mail. A mensagem informa que a nova versão está disponível, tem links para as notas de lançamento da versão e sugere que eles atualizem para a versão mais recente. Como usuário Conta da AWS root, você também recebe uma cópia da mensagem de e-mail na conta de e-mail associada à sua Conta da AWS.
```
Greetings from AWS Marketplace,
Thank you for subscribing to
We are writing to inform you that has added a new version to on AWS Marketplace.
As an existing customer, your subscription to the product, any running instances and access to previous versions
are unaffected. However, does recommend you to update to the latest version, /
by visiting .
For additional questions or upgrade information, please contact directly. Click here
to visit the seller’s profile page on AWS Marketplace.
Release notes for /:
Thank you,
The AWS Marketplace Team
https://aws.amazon.com/marketplace
AWS, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com is a registered trademark of Amazon.com, Inc.
This message was produced and distributed by AWS Inc., 410 Terry Ave. North, Seattle, WA 98109-5210
```
## Restringir uma versão
Se você quiser impedir que os compradores acessem uma versão específica do produto público, você pode restringir essa versão.
**nota**
Todos os assinantes podem usar a versão atual, independentemente do status da restrição. As diretrizes do AWS Marketplace exigem que você continue oferecendo suporte aos compradores existentes por 90 dias após restringir a versão. A AMI será marcada como obsoleta depois que a versão for restrita. Para obter mais informações, consulte [Desativar uma AMI](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ami-deprecate.html) no *Guia do usuário do Amazon Elastic Compute Cloud para instâncias do Windows *.
**Para restringir uma versão**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Restringir versão**.
1. Na página **Restringir versão**, selecione a versão (ou versões) que você deseja restringir.
1. Selecione **Enviar** para enviar sua solicitação de revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status será **Bem-sucedido**.
**nota**
Você não pode restringir todas as versões de um produto. Se você tentar restringir a última versão pública restante de um produto, será exibido um erro. Para remover completamente um produto, consulte [Removendo um produto do AWS Marketplace](removing-products-from-aws-marketplace.md).
Você pode verificar o status da solicitação a qualquer momento na guia **Solicitações** da página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server). Para obter mais informações, consulte [Obter o status de uma solicitação de alteração](single-ami-create-change-request.md#single-ami-getting-change-request-status).
**nota**
A restrição de uma versão pode levar até três dias para ser concluída.
Se a solicitação for bem-sucedida, os usuários existentes receberão a seguinte mensagem de e-mail que os notifica sobre a restrição de versão e sugere que eles usem a versão mais recente disponível. Como usuário Conta da AWS root, você também recebe uma cópia da mensagem de e-mail na conta de e-mail associada à sua Conta da AWS.
```
Greetings from AWS Marketplace,
Thank you for subscribing to .
We are writing to inform you that, as of , will no longer offer version(s) "" to new subscribers. Your use and subscription is unaffected for this version(s), however it is recommended that users upgrade to the latest version on AWS Marketplace.
For additional questions or upgrade information, please contact directly. Click here to visit the seller’s profile page on AWS Marketplace.
Thank you,
The AWS Marketplace Team
https://aws.amazon.com/marketplace
AWS, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com is a registered trademark of Amazon.com, Inc. This message was produced and distributed by AWS Inc., 410 Terry Ave. North, Seattle, WA 98109-5210
```
# Atualizando as informações do produto com base em AMI no AWS Marketplace
Depois de criar o produto de imagem de máquina da Amazon (AMI) única, você pode alterar algumas das informações associadas a ele no AWS Marketplace. Por exemplo, se uma nova versão modificar a descrição ou os destaques do produto, você poderá editar as informações do produto com os novos dados. Você também pode atualizar outras informações do produto, incluindo título do produto, descrição do SKU, categorias, palavras-chave e outros. Para obter mais informações, consulte o seguinte procedimento.
**Para atualizar as informações do produto**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produtos de servidor**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Atualizar informações do produto**.
1. Atualize qualquer um dos seguintes campos que você precise alterar:
+ **Título do produto**
+ **SKU**
+ **Descrição breve**
+ **Descrição longa**
+ **URL da imagem do logotipo do produto**
+ **Destaques**
+ **Categorias de produtos**
+ **Palavras-chave**
+ **URL do vídeo do produto**
+ **Recursos**
+ **Informações de suporte**
**nota**
Para obter detalhes sobre o formato do logotipo, consulte [Requisitos de logotipo de empresa e produto](product-submission.md#seller-and-product-logos).
1. Selecione **Submit (Enviar)**.
1. Verifique se a solicitação aparece na guia **Solicitações** com o status **Em análise**. Talvez seja necessário atualizar a página para ver a solicitação na lista.
Você pode verificar o status da solicitação a qualquer momento na guia **Solicitações** da página [Produtos do servidor](https://aws.amazon.com/marketplace/management/products/server). Para obter mais informações, consulte [Obter o status de uma solicitação de alteração](single-ami-create-change-request.md#single-ami-getting-change-request-status).
# Gerenciando a disponibilidade de produtos baseados em AMI por país Região da AWS
Ao criar um produto em AWS Marketplace, você escolhe as AWS regiões em que ele está disponível. Você também escolhe os países nos quais os compradores podem comprar seu produto. Essas duas propriedades são semelhantes, mas não são iguais. Por exemplo, um comprador pode estar localizado e comprar nos Estados Unidos, mas está planejando instalar seu produto na região da Europa (Frankfurt). Para que esse comprador compre seu produto, você deve incluir os Estados Unidos na sua lista de países e a região da Europa (Frankfurt) na sua lista de regiões. Você pode usar as seções a seguir para atualizar a disponibilidade do produto por região e país.
**Topics**
+ [Adicione um Região da AWS](#single-ami-adding-regions)
+ [Restringir um Região da AWS](#single-ami-restricting-regions)
+ [Suporte de atualização para future Regiões da AWS](#single-ami-updating-future-region-support)
+ [Atualizar disponibilidade por país](#single-ami-update-availability-by-country)
## Adicione um Região da AWS
Você pode adicionar uma região onde os compradores possam usar seu produto.
**Para adicionar uma região**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Adicionar região**.
1. Selecione a região que você deseja adicionar na lista de regiões disponíveis.
1. Escolha **Enviar solicitação** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
**nota**
Quando você adiciona suporte para uma nova Região da AWS, os clientes que já estão inscritos em ofertas privadas para seu produto não poderão acessar a região recém-adicionada automaticamente. Você deve criar outra oferta privada com a região que deseja que os clientes acessem. Depois de aceitar a nova oferta, os clientes podem acessar a região recém-adicionada. Os clientes que assinarem seu produto em uma data futura também poderão acessar a Região, desde que ela esteja incluída na oferta privada. Para obter mais informações sobre como criar uma nova oferta privada, consulte [Atualizações, renovações e alterações de ofertas privadas](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html).
**nota**
**Requisitos regionais do FPGA**
Ao adicionar regiões aos produtos FPGA, clones regionais de AFI são criados automaticamente AWS Marketplace para garantir que seu produto esteja disponível em todas as regiões suportadas. AWS Esse processo garante que os compradores possam implantar seu produto acelerado por FPGA em sua região preferida sem exigir a replicação manual do AFI. O processo de clonagem automática mantém a consistência em todas as regiões em que seu produto está disponível.
## Restringir um Região da AWS
Para evitar que novos compradores usem seu produto em um determinado Região da AWS local, você pode restringir a região. Você poderá adicionar a região novamente mais tarde. Os assinantes existentes do produto na região podem continuar usando o produto da região, desde que estejam inscritos.
**Para restringir uma região**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Restringir região**.
1. Selecione o menu suspenso para ver a lista de regiões nas quais seu produto está disponível atualmente.
1. Selecione as regiões que deseja restringir.
1. As regiões que você selecionou aparecem como tokens. Revise a lista de regiões que você está restringindo e insira X para regiões que não deseja restringir.
1. Escolha **Enviar solicitação de alteração** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
Se a solicitação for bem-sucedida, os usuários existentes receberão a seguinte mensagem de e-mail notificando-os sobre a região a ser restrita. Eles podem continuar usando seu produto enquanto permanecerem inscritos, mas não poderão se inscrever novamente se cancelarem a assinatura.
```
Greetings from AWS Marketplace,
This message is a notification detailing a recent change for .
{{{sellerName}}} has opted to restrict the product in beginning .
This impacts you in the following ways:
1. As long as you're subscribed to the product, you can continue using the software product in the restricted Region.
2. You can't begin new instances of the software product in the restricted Region.
3. You can continue using the software product in all available AWS Regions.
Regards,
The AWS Marketplace Team
AWS, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com (http://amazon.com/) is a registered
trademark of Amazon.com, Inc. This message was produced and distributed by Amazon Web
Services Inc., 410 Terry Ave. North, Seattle, WA 98109-5210.
```
## Suporte de atualização para future Regiões da AWS
Se você quiser que seu produto seja integrado ao recém-lançado Regiões da AWS, você pode usar o suporte do Update **future Region**.
**Para atualizar o suporte futuro da região**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Atualizar suporte futuro da região**.
1. Você pode optar por ativar o suporte futuro da região AWS Marketplace para permitir a integração de seu produto ao recém-lançado Regiões da AWS em seu nome.
1. Depois de ativar o recurso, você pode escolher entre todas as regiões futuras ou limitar-se apenas às regiões dos EUA.
1. Escolha **Enviar solicitação de alteração** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
## Atualizar disponibilidade por país
Se você quiser alterar os países nos quais seu produto pode ser inscrito e oferecido, use **Atualizar disponibilidade**.
**Para atualizar a disponibilidade por país**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Atualizar disponibilidade**.
1. Escolha uma das seguintes opções:
1. **Todos os países**: disponível em todos os países com suporte.
1. **Todos os países com exclusões**: disponível em todos os países com suporte, exceto em países selecionados.
1. **Lista personalizada**: lista específica de países onde o produto está disponível.
1. Escolha **Enviar solicitação de alteração** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
# Atualização do contrato de licença de usuário final (EULA) para seu produto baseado em AMI AWS Marketplace
Como AWS Marketplace vendedor, você pode atualizar o contrato de licença de usuário final (EULA) que regerá o uso de seu único produto Amazon Machine Image (AMI). Seu EULA está localizado na página de listagem de produtos para listagens públicas de software no AWS Marketplace. Você pode aplicar seu próprio EULA ou usar o [Contrato Padrão para AWS Marketplace (SCMP)](standardized-license-terms.md). O procedimento a seguir mostra como atualizar o EULA do produto de AMI única.
Para obter mais informações sobre o SDK, consulte [Usar contratos padronizados no AWS Marketplace](standardized-license-terms.md).
**Para atualizar um EULA**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Escolha a guia [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Atualizar contrato de licença do usuário final**.
1. Você pode selecionar o [Contrato Padrão para AWS Marketplace (SCMP)](https://docs.aws.amazon.com/marketplace/latest/userguide/standardized-license-terms.html) ou enviar seu próprio EULA personalizado. Para obter um EULA personalizado, você deve fornecer o URL do seu contrato personalizado de um bucket do Amazon S3.
**nota**
A acessibilidade pública deve ser habilitada no bucket do Amazon S3.
1. Escolha **Enviar solicitação de alteração** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
# Atualizando a política de reembolso para seu produto baseado em AMI em AWS Marketplace
Como AWS Marketplace vendedor, você pode definir a política de reembolso para seu único produto Amazon Machine Image (AMI). Se quiser alterar a política de reembolso do seu produto, use a opção **Atualizar política de reembolso**. O procedimento a seguir mostra como atualizar sua política de reembolso.
**Para atualizar a política de reembolso**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Acesse a página [https://aws.amazon.com/marketplace/management/products/server](https://aws.amazon.com/marketplace/management/products/server) e, na guia **Produto de servidor atual**, selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Atualizar política de reembolso**.
1. Os detalhes da política de reembolso atual são fornecidos na caixa de texto para você editar. O envio da solicitação substitui a política de reembolso atual.
1. Escolha **Enviar solicitação de alteração** para enviar sua solicitação para revisão.
1. Verifique se a guia **Solicitações** mostra o **Status da solicitação** como **Em análise**. Quando a solicitação for concluída, o status se tornará **Bem-sucedido**.
# Dando AWS Marketplace acesso à sua AMI
Quando você cria uma solicitação que inclui a adição de uma nova Amazon Machine Image (AMI) AWS Marketplace, a AMI deve ser copiada para o AWS Marketplace sistema e, em seguida, verificada quanto a problemas de segurança. Você deve conceder AWS Marketplace acesso à AMI criando uma função AWS Identity and Access Management (IAM) com permissões para realizar ações em sua AMI e uma política de confiança que permita assumir AWS Marketplace a função. Você precisa criar o perfil do IAM apenas uma vez. O procedimento a seguir mostra como criar uma função para ingestão de AWS Marketplace ativos que dê AWS Marketplace acesso à sua AMI.
**Para criar uma função para a ingestão de ativos da AWS Marketplace AMI**
1. Faça login no Console de gerenciamento da AWS, abra o console do IAM e acesse a [página Funções](https://console.aws.amazon.com/iam/home?region=us-east-1#/roles).
1. Selecione **Criar perfil**.
1. Na página **Criar função**, selecione o seguinte:
+ **Selecione tipo de entidade confiável**: escolha **Serviço da AWS **.
+ **Escolha um caso de uso**: escolha **AWS Marketplace**.
+ **Selecionar caso de uso**: escolha **Marketplace — Ingestão de ativos da AMI**.
+ Para ir para a próxima página, selecione **Próximo: Permissões**.
1. Selecione a política **AWSMarketplaceAmiIngestion**. Adicione um limite de permissões, se necessário, e selecione **Próximo: Tags** para continuar.
**nota**
Você pode usar limites de permissões para limitar o acesso que você concede ao AWS Marketplace com essa função. Para obter mais informações, consulte [Limites de permissões para identidades do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html) no *Guia do usuário do AWS Identity and Access Management *.
1. Para continuar, selecione **Próximo: Revisão**.
1. Forneça um nome para a função e selecione **Criar função**.
1. Você deve ver “A função *rolename* foi criada” na parte superior da página e a função deve aparecer na lista de funções.
Nessa página, ao selecionar a função que acabou de criar, você poderá ver o ARN no formato *arn:aws:iam::123456789012:role/exampleRole*. Use o ARN para o **ARN da função de acesso do IAM** ao criar solicitações de alteração, por exemplo, ao [adicionar uma nova versão](single-ami-versions.md#single-ami-adding-version) ao seu produto.
## Dando AWS Marketplace acesso às suas imagens FPGA
Se sua AMI incluir imagens FPGA (AFIs), você também deverá conceder permissões AWS Marketplace adicionais para acessar e gerenciar essas imagens FPGA. Além da **AWSMarketplaceAmiIngestion**política, você precisa criar uma política embutida que permita AWS Marketplace realizar ações em suas imagens FPGA.
**Para adicionar permissões de imagem FPGA à sua função de ingestão de ativos da AWS Marketplace AMI**
1. Faça login no Console de gerenciamento da AWS, abra o console do IAM e acesse a [página Funções](https://console.aws.amazon.com/iam/home?region=us-east-1#/roles).
1. Selecione a função que você criou para a ingestão de ativos da AWS Marketplace AMI.
1. Na página de detalhes da função, selecione a guia **Permissões** e, em seguida, selecione **Adicionar política embutida**.
1. Selecione a guia **JSON** e insira a seguinte política:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"ec2:DescribeFpgaImages",
"ec2:DescribeFpgaImageAttribute",
"ec2:CopyFpgaImage",
"ec2:ModifyFpgaImageAttribute"
],
"Resource":"*"
}
]
}
```
------
1. Selecione **Review policy (Revisar política)**.
1. Forneça um nome para a política **AWSMarketplaceAfiIngestion**, como, e selecione **Criar política**.
Depois de adicionar essa política em linha, AWS Marketplace terá as permissões necessárias para acessar e gerenciar suas imagens FPGA durante o processo de ingestão e digitalização.
# Removendo um produto do AWS Marketplace
Depois de publicar seu produto, você pode removê-lo do AWS Marketplace. Isso também é conhecido como *desativação*. Para remover um produto, identifique o produto e envie uma solicitação para remoção, junto com um motivo para a remoção e um endereço de e-mail para contato com você. Você também poderá fornecer um ID de produto de substituição se estiver substituindo o produto atual por um novo.
Depois que você solicita a remoção do produto, novos clientes não conseguem mais assiná-lo. Você deve dar suporte a clientes existentes por pelo menos 90 dias.
**nota**
Você não pode excluir produtos restritos do Portal AWS Marketplace de Gerenciamento. O portal os retém como parte do histórico de publicações da conta.
Processamos solicitações de remoção de produtos AWS Marketplace com as seguintes condições:
+ O produto foi removido das ferramentas de AWS Marketplace pesquisa, navegação e outras ferramentas de descoberta. Qualquer funcionalidade ou botão **Assinatura** são desativados, e as mensagens na página indicam claramente que o produto não está mais disponível. A página de detalhes do produto ainda é acessível usando o URL e pode ser indexada em mecanismos de pesquisa públicos.
+ É necessário especificar um motivo para a remoção (por exemplo, o fim do suporte, o fim das atualizações do produto ou o produto para substituição). Para obter os requisitos de suporte contínuo para produtos removidos, consulte [os Termos e Condições para AWS Marketplace vendedores](https://aws.amazon.com/marketplace/management/terms).
+ AWS Marketplace contata os compradores atuais por meio de uma mensagem de e-mail informando-os sobre a remoção do produto, os motivos da remoção e fornecendo as informações de contato do vendedor.
+ Os compradores atuais *retêm* o acesso ao software até cancelarem a assinatura. Eles não serão afetados pela remoção do produto.
**Para remover um produto criado usando o Portal de gerenciamento do AWS Marketplace**
1. Abra o endereço e[https://aws.amazon.com/marketplace/management/tour/](https://aws.amazon.com/marketplace/management/tour/), Portal de gerenciamento do AWS Marketplace em seguida, faça login na sua conta de vendedor.
1. Selecione a guia **Produtos** e selecione **Servidor**.
1. Na página do produto, em **Produtos de servidor**, localize o produto que você deseja remover. No menu suspenso **Solicitar alterações**, escolha **Atualizar visibilidade do produto**.
1. Na página **Atualizar visibilidade do produto**, selecione **Restrito**.
1. (Opcional) Forneça um **ID de produto de substituição**, se houver outro produto que substituirá o produto que você está removendo.
1. Revise as informações para ver se estão precisas e selecione **Enviar**.
Uma página informacional **Novidades** será exibida após o envio da solicitação de remoção do produto. As Operações AWS Marketplace do Vendedor analisam e processam sua solicitação. Verifique o status do envio visualizando **Solicitações**.
Depois que o produto for removido, ele será exibido na lista **Produtos atuais** no Portal de gerenciamento do AWS Marketplace. Em **Produtos atuais**, a única ação disponível é fazer download da planilha do produto. Não é possível editar ou enviar outra solicitação de encerramento.
Se você tiver dúvidas sobre as remoções de produtos, entre em contato com a equipe de [operações de vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/).
# Solucionando erros comuns para solicitações de mudança em AWS Marketplace
Ao fazer alterações nas informações do seu produto AWS Marketplace, você pode se deparar com erros. Este tópico explica alguns erros comuns e fornece sugestões sobre como corrigi-los.
+ **Verificação da AMI**: vários problemas podem ocorrer ao verificar sua AMI:
+ Você não concedeu AWS Marketplace permissões para escanear sua AMI. Conceda ao AWS Marketplace permissões para acessá-lo. Ou você concedeu permissões, mas o limite de permissões é muito restritivo. Para obter mais informações, consulte [Dando AWS Marketplace acesso à sua AMI](single-ami-marketplace-ami-access.md).
+ Se o escaneamento encontrar problemas de segurança ou vulnerabilidades e exposições comuns (CVEs) em sua AMI, verifique se você está usando os patches mais recentes para o sistema operacional em sua imagem. Para obter mais informações, consulte [Requisitos de produto baseados em AMI para AWS Marketplace](product-and-ami-policies.md).
Para obter diretrizes gerais sobre a criação de uma AMI, consulte [Melhores práticas de construção AMIs para uso com AWS Marketplace](best-practices-for-building-your-amis.md).
+ **Portal de gerenciamento do AWS Marketplace campos** — Alguns campos do Portal de gerenciamento do AWS Marketplace exigem informações muito específicas:
+ Se você não tiver certeza sobre o que o campo está solicitando, tente verificar os detalhes no console. A maioria dos campos tem descrições de texto acima do campo e requisitos de formatação abaixo do campo.
+ Se você tentar enviar um formulário com um ou mais campos inválidos, uma lista de problemas será exibida. Uma ação recomendada é fornecida para ajudar você a corrigir o problema.
+ Se for necessário fornecer um ARN, você normalmente o encontrará em outro lugar no console. Por exemplo, o ARN da função do IAM que você criou para dar AWS Marketplace acesso à sua AMI é encontrado na [página Funções](https://console.aws.amazon.com/iam/home?region=us-east-1#/roles) no console do IAM. ARNs todos têm um formato similar. Por exemplo, um ARN de perfil do IAM está no formato *arn:aws:iam::123456789012:role/exampleRole*.
+ Seus logotipos e vídeos devem ser fornecidos como um URL diretamente para o conteúdo. Para obter mais informações sobre formatos de logotipo, consulte [Requisitos de logotipo de empresa e produto](product-submission.md#seller-and-product-logos).
Para obter mais informações sobre envio de solicitações de alteração de versão e produtos, consulte [Enviando seu produto para publicação em AWS Marketplace](product-submission.md).
+ **Problemas com o Formulário de Carregamento de Produto (PLF)** — PLFs contêm instruções que estão incluídas na planilha. As instruções gerais são fornecidas na tabela de instruções. Cada campo tem instruções sobre como preenchê-lo — selecione o campo para revelar as instruções.
+ **Solicitação em andamento**: algumas solicitações não podem acontecer paralelamente. Você só pode ter uma solicitação para atualizar informações específicas em andamento para um produto por vez. Você pode ver todas as solicitações ainda em análise na guia **Solicitações** da página **Produtos de servidor** no Portal de gerenciamento do AWS Marketplace. Se você tiver uma solicitação pendente que não pretendia, poderá cancelá-la e enviar uma nova solicitação com a alteração que deseja fazer.
+ Você não pode atualizar as informações da versão quando uma atualização (para adicionar ou restringir) uma versão está em andamento.
+ Se houver uma solicitação pendente da equipe de operações do AWS Marketplace vendedor, você não poderá enviar novas alterações.
+ **Erro inexplicável**: se o envio falhar sem nenhuma explicação, tente novamente. Ocasionalmente, a carga do servidor faz com que o envio falhe.
Se você ainda tiver problemas com uma solicitação de alteração, entre em contato com a equipe de [operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/).
# Melhores práticas de construção AMIs para uso com AWS Marketplace
Este tópico fornece as melhores práticas e referências para ajudá-lo a criar Amazon Machine Images (AMIs) para uso com AWS Marketplace. AMIs criado e enviado para, AWS Marketplace deve seguir todas as políticas AWS Marketplace do produto. Para obter mais informações, consulte as seções a seguir.
**Topics**
+ [Proteção dos direitos de revenda](#rights)
+ [Criação de uma AMI](#building-an-ami)
+ [Preparando e protegendo sua AMI para AWS Marketplace](#securing-an-ami)
+ [Verificação da AMI quanto aos requisitos de publicação](#self-service-scanning)
+ [Verificando se o software está sendo executado na sua AMI AWS Marketplace](#verifying-ami-runtime)
## Proteção dos direitos de revenda
Para distribuições Linux não gratuitas, você é responsável por garantir os direitos de revenda delas, com exceção dos AWS Amazon Linux, RHEL e SUSE fornecidos. Você não precisa garantir os direitos de revenda do Windows AMIs.
## Criação de uma AMI
Use as seguintes diretrizes para construir AMIs:
+ Certifique-se de que sua AMI atenda a todas [AWS Marketplace as políticas](https://docs.aws.amazon.com/marketplace/latest/userguide/product-and-ami-policies.html).
+ Crie a AMI na região Leste dos EUA (Norte da Virgínia).
+ Crie produtos a partir de produtos existentes e bem mantidos, AMIs apoiados pelo Amazon Elastic Block Store (Amazon EBS) com um ciclo de vida claramente definido, fornecido por fontes confiáveis e confiáveis, como. AWS Marketplace
+ Crie AMIs usando a maioria dos sistemas up-to-date operacionais, pacotes e software.
+ Verifique se a AMI se baseia em uma AMI do Amazon EC2, que usa a virtualização de máquina virtual de hardware (HVM) e a arquitetura de 64 bits.
+ Desenvolva um processo repetível para criar, atualizar e republicar. AMIs
+ Use um nome de usuário do sistema operacional (SO) consistente em todas as versões e produtos. Os nomes de usuário padrão recomendados são `ec2-user` para Linux e outros sistemas semelhantes ao UNIX e `Administrator` para Windows.
+ Antes de enviar uma AMI final para AWS Marketplace publicação, execute e teste uma instância da sua AMI para verificar a experiência pretendida do usuário final. Teste todos os métodos de instalação, atributos e desempenho nessa instância.
+ Verifique as configurações da porta da seguinte forma:
+ Como [melhor prática de configuração de segurança](https://aws.amazon.com/blogs/security/defense-in-depth-open-firewalls-reverse-proxies-ssrf-vulnerabilities-ec2-instance-metadata-service/) contra firewalls abertos, proxies reversos e vulnerabilidades de SSRF, a opção de **suporte do IMDS** deve ser definida como somente. **IMDSv2** A seguinte CLI pode ser usada durante o registro de uma nova AMI na fase de compilação final:
+ `aws ec2 register-image --name my-image --root-device-name /dev/xvda --block-device-mappings DeviceName=/dev/xvda,Ebs={SnapshotId=snap-0123456789example} --architecture x86_64 --imds-support v2.0`
Para obter mais informações sobre a criação de uma AMI, consulte os seguintes recursos:
+ [Crie uma AMI baseada no Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html) no *Guia do usuário do Amazon EC2*
+ [Crie uma AMI do Amazon EC2 usando o Windows Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html) no *Guia do usuário do Amazon EC2*
+ [Como criar uma Imagem de máquina da Amazon (AMI) usando uma instância baseada em EBS?](https://aws.amazon.com/premiumsupport/knowledge-center/create-ami-ebs-backed/)
+ [Amazon Linux AMI](https://aws.amazon.com/amazon-linux-ami/)
+ [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/) e [Tipos de instância](http://docs.amazonwebservices.com/AWSEC2/latest/UserGuide/instance-types.html?r=2153)
+ [Configuração de uma AMI para uso do IMDS V2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-new-instances.html#configure-IMDS-new-instances-ami-configuration) por padrão
## Preparando e protegendo sua AMI para AWS Marketplace
Recomendamos as seguintes diretrizes para criar segurança AMIs:
+ Use as [diretrizes para Linux compartilhado AMIs](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/building-shared-amis.html) no Guia do *usuário do Amazon EC2*
+ Projete sua AMI par implantação como instalação mínima para reduzir a superfície de ataque. Desative ou remova serviços e programas desnecessários.
+ Sempre que possível, use end-to-end criptografia para tráfego de rede. Por exemplo, use Secure Sockets Layer (SSL) para proteger sessões HTTP entre você e seus compradores. Certifique-se de que seu serviço use somente up-to-date certificados válidos.
+ Ao documentar o produto da AMI, faça recomendações do grupo de segurança para que os compradores controlem o acesso do tráfego de entrada às instâncias. As recomendações devem especificar o seguinte:
+ O conjunto mínimo de portas necessário para que os serviços funcionem.
+ As portas recomendadas e os intervalos de endereços IP de origem para acesso administrativo.
Essas recomendações do grupo de segurança ajudam compradores a implementar os controles de acesso indicados. Para obter mais informações sobre como adicionar uma nova versão ao produto de AMI, consulte [Adicionar uma nova versão](single-ami-versions.md#single-ami-adding-version).
+ Considere realizar um teste de penetração em seu ambiente de AWS computação em intervalos regulares ou considere contratar um terceiro para realizar esses testes em seu nome. Para obter mais informações, incluindo um formulário de solicitação de teste de penetração, consulte [Testes de penetração da AWS](https://aws.amazon.com/security/penetration-testing/).
+ Esteja ciente das dez principais vulnerabilidades para aplicativos web e crie seus aplicativos adequadamente. Para saber mais, consulte [Open Web Application Security Project (OWASP) - Top 10 Web Application Security Risks](https://owasp.org/www-project-top-ten/). Quando novas vulnerabilidades da Internet são descobertas, atualize prontamente qualquer aplicativo web enviado na AMI. Exemplos de recursos que incluem essas informações são [SecurityFocus](http://www.securityfocus.com/vulnerabilities)e o Banco de [Dados Nacional de Vulnerabilidades do NIST](http://nvd.nist.gov/).
Para obter mais informações sobre segurança, consulte os seguintes recursos relacionados:
+ [Segurança da Nuvem AWS](https://aws.amazon.com/security/)
+ [The Center for Internet Security (CIS): Security Benchmarks](http://benchmarks.cisecurity.org/downloads/benchmarks/)
+ [The Open Web Application Security Project (OWASP): Guia de referência rápida de práticas de codificação seguras](https://owasp.org/www-project-secure-coding-practices-quick-reference-guide/)
+ [OWASP Top 10 Web Application Security Risks](https://owasp.org/www-project-top-ten/)
+ [SANS (SysAdmin, auditoria, rede e segurança) Common Weakness Enumeration (CWE) Os 25 erros de software mais perigosos](http://www.sans.org/top25-software-errors/)
+ [Security Focus](http://www.securityfocus.com/vulnerabilities)
+ [NIST National Vulnerability Database](http://nvd.nist.gov/)
## Verificação da AMI quanto aos requisitos de publicação
Para publicar sua AMI no AWS Marketplace catálogo, você deve concluir a verificação da AMI. O escaneamento de AMI verifica vulnerabilidades e exposições comuns não corrigidas (CVEs) e verifica se sua AMI segue as melhores práticas de segurança. Para obter mais informações, consulte [Preparando e protegendo sua AMI para AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/userguide/best-practices-for-building-your-amis.html#securing-an-ami)
Para realizar a verificação da AMI, escolha uma das seguintes opções:
**Opção 1: menu Ativos**
Esse método permite a digitalização AMIs fora do fluxo de criação do produto. Ele também é útil para vendedores de SaaS que usam o Início Rápido de SaaS e precisam verificar ativos sem criar um produto AMI.
1. No [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management/homepage), navegue até **Ativos** e escolha **Imagem de máquina da Amazon**.
1. Para iniciar o processo de verificação, escolha **Adicionar AMI**.
1. Você pode ver o status do AMIs escaneamento retornando a esta página.
**Opção 2: menu Solicitar alterações**
Essa opção está disponível para vendedores que já criaram um produto AMI. Saiba mais em [Criação de produtos baseados em AMI](ami-single-ami-products.md)
1. No [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management/homepage), navegue até o menu **Produtos** e escolha **Servidor**.
1. Selecione o produto em **Produtos de servidor**. Ele deve ser um produto baseado em AMI. O produto pode estar em qualquer estado e não precisa estar no estado publicado **Público** para as próximas etapas.
1. Navegue até o menu **Solicitar alterações** e selecione **Atualizar versões**.
1. Selecione **Testar “Adicionar versão**”. Siga os prompts para enviar uma solicitação com os detalhes da AMI. Se a solicitação for bem-sucedida, isso indicará que a AMI passou pela verificação com êxito. Diferentemente da opção **Adicionar nova versão**, **Testar “Adicionar versão”** não adicionará uma nova versão ao produto baseado em AMI se a verificação for bem-sucedida.
**nota**
Para saber mais sobre como dar AWS Marketplace acesso à sua AMI, consulte[Dando AWS Marketplace acesso à sua AMI](single-ami-marketplace-ami-access.md).
## Verificando se o software está sendo executado na sua AMI AWS Marketplace
É altamente recomendável que o software seja verificado em runtime se está em execução em uma instância do Amazon EC2 criada a partir do produto da AMI.
Para verificar se a instância do Amazon EC2 foi criada a partir do seu produto de AMI, use o serviço de metadados da instância incorporado ao Amazon EC2. As etapas a seguir conduzem você por essa validação. Para obter mais informações sobre como usar o serviço de metadados, consulte [Metadados de instância e dados do usuário](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) no *Guia do usuário do Amazon Elastic Compute Cloud*.
1. *Obter o documento de identidade da instância*
Cada instância em execução tem um documento de identidade acessível na instância que fornece dados sobre a própria instância. O exemplo a seguir mostra o uso do curl da instância para recuperar o documento de identidade da instância.
IMDSv2: (Recomendado)
```
TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/document
{
"accountId" : "0123456789",
"architecture" : "x86_64",
"availabilityZone" : "us-east-1e",
"billingProducts" : null,
"devpayProductCodes" : null,
"marketplaceProductCodes" : [ "0vg0000000000000000000000" ],
"imageId" : "ami-0123456789abcdef1",
"instanceId" : "i-0123456789abcdef0",
"instanceType" : "t2.medium",
"kernelId" : null,
"pendingTime" : "2020-02-25T20:23:14Z",
"privateIp" : "10.0.0.2",
"ramdiskId" : null,
"region" : "us-east-1",
"version" : "2017-09-30"
}
```
IMDSv1:
```
curl http://169.254.169.254/latest/dynamic/instance-identity/document{
"accountId" : "0123456789",
"architecture" : "x86_64",
"availabilityZone" : "us-east-1e",
"billingProducts" : null,
"devpayProductCodes" : null,
"marketplaceProductCodes" : [ "0vg0000000000000000000000" ],
"imageId" : "ami-0123456789abcdef1",
"instanceId" : "i-0123456789abcdef0",
"instanceType" : "t2.medium",
"kernelId" : null,
"pendingTime" : "2020-02-25T20:23:14Z",
"privateIp" : "10.0.0.2",
"ramdiskId" : null,
"region" : "us-east-1",
"version" : "2017-09-30"
}
```
1. *Verificar o documento de identidade da instância*
Você pode verificar se a identidade da instância está correta usando a assinatura. Para obter detalhes sobre esse processo, consulte [Documentos de identidade da instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-identity-documents.html) no *Guia do usuário do Amazon Elastic Compute Cloud*.
1. *Verificar o código do produto*
Quando você envia inicialmente seu produto de AMI para publicação, seu produto recebe um [código de produto](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-getting-started.html#ami-product-codes) do AWS Marketplace. Você pode verificar o código do produto verificando o campo `marketplaceProductCodes` no documento de identidade da instância ou pode obtê-lo diretamente do serviço de metadados:
IMDSv2:
```
TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/product-codes
```
Se o código do produto corresponder ao do produto de AMI, a instância foi criada a partir do seu produto.
# 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.
# Recebendo notificações do Amazon SNS para produtos AMI em AWS Marketplace
Para receber notificações sobre alterações nas assinaturas de clientes de seus produtos, você pode assinar os tópicos do Amazon Simple Notification Service (Amazon SNS) fornecidos AWS Marketplace durante a criação do produto. Por exemplo, você pode saber quando clientes aceitam uma oferta privada. [Tópico do Amazon SNS: aws-mp-subscription-notification](#ami-sns-subscription-message-body) é um tópico do Amazon SNS disponível para produtos de AMI. Este tópico notifica você quando um comprador assina ou cancela a assinatura de um produto. Essa notificação está disponível para modelos de preços por hora, incluindo por hora e por hora com anual. Para obter mais informações, consulte as seções a seguir.
**nota**
Durante o processo de criação do produto, um tópico do Amazon SNS é criado para seu produto. Para assinar notificações, você precisa do nome do recurso da Amazon (ARN) do tópico do Amazon SNS (por exemplo, `arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE`). O ARN não está disponível no portal do vendedor para produtos de servidor. Entre em contato com a [equipe de operações do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us) para solicitar o ARN.
**Topics**
+ [Tópico do Amazon SNS: aws-mp-subscription-notification](#ami-sns-subscription-message-body)
+ [Assinatura de uma fila do Amazon SQS no tópico do Amazon SNS](#subscribing-an-sqs-queue-to-an-sns-topic)
## Tópico do Amazon SNS: aws-mp-subscription-notification
Cada mensagem no tópico `aws-mp-subscription-notification` para a ação `subscribe-success` e `subscribe-fail` tem o formato a seguir.
```
{
"action": "action-name",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
"offer-identifier": "offer-abcexample123"
}
```
**Isso variará de acordo com a notificação. As ações possíveis são:
+ `subscribe-success`
+ `subscribe-fail`
+ `unsubscribe-pending`
+ `unsubscribe-success`
O `offer-identifier` só é incluído na notificação quando a ação é `subscribe-success` ou `subscribe-fail`. Ele não é incluído em notificações quando a ação é `unsubscribe-pending` ou `unsubscribe-success`. Para ofertas criadas antes de janeiro de 2024, esse identificador só é incluído na notificação para ofertas privadas. Para ofertas criadas em janeiro de 2024 e posteriores, esse identificador é incluído em notificações de todas as ofertas, inclusive ofertas privadas e ofertas públicas.
Para obter informações sobre os tipos de oferta, consulte a resposta da [DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity) ou a visibilidade da oferta de um contrato no [painel de renovações de contratos](https://docs.aws.amazon.com//marketplace/latest/userguide/agreements-renewals-dashboard.html).
**nota**
Para a [DescribeEntity API](https://docs.aws.amazon.com//marketplace/latest/APIReference/work-with-private-offers.html#describe-entity), se você encontrar uma faceta de segmentação Conta da AWS na conta da regra de segmentação para essa oferta, é uma oferta privada. Se não houver uma faceta de segmentação Conta da AWS na conta da regra de segmentação para essa oferta, é uma oferta pública.
## Assinatura de uma fila do Amazon SQS no tópico do Amazon SNS
Recomendamos assinar uma fila do Amazon SQS nos tópicos do SNS fornecidos. Para obter instruções detalhadas sobre como criar uma fila do SQS e assinar a fila em um tópico, consulte [Assinatura de uma fila do Amazon SQS em um tópico do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
**nota**
Você só pode se inscrever AWS Marketplace nos tópicos do SNS do site Conta da AWS usado para vender os produtos. No entanto, você pode encaminhar as mensagens para uma conta diferente. Para obter mais informações, consulte [Envio de mensagens do Amazon SNS para uma fila do Amazon SQS em uma conta diferente](https://docs.aws.amazon.com/sns/latest/dg/sns-send-message-to-sqs-cross-account.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
### Pesquisar notificações na fila do SQS
Depois de assinar a fila do SQS em um tópico do SNS, as mensagens são armazenadas no SQS. Defina um serviço que continuamente sonde a fila, procure mensagens e manipule-as da forma adequada.
# Lista de verificação de produtos da AMI para AWS Marketplace
Antes de enviar o produto da imagem de máquina da Amazon (AMI) para a AWS, use esta lista de verificação para validar o envio. Seguir esses requisitos ajudará a garantir um processo de publicação eficiente.
## Uso do produto
+ A AMI está pronta para produção.
+ O uso do produto não tem restrição por tempo ou nenhuma outra medição.
+ A AMI é compatível com a experiência de realização do 1-click.
+ Tudo que for necessário para utilizar o produto está no software, incluindo aplicativos clientes. Os produtos que exigem dependências externas, como pacotes de software ou aplicativos cliente, seguem o [Políticas de uso do produto](product-and-ami-policies.md#product-usage) que inclui a divulgação indicada.
+ A AMI atende ao [Requisitos de produto baseados em AMI para AWS Marketplace](product-and-ami-policies.md) obrigatório.
+ Não é necessária nenhuma licença adicional para usar o produto.
+ O comprador não precisa fornecer informações de identificação pessoal (por exemplo, endereço de e-mail) para usar o produto.
## Preparação da AMI
+ O nome e a descrição do produto devem corresponder ao campo **Descrição** do produto da AMI que você está fornecendo.
+ Utiliza virtualização de máquina virtual de hardware (HVM) e arquitetura de 64 bits.
+ O produto não contém vulnerabilidades, malware ou vírus conhecidos.
+ Os clientes podem ter acesso à instância pela rede e usar o acesso administrativo.
+ Não há nenhum segredo codificado presente na AMI. Entre os exemplos de segredos codificados estão senhas padrão para usuários e serviços do sistema, chaves privadas e credenciais.
+ Não há nenhuma chave pública autorizada SSH codificada presente na AMI.
+ O teste de validação “Adicionar versão” do teste é concluído com êxito sem problemas.
## Windows AMIs
+ Para Windows Server 2012 e sistemas operacionais posteriores, a AMI usa a versão mais recente do [EC2Launch v2](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2launch-v2-install.html).
+ Se você estiver usando o EC2Launch v2, conclua o seguinte:
+ Em [configurações do Amazon EC2Launch](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2launch-v2-settings.html#ec2launch-v2-ui), escolha **Aleatório** em **Definir conta de administrador** para que uma senha de administrador seja gerada em runtime.
+ Em [configurações do Amazon EC2Launch](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2launch-v2-settings.html#ec2launch-v2-ui), selecione **Reabilitar e iniciar serviço SSM após o Sysprep**.
+ Adicione **UserData** à [configuração da tarefa do EC2 v2](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2launch-v2-settings.html#ec2launch-v2-task-configuration).
+ Para o Windows Server 2012 e versões posteriores, evite usar o [EC2Config](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/UsingConfig_Install.html). Se o EC2Config for necessário, não deixe de usar a versão mais recente.
+ Se você usar o EC2Config, habilite os seguintes parâmetros nos [arquivos de configurações](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2config-service.html#UsingConfigXML_WinAMI) da AMI:
+ `Ec2SetPassword`
+ `Ec2WindowsActivate`
+ `Ec2HandleUserData`
+ Verifique se não há contas de convidados ou usuários de desktop remoto presentes.
## AMIs do Linux
+ O login remoto como superusuário é proibido.
+ O acesso remoto baseado em senha é proibido.
## Formulário de carga do produto ou guia Produto
+ Todos os campos obrigatórios estão preenchidos.
+ Todos os valores estão dentro dos limites de caracteres especificados.
+ Todos os URLs são carregados sem erros.
+ A imagem do produto tem, no mínimo, 110 pixels de largura e uma proporção entre 1:1 e 2:1.
+ A definição de preço é especificada para todos os tipos de instância ativados (para modelos de definição de preço por hora, por hora e mensal e por hora e anual).
+ A definição de preço mensal é especificada (para modelos de definição de preço mensal e por hora e mensal).
# Requisitos de produto baseados em AMI para AWS Marketplace
AWS Marketplace mantém as seguintes políticas para todos os produtos e ofertas da Amazon Machine Image (AMI). As políticas nesta seção devem oferecer aos clientes uma plataforma de computação segura e confiável.
Todos os produtos e seus metadados relacionados são revisados quando enviados para garantir que atendam ou excedam AWS Marketplace as políticas atuais. Essas políticas são atualizadas regularmente para se alinharem às diretrizes de segurança em evolução. AWS Marketplace examina continuamente os produtos para verificar se os anúncios existentes continuam atendendo a quaisquer alterações nesses requisitos. Se um produto não estiver em conformidade, AWS Marketplace entraremos em contato com o vendedor para atualizá-lo para atender aos novos padrões. Em alguns casos, os produtos podem permanecer indisponíveis temporariamente para novos assinantes até que os problemas sejam resolvidos. Esse processo ajuda a manter a segurança e a confiabilidade da AWS Marketplace plataforma para todos os usuários.
Antes de enviar seu produto, é altamente recomendável usar o recurso [Testar “Adicionar versão”](https://aws.amazon.com/marketplace/management/products/server) no Portal de gerenciamento do AWS Marketplace para garantir a conformidade com as políticas atuais.
**Topics**
+ [Políticas de vendedor do produto de AMI](#ami-product-seller-policies)
+ [Políticas de segurança](#ami-security)
+ [Políticas de arquitetura](#architecture)
+ [Instruções de uso de produtos de AMI](#ami-product-usage-instructions)
+ [Políticas de versão do produto de AMI](#ami-product-version-policies)
+ [Requisitos do produto FPGA](#ami-fpga-product-requirements)
+ [Políticas de informações do cliente](#customer-information)
+ [Políticas de uso do produto](#product-usage)
## Políticas de vendedor do produto de AMI
Todos AMIs devem seguir as seguintes políticas do vendedor:
+ Por padrão, AWS Marketplace os vendedores estão limitados a um máximo de 75 ofertas públicas de produtos da AMI. Todos os vendedores acima do limite estão sujeitos a uma análise periódica de desempenho e podem ser obrigados a restringir anúncios com baixo desempenho. AWS Marketplace pode conceder e revogar aumentos desse limite a seu exclusivo critério.
## Políticas de segurança
### Políticas gerais
Todos AMIs devem estar em conformidade com as seguintes políticas:
+ AMIs deve passar por todas as verificações de segurança realizadas pela [ferramenta de verificação da AWS Marketplace AMI](https://aws.amazon.com/marketplace/management/products/server), não mostrando vulnerabilidades ou malware conhecidos.
+ AMIs deve usar sistemas operacionais e software atualmente suportados. Sistemas operacionais e softwares que chegaram ao final da vida útil não são permitidos.
+ A autenticação baseada em senha, para serviços de instância, é proibida. Isso se aplicará mesmo se a senha for gerada, redefinida ou definida pelo usuário na inicialização. Senhas anuladas e em branco não são permitidas.
Exceções:
+ Senhas de administrador geradas por `EC2Config/EC2Launch` em instâncias do Windows.
+ Acesso não administrativo a serviços de host (por exemplo, aplicativos web) na ausência de outros métodos de autenticação. Se forem usadas senhas fortes, elas deverão ser geradas aleatoriamente para cada instância, usadas uma vez pelo administrador do serviço para a autenticação inicial e alteradas imediatamente após o primeiro login.
+ A AMI não deve conter segredos codificados, como senhas de usuário e serviço do sistema (inclusive senhas com hash), chaves privadas ou credenciais.
+ AMIs não deve solicitar AWS credenciais para acessar os AWS serviços. Se seu produto exigir acesso a AWS serviços, uma instância deverá receber uma função minimamente privilegiada AWS Identity and Access Management (IAM). Os usuários podem criar funções manualmente ou usando um CloudFormation modelo. Quando o lançamento de uma única AMI está habilitado para produtos com um método de CloudFormation entrega, as instruções de uso devem incluir orientações claras para a criação de funções de IAM com privilégios mínimos. Para obter mais informações, consulte [Entregando seu produto baseado em AMI usando](https://docs.aws.amazon.com/marketplace/latest/userguide/cloudformation.html). AWS CloudFormation
+ Um vendedor não deve ter acesso a instâncias executadas por um cliente. Em casos quando esse acesso for necessário para suporte ou outra finalidade, o cliente poderá receber a instrução de habilitá-lo explicitamente.
### Políticas de acesso SSH (Secure Shell)
Além das [políticas gerais](#general-policies), o AMIs fornecimento de acesso SSH (Secure Shell) deve estar em conformidade com as seguintes políticas de segurança:
+ AMIs não deve permitir a autenticação baseada em senha usando SSH. Para garantir isso, no arquivo `sshd_config`, defina `PasswordAuthentication` como `no`.
+ AMIs deve desativar logins remotos baseados em senha para contas de superusuário. Para obter mais informações, consulte [Desabilitar logins remotos baseados em senha para o usuário-raiz](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/building-shared-amis.html#public-amis-disable-password-logins-for-root).
+ AMIs não deve conter chaves públicas autorizadas para acesso SSH.
+ O SSH ativado AMIs deve estar acessível aos procedimentos AWS Marketplace internos de verificação.
+ O serviço SSH deve escutar na porta TCP especificada para o escaneamento da AMI. Para obter mais informações, consulte [Adicionar uma nova versão](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-versions.html#single-ami-adding-version).
+ O SSH deve estar acessível a partir de sub-redes `10.0.0.0/16` e `10.2.0.0/16` no endereço IP atribuído pelo Amazon Elastic Compute Cloud (Amazon EC2) no lançamento da instância.
### Políticas AMIs baseadas no Linux e em outros sistemas operacionais semelhantes ao UNIX
Além das [políticas gerais](#general-policies), AMIs com base no Linux e em outros sistemas operacionais semelhantes ao UNIX, devem estar em conformidade com as seguintes políticas de segurança:
+ AMIs deve permitir que os usuários tenham acesso totalmente privilegiado (por exemplo, para permitir o `sudo` acesso).
### Políticas para sistemas baseados em Windows AMIs
Além das [políticas gerais](#general-policies), os sistemas baseados em Windows AMIs devem estar em conformidade com as seguintes políticas de segurança:
+ AMIs não deve conter contas de convidados.
+ Somente contas de administrador podem ter acesso remoto à área de trabalho a uma instância.
+ O Windows AMIs deve gerar senhas de administrador habilitando essas opções no [EC2Launch](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ec2launch-v2.html) (ou [EC2Config](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ec2config-service.html) para Windows 2016 e versões anteriores):
+ `Ec2SetPassword`
+ `Ec2WindowsActivate`
+ `Ec2HandleUserData`
+ AMIs deve estar disponível para verificação automática. Pelo menos um dos seguintes requisitos deve ser implementado:
+ (Opção recomendada) O atendente SSM é instalado e tem permissões administrativas e acesso de saída à rede.
+ O serviço [Windows Remote Management (WinRM)](https://learn.microsoft.com/en-us/windows/win32/winrm/portal) está ativado, escuta na `5985` porta TCP e pode ser acessado a partir de `10.0.0.0/16` sub-redes e `10.2.0.0/16` no endereço IP atribuído pelo Amazon Elastic Compute Cloud (Amazon) no lançamento da instância. EC2
+ O protocolo [Microsoft Server Message Block (SMB) e o serviço de protocolo Common Internet File System (CIFS)](https://learn.microsoft.com/en-us/windows/win32/fileio/microsoft-smb-protocol-and-cifs-protocol-overview) estão habilitados, escutam em portas TCP `139` `445` e podem ser acessados a partir de sub-redes `10.0.0.0/16` e `10.2.0.0/16` no endereço IP atribuído pelo Amazon Elastic Compute Cloud (Amazon) na inicialização da instância. EC2
## Políticas de arquitetura
Todos AMIs devem seguir as seguintes políticas de arquitetura:
+ A fonte AMIs AWS Marketplace deve ser fornecida na região Leste dos EUA (Norte da Virgínia).
+ AMIs deve usar a virtualização HVM.
+ AMIs deve usar a arquitetura ARM x86-64 ou 64 bits.
+ AMIs deve ser AMIs apoiado pelo Amazon Elastic Block Store (Amazon EBS). Não oferecemos suporte AMIs apoiado pelo Amazon Simple Storage Service.
+ AMIs não deve usar snapshots criptografados do EBS.
+ AMIs não deve usar sistemas de arquivos criptografados.
+ AMIs devem ser construídos para que possam ser executados em todos Regiões da AWS e sejam independentes de região. AMIs construídos de forma diferente para diferentes regiões não são permitidos.
## Instruções de uso de produtos de AMI
Ao criar as instruções de uso do produto de AMI, siga as etapas e as orientações em [Criação de instruções de uso de produtos de contêiner e AMI para AWS Marketplace](ami-container-product-usage-instructions.md).
## Políticas de versão do produto de AMI
AWS Marketplace automatiza a experiência de gerenciamento de versões para AWS clientes e vendedores usando S-AMI, AMI com CloudFormation modelo e produtos de contêiner. Com o arquivamento da versão automático, qualquer versão do produto que tenha sido restringida por um vendedor por mais de dois anos é arquivada automaticamente. As versões arquivadas não estão mais disponíveis para lançamento AWS Marketplace para novos clientes, no entanto, os usuários existentes podem continuar usando a versão arquivada por meio de modelos de lançamento e grupos do Amazon Auto EC2 Scaling especificando a ID da AMI. Qualquer versão arquivada que não tenha sido usada para iniciar uma nova instância nos últimos 13 meses será excluída. Depois que uma versão arquivada for excluída, ela não estará mais disponível para lançamento para usuários novos ou existentes.
## Requisitos do produto FPGA
Além dos requisitos padrão do produto AMI, os produtos FPGA devem atender aos seguintes requisitos:
+ O AFI IDs deve pertencer à sua conta de AWS Marketplace vendedor.
+ Cada versão do produto suporta no máximo 15 AFI IDs, permitindo que você forneça várias configurações de FPGA enquanto mantém a complexidade gerenciável do produto.
+ A AFI IDs deve ser criada e registrada na região Leste dos EUA (Norte da Virgínia).
+ A disponibilidade regional é limitada às regiões em que os tipos de instância F2 são compatíveis.
+ A função de acesso do IAM fornecida durante a criação da versão tem permissões para compartilhar a fornecida AFIs com o AWS Marketplace. Para obter mais detalhes sobre as permissões necessárias, consulte [Conceder ao AWS Marketplace acesso às suas imagens FPGA](https://docs.aws.amazon.com/marketplace/latest/userguide/single-ami-marketplace-ami-access.html#single-ami-marketplace-afi-access).
## Políticas de informações do cliente
Todos AMIs devem seguir as seguintes políticas de informações ao cliente:
+ O software não deve coletar ou exportar dados do cliente sem o conhecimento e o consentimento explícito do cliente, exceto conforme exigido por BYOL (traga a sua própria licença). Os aplicativos que coletam ou exportam dados de clientes devem seguir estas diretrizes:
+ A coleta dos dados do cliente deve ser de autoatendimento, automatizada e segura. Os compradores não precisam esperar que os vendedores aprovem a implantação do software.
+ A coleta de dados do cliente deve ser consistente com seus contratos com AWS, incluindo, mas não se limitando a, os [Termos e Condições do AWS Marketplace, os Termos](https://aws.amazon.com/legal/seller-terms/) de [AWS Serviço](https://aws.amazon.com/service-terms/), o [Aviso AWS de Privacidade](https://aws.amazon.com/privacy/) e o [Contrato AWS do Cliente](https://aws.amazon.com/agreement/).
+ As informações de pagamento não devem ser coletadas.
## Políticas de uso do produto
Todos AMIs devem seguir as seguintes políticas de uso do produto:
+ Os produtos não devem restringir o acesso ao produto ou à funcionalidade do produto por tempo, número de usuários ou outras restrições. Os produtos beta e de pré-lançamento ou produtos cujo único propósito é oferecer funcionalidade de teste ou avaliação não são compatíveis. As edições Developer, Community e BYOL do software comercial são compatíveis, desde que uma versão equivalente paga também esteja disponível no AWS Marketplace.
+ Todos AMIs devem ser compatíveis com a experiência do Launch from Website ou com a entrega baseada em AMI. AWS CloudFormation Para início no site, a AMI não pode exigir que os dados do cliente ou usuário na criação da instância funcionem corretamente.
+ AMIs e seu software deve ser implantável de forma autossuficiente e não deve exigir métodos ou custos adicionais de pagamento. Os aplicativos que exigem dependências externas na implantação devem seguir estas diretrizes:
+ O requisito deve ser divulgado na descrição ou nas instruções de uso da lista. Por exemplo, *Este produto requer uma conexão com a Internet para ser implantado corretamente. Os seguintes pacotes são baixados na implantação: .*
+ Os vendedores são responsáveis pelo uso e pela garantia da disponibilidade e segurança de todas as dependências externas.
+ Se as dependências externas não estiverem mais disponíveis, o produto AWS Marketplace também deverá ser removido.
+ As dependências externas não devem exigir métodos ou custos adicionais de pagamento.
+ AMIs que exigem uma conexão contínua com recursos externos que não estão sob o controle direto do comprador — por exemplo, externos APIs ou Serviços da AWS gerenciados pelo vendedor ou por terceiros — devem seguir estas diretrizes:
+ O requisito deve ser divulgado na descrição ou nas instruções de uso da lista. Por exemplo, *Este produto requer uma conexão contínua com a Internet. Os seguintes serviços externos contínuos são necessários para funcionar adequadamente: .*
+ Os vendedores são responsáveis pelo uso e pela garantia da disponibilidade e segurança de todos os recursos externos.
+ Se os recursos externos não estiverem mais disponíveis, o produto AWS Marketplace também deverá ser removido.
+ Os recursos externos não devem exigir métodos de pagamento ou custos adicionais e a configuração da conexão deve ser automatizada.
+ Os metadados e software do produto não devem conter linguagem que redirecione os usuários para outras plataformas de nuvem, produtos adicionais ou serviços de vendas adicionais que não estão disponíveis no AWS Marketplace.
+ Se o produto for um complemento de outro produto ou produto de outro ISV, a descrição do produto deverá indicar que ele amplia a funcionalidade do outro produto e que, sem ele, seu produto tem utilidade muito limitada. Por exemplo, *Este produto amplia a funcionalidade de e sem ele, este produto tem uma utilidade muito limitada. Observe que pode exigir uma licença própria para a funcionalidade completa desta lista.*