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 SaaS em AWS Marketplace
Com produtos de software como serviço (SaaS), você pode implantar software hospedado na AWS infraestrutura e conceder aos AWS Marketplace compradores acesso ao software em seu AWS ambiente. Você é responsável por gerenciar o acesso do cliente, a criação de contas, o provisionamento de recursos e o gerenciamento de contas em seu software. Depois de criar seu produto SaaS inicial, você pode enviar solicitações de alteração e configurar suas propriedades AWS Marketplace, incluindo a descrição do produto, a disponibilidade por país, os preços e assim por diante. Você também configura sua assinatura SaaS e a integração do contrato. Os tópicos a seguir fornecem as informações de que você precisa para começar.
Para obter informações sobre a integração APIs com o Amazon API Gateway, consulte [Venda seu API Gateway APIs por meio AWS Marketplace](https://docs.aws.amazon.com/apigateway/latest/developerguide/sell-api-as-saas-on-aws-marketplace.html) do *Guia do desenvolvedor do Amazon API Gateway*.
Para obter ajuda com produtos de SaaS, entre em contato com a equipe de [operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/).
**Topics**
+ [Conceitos básicos de produtos de SaaS no AWS Marketplace](saas-getting-started.md)
+ [Planejar seu produto de SaaS](saas-prepare.md)
+ [Diretrizes de produtos SaaS para AWS Marketplace](saas-guidelines.md)
+ [Preços de produtos SaaS em AWS Marketplace](saas-pricing-models.md)
+ [Criação de uma oferta de teste gratuito de SaaS em AWS Marketplace](saas-free-trials.md)
+ [Integrando clientes ao seu produto SaaS por meio de AWS Marketplace](saas-product-customer-setup.md)
+ [Notificações do Amazon SNS para produtos de SaaS](saas-notification.md)
+ [Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge](saas-eventbridge-integration.md)
+ [Acessando o AWS Marketplace serviço de medição e direitos APIs](saas-integration-metering-and-entitlement-apis.md)
+ [Relatórios para produtos SaaS em AWS Marketplace](saas-reporting.md)
+ [Exemplos de código para integração de produtos de SaaS](saas-code-examples.md)
+ [Entregando seus produtos por meio de uma Amazon VPC usando AWS PrivateLink](privatelink.md)
+ [Solução de problemas de produtos de SaaS](troubleshoot-saas.md)
# Conceitos básicos de produtos de SaaS no AWS Marketplace
Como vendedor do AWS Marketplace, você pode adicionar seu produto de software como serviço (SaaS) para o AWS Marketplace. Isso inclui integrar o produto de SaaS às operações de APIs do AWS Marketplace apropriadas, com base no modelo de faturamento do produto de SaaS. Este tópico fornece uma visão geral do processo de criação e configuração de produtos SaaS, começando com os pré-requisitos necessários para começar.
## Pré-requisitos
Antes de começar, conclua os seguintes pré-requisitos:
1. Acesse e use o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management/). Esta é a ferramenta usada para se registrar como vendedor e gerenciar os produtos que você vende no AWS Marketplace. Para obter mais informações, consulte [Portal de gerenciamento do AWS Marketplace](user-guide-for-sellers.md#aws-marketplace-management-portal).
1. Registre-se como vendedor e envie suas informações fiscais e bancárias. Para obter mais informações, consulte [Processo de registro](registration-process.md).
1. Planeje como você criará e integrará seu produto de SaaS no AWS Marketplace. Para obter mais informações, consulte [Planejar seu produto de SaaS](saas-prepare.md).
## Próximas etapas
Depois de concluir as etapas obrigatórias, você pode criar e configurar seu produto SaaS.
**Topics**
+ [Pré-requisitos](#saas-prereqs)
+ [Próximas etapas](#saas-next-steps)
+ [Ciclo de vida do produto de SaaS no AWS Marketplace](saas-product-lifecycle.md)
+ [Criando um produto SaaS em AWS Marketplace](saas-create-product.md)
+ [Criando uma página inicial do produto SaaS no AWS Marketplace](saas-create-product-page.md)
+ [Definindo as configurações do produto SaaS em AWS Marketplace](saas-product-settings.md)
+ [Integrando sua assinatura Pay-As-You-Go ou produto SaaS com AWS Marketplace](saas-integrate-subscription.md)
+ [Integrando seu produto de contrato SaaS com AWS Marketplace](saas-integrate-contract.md)
+ [Integrando seu produto baseado em contratos SaaS com AWS Marketplace](saas-integrate-contract-with-pay.md)
+ [Implantação de uma integração de SaaS de tecnologia sem servidor](deploy-serverless-saas.md)
# Ciclo de vida do produto de SaaS no AWS Marketplace
Quando você cria um produto de software como serviço (SaaS) no AWS Marketplace, ele é publicado inicialmente com visibilidade limitada para que somente sua conta possa acessá-lo. Quando estiver pronto, você pode publicá-lo no catálogo do AWS Marketplace para permitir que os compradores assinem e comprem seu produto. O tópico a seguir exibe informações sobre o ciclo de vida de produto SaaS. Para obter mais informações sobre como criar um produto SaaS, consulte [Criando um produto SaaS em AWS Marketplace](saas-create-product.md).
Na página Produto de SaaS, você pode ver a lista de seus produtos. Dependendo do estágio no ciclo de vida do produto, o produto terá um dos seguintes status:
+ **Preparação**: um produto incompleto para o qual você ainda está adicionando informações. No primeiro **Salvar e sair** 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 status, 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 status **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. Para obter mais informações ou ajuda, entre em contato com a equipe de [Operações do vendedor do AWS Marketplace](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**. Essa solicitação inicia um fluxo de trabalho para que a equipe de operações do vendedor do AWS Marketplace revise e audite seu produto de acordo com as políticas da AWS. Depois que o produto for aprovado e a solicitação de alteração for processada, o produto será movido do status **Limitado** para **Público**. Para obter informações sobre as diretrizes da AWS, consulte [Diretrizes do produto de SaaS](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-guidelines.html).
+ **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.
Você pode atualizar seu produto nos status **Preparação**, **Limitado** e **Público**. Para obter mais informações, consulte [Atualização das informações do produto](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-settings.html#update-product-information).
# Criando um produto SaaS em AWS Marketplace
Como AWS Marketplace vendedor, você pode adicionar seu produto de software como serviço (SaaS) a. AWS Marketplace Isso inclui criar seu produto SaaS e integrá-lo às operações de AWS Marketplace API apropriadas, com base em seu modelo de cobrança. Para vender software como um produto SaaS em AWS Marketplace, você segue estas etapas gerais:
+ Crie o produto SaaS em. AWS Marketplace
+ Integre a [assinatura](saas-integrate-subscription.md), o contrato ou o [contrato](saas-integrate-contract.md) de SaaS com o pay-as-you-go produto [com](saas-integrate-contract-with-pay.md). AWS Marketplace
+ Teste a [assinatura](saas-integrate-subscription.md#saas-subscription-integration-testing), o [contrato](saas-integrate-contract.md#saas-contract-integration-testing) ou o [contrato com](saas-integrate-contract-with-pay.md#saas-contract-consumption-integration-testing) a integração do pay-as-you-go produto com AWS Marketplace.
+ Envie seu produto para o lançamento.
O procedimento a seguir mostra como criar um produto SaaS em. AWS Marketplace
## Criar um produto de SaaS
**Para criar um produto de SaaS**
1. **Decida listar um produto de SaaS**
Tenha um produto SaaS que você gostaria de vender. AWS Marketplace Analise e entenda como [Planejar seu produto de SaaS](saas-prepare.md).
1. **Determine o preço e o tipo de oferta**
Existem três tipos de oferta para produtos SaaS: assinaturas, contratos e contratos com. pay-as-you-go Sua escolha do tipo de oferta afeta a forma como você integra seu produto SaaS com o. AWS Marketplace Para obter mais informações, consulte [Planejamento da definição de preço](saas-prepare.md#plan-pricing).
1. **Colete ativos**
Colete os ativos necessários para enviar seu produto. Os ativos incluem:
+ URL do logotipo do produto: um URL do Amazon S3 acessível publicamente que contém uma imagem clara do logotipo do produto que você está fornecendo.
+ URL do Contrato de Licença de Usuário Final (EULA): seu produto deve ter um EULA disponível como arquivo PDF. Você deve fornecer um link para um bucket do Amazon S3 onde os clientes possam revisar o EULA na página do AWS Marketplace do seu produto.
+ URL de registro do produto: é o URL para o qual os compradores são redirecionados após a assinatura bem-sucedida do seu produto no AWS Marketplace.
+ Metadados sobre seu produto: forneça os metadados no assistente de criação de produto do Portal de gerenciamento do AWS Marketplace.
+ Informações de suporte para seu produto — Essas informações incluem endereços de e-mail e URLs canais de suporte do seu produto.
1. **Envie seu produto para integração**
Use sua conta de vendedor e o Portal AWS Marketplace de Gerenciamento para[Criando uma página inicial do produto SaaS no AWS Marketplace](saas-create-product-page.md). AWS Marketplace publicará seu produto como um produto limitado, o que significa que ele só está disponível para uso para integração e teste. O código do produto e a configuração do EventBridge evento da Amazon estarão disponíveis para você na página de visão geral do produto.
**nota**
Seu produto deve permanecer com um preço reduzido para que você e a equipe de operações do AWS Marketplace vendedor possam testá-lo sem incorrer em um grande custo. Solicitaremos o preço real do produto quando você solicitar a visibilidade pública do seu produto.
1. **Integre com AWS Marketplace**
Seu produto deve oferecer suporte aos clientes na integração e no uso do produto, incluindo a validação da assinatura antes de conceder acesso e, em alguns casos, a medição do uso. A forma como você se integra AWS Marketplace depende do tipo de oferta que você está usando para seu produto. Para obter mais informações sobre integração, com base no tipo de oferta, consulte os seguintes tópicos:
+ [Integração de assinatura](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-integrate-subscription.html)
+ [Integração de contrato](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-integrate-contract.html)
+ [Contrato com pay-as-you-go integração](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-integrate-contract-with-pay.html)
A etapa final da integração do seu produto AWS Marketplace é testá-lo para garantir que a integração funcione corretamente.
1. **Teste do produto e cancelamento do contrato**
Depois que você tiver concluído o processo de integração, será recomendável assinar o próprio produto para avaliar e confirmar a experiência do cliente. A criação de uma assinatura de teste permite a você:
+ Avaliar as informações do produto
+ Examinar as opções de compra disponíveis
+ Processar os pagamentos de teste
+ Verificar os links para o site do próprio produto
**Importante**
Cancele sua pay-as-you-go assinatura antes de alterar a visibilidade do seu produto de limitada para pública seguindo as instruções em [Cancelar sua assinatura de SaaS](https://docs.aws.amazon.com/marketplace/latest/buyerguide/cancel-subscription.html#cancel-saas-subscription). Para cancelar o contrato, entre em contato com a equipe de operações do vendedor do AWS Marketplace [enviando um tíquete de suporte](https://aws.amazon.com/marketplace/management/contact-us/).
1. **Envie seu produto para lançamento**
Depois de verificar a integração e estar pronto para o lançamento do produto, escolha **Atualizar visibilidade**. A equipe de operações do vendedor do AWS Marketplace vai analisar o produto e atualizar o preço para que a visibilidade possa ser atualizada para Público.
**nota**
AWS Marketplace O Seller Operations usa um processo manual para verificar e atualizar os produtos SaaS. O processo leva de 7 a 10 dias úteis para atualizar a visibilidade para o público e mais se a equipe encontrar erros. Para obter mais informações sobre horários, consulte [Tempo e expectativas](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#timing-and-expectations) neste guia.
# Criando uma página inicial do produto SaaS no AWS Marketplace
Você pode usar os metadados do aplicativo de software como serviço (SaaS) para criar uma página inicial do produto SaaS no AWS Marketplace catálogo, usando o. Portal de gerenciamento do AWS Marketplace Você também pode adicionar informações do produto, detalhes da implantação do produto e detalhes da oferta pública. Opcionalmente, você pode adicionar contas à lista de permissões para testar o produto. Para obter mais informações, consulte o seguinte procedimento.
**Para criar uma página inicial do produto de SaaS**
1. Faça login no [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management/homepage).
1. Escolha **Criar produto de SaaS** e, em seguida, escolha **Produto de SaaS**.
1. Gere um ID e um código do produto de SaaS. Você também pode adicionar tags opcionais para dar suporte à autorização baseada em tags.
**nota**
Para obter informações sobre autorização baseada em tags, consulte [Controle do acesso a AWS recursos usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources) no *Guia do AWS Identity and Access Management usuário*.
1. Use a experiência de autoatendimento para criar o AWS Marketplace anúncio. Adicione informações do produto, detalhes da implantação do produto e detalhes da oferta pública. Opcionalmente, você também pode adicionar contas à lista de permissões para testar o produto.
**nota**
Se você precisar encerrar sua sessão antes de concluir as etapas, escolha a opção **Salvar e sair** para salvar suas seleções atuais na área de preparação. Essa opção cria uma solicitação para validar as informações que você forneceu. Enquanto sua solicitação está sendo validada, não é possível editar o produto. Se sua solicitação for bem-sucedida, você poderá continuar criando seu produto escolhendo **Retomar a criação do produto**.
Se sua solicitação não for bem-sucedida, é devido a um erro de validação, que está visível no registro de solicitações do produto. Selecione a solicitação para ver o erro e escolha **Copiar para novo** em **Ações** para corrigir o erro e reenviar a solicitação. Para atualizar as etapas anteriores, abra a página de detalhes do produto e envie uma solicitação de alteração.
**nota**
Para produtos que usam modelos de preços não gratuitos (contrato, uso ou contrato com consumo), seu preço padrão será 0,001 USD por dimensão durante o teste. Esse preço permite que você teste seu produto no estado **Limitado** sem incorrer em uma fatura grande. Para produtos que usam o modelo de preço gratuito, as dimensões serão padronizadas para 0,00 USD. Para modelos de preços não gratuitos, você fornecerá seu preço real ao tornar seu produto público. Observe que, se todas as dimensões forem definidas como 0,00 USD, o produto será automaticamente convertido para o modelo de preço gratuito.
1. Selecione **Enviar**. Em seguida, AWS Marketplace valida as informações. Se a validação for bem-sucedida, AWS Marketplace liberará o produto em um status **Limitado**. Depois que a validação for bem-sucedida, você poderá visualizar, integrar e testar seu produto.
**nota**
Enquanto a validação está em andamento, não é possível editar o produto. Quando seu produto é publicado inicialmente, ele só pode ser Conta da AWS acessado pelo usuário que criou o produto e pela conta de teste da equipe de operações do AWS Marketplace vendedor. Se você visualizar o produto na página de **produtos SaaS**, poderá escolher **Exibir em 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 usuários do AWS Marketplace .
# Definindo as configurações do produto SaaS em AWS Marketplace
Depois de [criar um produto de software como serviço (SaaS)](saas-create-product.md) em AWS Marketplace, você pode modificar muitas das configurações do produto. As seções a seguir mostram como enviar solicitações de alteração e modificar as configurações do produto, como atualizar detalhes de preços, visibilidade do produto e outras configurações.
**Topics**
+ [Gerenciar solicitações de alteração](#create-change-request)
+ [Atualizar as informações do produto](#update-product-information)
+ [Atualizar detalhes da arquitetura](#updating-architecture-details)
+ [Atualize a lista de permissões do Conta da AWS IDs](#update-allowlist)
+ [Atualize a visibilidade do produto](#saas-update-visibility)
+ [Atualizar os termos de preços](#saas-update-pricing-terms)
+ [Adicionar dimensões de preço](#saas-add-pricing-dimensions)
+ [Atualizar dimensões de preços](#saas-update-dimension)
+ [Restringir dimensões de preços](#restrict-pricing-dimensions)
+ [Determine como os compradores acessarão seu produto](#configure-product-access)
+ [Configurar o início rápido](#saas-quick-launch)
+ [Atualizar disponibilidade por país](#saas-availability-by-country)
+ [Atualizar a política de reembolso de um produto](#update-refund-policy)
+ [Atualizar o contrato de licença de usuário final (EULA)](#saas-update-eula)
## Gerenciar solicitações de alteração
Em uma [lista de autoatendimento](saas-create-product.md#saas-creating-self-service), você usa uma *solicitação de alteração* para fazer alterações em seu produto. Suas solicitações atuais podem ser encontradas Portal de gerenciamento do AWS Marketplace na [guia **Solicitações**](https://aws.amazon.com/marketplace/management/requests). Você pode fazer novas solicitações por meio da lista suspensa **Solicitar alterações**, localizada abaixo da barra de navegação.
**Para criar uma solicitação de alteração para um produto de SaaS**
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na guia **Produtos**, selecione **SaaS** na lista suspensa.
1. Depois que a solicitação é enviada, ela começa a ser processada. A solicitação de alteração passa pelos seguintes status: **Em análise**, **Preparando alterações** e **Aplicando alterações**.
1. Quando o processamento da solicitação é concluído, seu status muda para um dos seguintes valores:
+ **Bem-sucedido**: esse status indica que a alteração solicitada foi processada e as alterações são refletidas no sistema.
+ **Falha**: esse status indica que algo deu errado com a solicitação e 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 problema. Você poderá solucionar os erros e criar uma nova solicitação para a alteração. Para agilizar o processo, você pode usar a função **Copiar para nova solicitação**, que copia os detalhes da solicitação com **Falha**. Você pode fazer as alterações necessárias e reenviar a solicitação.
As solicitações de alteração que começam com uma atualização carregarão os detalhes atuais do projeto. Em seguida, você pode fazer atualizações, que substituem os detalhes existentes. Adicionar e restringir pares de solicitações são especificamente para atualizações que são provisionadas após o sucesso de cada solicitação (depois de escolher as ações **Salvar e sair e** **Enviar** na experiência de autoatendimento). Isso significa que os assinantes existentes podem continuar usando o produto até que sua assinatura ou contrato termine. No entanto, nenhum novo assinante pode ser adicionado a um produto com status **Restrito**.
## Atualizar as informações do produto
Depois de criar o produto, talvez você queira alterar as informações associadas a ele no AWS Marketplace.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na página [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), na guia **Produtos de SaaS**, 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ê queira alterar:
+ **Título do produto**
+ **SKU**
+ **Descrição breve**
+ **Descrição longa**
+ **URL 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 do logotipo da empresa e do produto](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#seller-and-product-logos).
1. Para atualizar as informações do produto, escolha **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 nova solicitação.
## Atualizar detalhes da arquitetura
Para receber a designação especial na qual seu produto está implantado AWS, atualize os detalhes da arquitetura do produto no Portal de AWS Marketplace Gerenciamento (AMMP) selecionando um padrão de hospedagem e fazendo o upload de um diagrama de arquitetura. Para obter uma lista dos padrões de hospedagem AWS considerados implantados AWS, consulte[Diretrizes](saas-guidelines.md#march-saas-guidelines).
**Para atualizar detalhes da arquitetura**
1. Faça login no [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management).
1. No menu **Produtos**, escolha **SaaS**.
1. Na tabela **Produtos de SaaS**, escolha o produto.
1. Em **Solicitar alterações**, escolha **Atualizar detalhes da arquitetura**.
1. Escolha um padrão de hospedagem. Se você selecionar um padrão de hospedagem que AWS Marketplace considere implantado AWS, conclua as duas etapas adicionais a seguir. Para obter mais informações sobre padrões considerados implantados AWS[Diretrizes](saas-guidelines.md#march-saas-guidelines), consulte anteriormente neste guia.
1. Se solicitado, na seção **Diagrama de arquitetura**, escolha **Escolher arquivo** para carregar o diagrama de arquitetura em formato PNG ou JPG. Para obter mais informações sobre diagramas, consulte [Criação dos diagramas de arquitetura](saas-guidelines.md#arch-diagram).
1. Se solicitado, no **Plano de aplicativo**, escolha onde o aplicativo é executado. Para obter mais informações, consulte [Ambiente de gerenciamento X plano de aplicativo](https://docs.aws.amazon.com//whitepapers/latest/saas-architecture-fundamentals/control-plane-vs.-application-plane.html).
1. Escolha **Atualizar detalhes da arquitetura**.
Depois que a solicitação for concluída, **Status da solicitação** mudará para **Bem-sucedido**. Para verificar o status da solicitação, escolha o produto na tabela **Produtos de SaaS** e escolha a guia **Solicitar log**.
Para exibir os resultados da avaliação, escolha o produto na tabela **Produtos de SaaS** e a guia **Detalhes da arquitetura**.
## Atualize a lista de permissões do Conta da AWS IDs
Você pode alterar a lista do Conta da AWS IDs que pode visualizar seu produto em um estado limitado.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na página [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), na guia **Produtos de SaaS**, selecione o produto que você deseja modificar.
1. Na lista suspensa **Solicitar alterações**, selecione **Atualizar lista de permissões**. Uma lista mostra os Conta da AWS IDs que estão atualmente na lista de permissões.
1. No Contas da AWS campo Lista de **permissões**, insira Conta da AWS IDs e separe-os usando uma vírgula.
1. Para atualizar a lista de permissões do Conta da AWS IDs, escolha **Enviar**.
## Atualize a visibilidade do produto
Para alterar em quais compradores podem ver sua experiência de lançamento rápido AWS Marketplace, você pode usar a **visibilidade da atualização**.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na página [Produtos de SaaS](https://console.aws.amazon.com/marketplace/latest/userguide/saas-guidelines.html), 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 **Público**.
1. Ao publicar para o público, você fornecerá o preço real do seu produto. Esse preço será aplicado depois que sua lista for aprovada para visibilidade pública.
1. Escolha **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 se tornará **Bem-sucedido**.
## Atualizar os termos de preços
Para alterar a definição de preço por dimensão no produto de SaaS, use **Atualizar termos da definição de preço**.
**nota**
Um aumento de preço para qualquer dimensão resulta na indisponibilidade da opção de atualização de preços por pelo menos os próximos 90 dias. Se estiver atualizando uma redução e um aumento de preço, atualize primeiro a redução de preço.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na página [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), na guia **Produtos de SaaS**, selecione o produto que você deseja modificar.
1. Na lista suspensa **Solicitar alterações**, selecione **Atualizar ofertas públicas** e, em seguida, selecione **Atualizar termos de preço**.
1. Os preços atuais são pré-preenchidos nos campos. Você pode excluir o preço atual e, em seguida, inserir o novo preço.
1. Escolha **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á atualizado para **Bem-sucedido** ou **Falha**.
## Adicionar dimensões de preço
Você pode adicionar uma dimensão que deseja usar para cobrar do produto. Uma dimensão é a unidade de medida fundamental pela qual seu comprador é cobrado ao usar seu produto.
**nota**
Para atualizar o nome ou a descrição de uma dimensão de preço existente, consulte [Atualizar dimensões de preços](#saas-update-dimension).
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na guia [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), selecione o produto que você deseja modificar.
1. Na lista suspensa **Solicitar alterações**, selecione **Atualizar dimensões de preços** e, em seguida, **Adicionar dimensões de preços**.
1. Forneça um identificador de API de dimensão, nome de exibição e descrição para adicionar uma nova dimensão ao produto e, em seguida, escolha **Avançar**.
**nota**
O identificador e o nome da API devem ser exclusivos em todas as dimensões. Não é possível alterar o identificador e a unidade da API depois que a dimensão é criada.
1. Defina os preços para cada dimensão que você adicionou e escolha **Avançar** para revisar suas alterações.
**nota**
Você só pode adicionar dimensões ao modelo de preços selecionado para seu produto (por exemplo, contrato, uso, contrato com consumo ou Gratuito). Para produtos limitados que usam modelos de preços não gratuitos, os preços das dimensões recém-adicionadas estão definidos em 0,01 USD. Para produtos que usam o modelo de preço gratuito, as dimensões recém-adicionadas devem ser definidas como 0,00 USD. Para modelos de preços não gratuitos, você pode atualizar os preços quando o produto estiver pronto para visibilidade pública. Se todas as dimensões estiverem definidas como 0,00 USD, o produto será automaticamente convertido para o modelo de preço gratuito.
1. Escolha **Enviar** para enviar sua solicitação de revisão.
1. Na guia **Solicitações**, verifique se o status da solicitação está **Em análise**. Quando a solicitação for concluída, o status mudará para **Bem-sucedido**.
## Atualizar dimensões de preços
Você pode atualizar uma dimensão que deseja usar para cobrar do produto. Uma dimensão é a unidade de medida fundamental pela qual seu comprador é cobrado ao usar seu produto.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na guia [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Atualizar dimensões de preços** e, em seguida, **Atualizar informações da dimensão**.
1. Encontre a dimensão que você deseja atualizar e, em seguida, escolha o nome ou a descrição.
1. Forneça o novo nome ou descrição e, em seguida, escolha a **marca de seleção** para confirmar sua atualização. O nome da dimensão deve ser exclusivo.
1. Escolha **Enviar** para enviar sua solicitação de revisão.
1. Na guia **Solicitações**, verifique se o status da solicitação está **Em análise**. Quando a solicitação for concluída, o status mudará para **Bem-sucedido**.
## Restringir dimensões de preços
Você pode restringir uma dimensão atualmente listada no produto. Essa solicitação remove a dimensão selecionada do produto.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na guia [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), selecione o produto que você deseja modificar.
1. Na lista suspensa **Solicitar alterações**, selecione **Atualizar dimensões de preços** e, em seguida, **Restringir dimensões de preços**.
1. Para produtos públicos e limitados, você deverá entrar em contato com a equipe de operações do vendedor do AWS Marketplace usando o botão **[Fale conosco](https://aws.amazon.com/marketplace/management/contact-us/)**. Usando o formulário, forneça detalhes das dimensões que você deseja remover da lista de produtos.
**nota**
As operações podem nem sempre ser capazes de restringir dimensões da definição de preço.
## Determine como os compradores acessarão seu produto
Você pode escolher uma das seguintes opções de como os clientes podem acessar seu produto:
+ [Atualizar a opção de execução de URL de SaaS](#update-fulfillment-options): os clientes usam um URL para o site para o qual são redirecionados depois de assinarem seu produto no AWS Marketplace.
+ [Configurar o início rápido](#saas-quick-launch): os clientes usam um processo simplificado para configurar e lançar seu produto. Você pode concluir essa configuração para produtos existentes com visibilidade limitada ou pública.
### Atualizar a opção de execução de URL de SaaS
Para atualizar o URL usado para atender seu produto SaaS, use a guia **Atualizar opções de execução**.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na página [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), na guia **Produtos de SaaS**, escolha o produto que você deseja modificar.
1. Na lista suspensa **Solicitar alterações**, escolha **Atualizar opções de preenchimento** e **Editar URL de execução padrão**.
1. No campo **URL de execução**, insira o novo URL para a opção de execução do produto de SaaS.
1. Escolha **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á atualizado para **Bem-sucedido** ou **Falha**.
## Configurar o início rápido
Os produtos SaaS listados AWS Marketplace geralmente exigem que AWS os recursos sejam implantados na conta do comprador assinante (por exemplo, funções do IAM). O Quick Launch permite que você forneça orientação, step-by-step instruções e implantação de recursos a seus compradores usando CloudFormation modelos. Os compradores usam os CloudFormation modelos para configurar e lançar produtos. Para saber mais sobre o processo de configuração de execução rápida, consulte o laboratório [Habilitar a execução rápida do SaaS](https://catalog.workshops.aws/mpseller/en-US/saas/quick-launch-integration).
Para configurar uma experiência de início rápido que os clientes podem usar para lançar seu produto SaaS, use a guia **Opções de execução**.
1. Na página [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), na guia **Produtos de SaaS**, selecione o produto que você deseja modificar.
**nota**
Para configurar a experiência de início rápido, o produto deve ter visibilidade limitada ou pública.
1. Na página de detalhes do produto, escolha a guia **Opções de execução**.
1. Para **Início rápido**, escolha o botão **Ativar e configurar**.
1. Para obter **detalhes de logon da conta**, forneça uma URL para seu site na qual o comprador possa fazer logon ou criar uma conta. Esse URL abre uma nova guia na experiência do comprador. Os compradores então fazem login ou criam uma conta e retornam AWS Marketplace para lançar o modelo.
1. Crie um CloudFormation modelo.
**dica**
Siga o AWS Well-Architected Framework ao criar AWS CloudFormation seu modelo que implanta recursos na conta do comprador. AWS Para obter mais informações e recursos, [AWS Well-Architected](https://aws.amazon.com/architecture/well-architected/) e leia o [AWS Well-Architected Framework](https://docs.aws.amazon.com/wellarchitected/latest/framework/welcome.html).
Para **modelo do CloudFormation **, escolha o botão **Adicionar modelo do CloudFormation ** e forneça as seguintes informações:
+ **Título** — Forneça o nome da sua CloudFormation implantação.
+ **Descrição**: forneça uma descrição do modelo.
+ **Nome da pilha**: forneça um nome para a pilha. Esse nome é o nome da pilha do comprador. CloudFormation
+ **CloudFormation URL do modelo** — Forneça que o Amazon Simple Storage Service revise esse modelo.
**nota**
Para simplificar o processo de lançamento para seus clientes, sugerimos minimizar o número de modelos associados ao seu processo de configuração. Idealmente, você deseja um modelo que implemente os recursos necessários para usar o produto. Para perguntas relacionadas ao seu CloudFormation modelo, entre em contato com seu parceiro AWS Marketplace de desenvolvimento de negócios ou com a equipe de [operações do AWS Marketplace vendedor](https://aws.amazon.com/marketplace/management/contact-us/).
+ **Permissões necessárias do IAM** — forneça as permissões necessárias para implantar o CloudFormation modelo. Se você quiser compartilhar parâmetros de implantação, que são armazenados como segredos no [AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) para o comprador, sua política deverá incluir as seguintes ações:
+ `secretsManager:ListSecrets`
+ `secretsManager:DescribeSecret`
+ `secretsManager:ReplicateSecretToRegions`
+ `secretsManager:GetSecretValue`
**nota**
Se seu produto exigir parâmetros de CloudFormation implantação fornecidos pelo vendedor (por exemplo, chaves de API e [externas IDs](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html)), use a `PutDeploymentParameter` operação para compartilhar o parâmetro com seus clientes. Para obter mais informações, consulte [https://docs.aws.amazon.com/marketplace-deployment/latest/api-reference/API_PutDeploymentParameter.html](https://docs.aws.amazon.com/marketplace-deployment/latest/api-reference/API_PutDeploymentParameter.html) na *Referência de API do serviço de implantação do AWS Marketplace *.
1. (Opcional) Para obter **instruções de configuração manual**, forneça instruções para compradores que desejam configurar seu produto manualmente. Considere incluir links para o guia de integração e documentação do seu produto.
1. Para **obter detalhes do lançamento**, forneça a URL na qual os compradores acessarão o produto após a implantação da CloudFormation pilha.
1. (Opcional) Para **contas permitidas para o Início Rápido**, forneça uma lista separada por vírgulas Contas da AWS que possam visualizar a experiência do Início Rápido com visibilidade limitada.
1. Clique no botão **Salvar**. A experiência de início rápido terá visibilidade limitada, o que significa que só estará visível para sua conta e contas na lista de permissões. Com visibilidade limitada, você pode testar sua configuração usando a página **Configurar e lançar** depois de assinar seu produto e escolher o botão **Configurar sua conta**.
+ Para visualizar a página do ponto de vista do comprador, escolha **Visualizar**. As alterações de configuração serão refletidas na visualização enquanto as duas páginas estiverem abertas.
1. Quando estiver pronto, você poderá publicar a experiência de início rápido no catálogo do AWS Marketplace . Use o botão **Atualizar visibilidade do início rápido** na guia **Opções de execução** na página de detalhes do produto.
Quando você altera a visibilidade para Pública, a equipe de operações do AWS Marketplace vendedor revisa a configuração, realiza testes com compradores e publica a experiência.
**nota**
Se precisar de suporte ao ativar a experiência de início rápido, entre em contato com a equipe de [operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/).
## Atualizar disponibilidade por país
Você pode definir os países nos quais seu produto pode ser oferecido.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na guia [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, selecione **Atualizar oferta pública** e escolha **Atualizar disponibilidade por país**.
1. Escolha uma das seguintes opções:
+ Todos os países: disponível em todos os países com suporte.
+ Todos os países com exclusões: disponível em todos os países com suporte, exceto em países selecionados.
+ Somente países permitidos: lista específica de países onde o produto está disponível.
1. Escolha **Enviar** para enviar sua solicitação de revisão.
1. Na guia **Solicitações**, verifique se o status da solicitação está **Em análise**. Quando a solicitação for concluída, o status mudará para **Bem-sucedido**.
## Atualizar a política de reembolso de um produto
Você pode atualizar a política de reembolso do seu produto usando **Atualizar política de reembolso**.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na página [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), na guia **Produtos de SaaS**, selecione o produto que você deseja modificar.
1. Na lista suspensa **Solicitar alterações**, selecione **Atualizar oferta pública** e, em seguida, selecione **Atualizar política de reembolso**.
1. Os detalhes da política de reembolso atual são fornecidos na caixa de texto. Revise e modifique os detalhes conforme desejar. O envio da solicitação substitui a política de reembolso atual.
1. Escolha **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á atualizado para **Bem-sucedido** ou **Falha**.
## Atualizar o contrato de licença de usuário final (EULA)
Você pode atualizar seu EULA para novos usuários que assinam seu produto.
1. Abra o [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management) e faça login na conta de vendedor.
1. Na guia [Produtos de SaaS](https://aws.amazon.com/marketplace/management/products/saas), selecione o produto que você deseja modificar.
1. No menu suspenso **Solicitar alterações**, escolha **Atualizar oferta pública** e, em seguida, **Atualizar EULA**.
1. Você pode escolher o [Contrato Padrão para AWS Marketplace (SCMP)](https://docs.aws.amazon.com/marketplace/latest/userguide/standardized-license-terms.html) ou enviar um EULA personalizado. Para um EULA personalizado, você deve fornecer uma URL Amazon Simple Storage Service (Amazon S3) para o contrato. O bucket do Amazon S3 deve ser acessível ao público.
1. Escolha **Enviar** para enviar sua solicitação de revisão.
1. Na guia **Solicitações**, verifique se o status da solicitação está **Em análise**. Quando a solicitação for concluída, o status mudará para **Bem-sucedido**.
# Integrando sua assinatura Pay-As-You-Go ou produto SaaS com AWS Marketplace
**Requisitos de integração alterados em 1º de junho de 2026 para novos produtos SaaS**
O AWS Marketplace está introduzindo o suporte para acordos simultâneos, permitindo várias compras do mesmo produto em uma única conta da AWS durante o mesmo período do contrato. A partir de 1º de junho de 2026, todos os novos produtos SaaS serão necessários para oferecer suporte aos requisitos de integração atualizados. [Analise a nova integração para acordos simultâneos](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements).
Integrar seu produto com AWS Marketplace é um passo à frente[Criando um produto SaaS em AWS Marketplace](saas-create-product.md). Para integrar seu produto de assinatura de software como serviço (SaaS) AWS Marketplace, você deve escrever um código e demonstrar que ele pode responder com êxito a vários cenários de clientes. As seções a seguir mostram como integrar seu modelo de assinatura SaaS com o. AWS Marketplace
**Importante**
Este guia é para produtos SaaS *Pay-As-You-Go (PAYG)*. Se você estiver implementando um produto de SaaS *com base em contrato*, use [Integrando seu produto baseado em contratos SaaS com AWS Marketplace](saas-integrate-contract-with-pay.md) em vez disso. Os produtos PAYG não usam tópicos de SNS de direitos nem a API. GetEntitlements
**nota**
Antes de começar, certifique-se de ter escolhido o modelo de preços certo para seu produto software-as-a-service (SaaS) em. AWS Marketplace Para obter mais informações, consulte [Planejar seu produto de SaaS](saas-prepare.md).
**Topics**
+ [Cenário: seu serviço valida novos clientes](#saas-subscription-validate-customer)
+ [Cenário: uso do medidor](#saas-subscription-meter-usage)
+ [Cenário: monitorar as alterações nas assinaturas dos usuários](#saas-subscription-monitor-changes)
+ [Cenário: verificar a assinatura do cliente](#saas-subscription-verify-subscriptions)
+ [Teste da integração de produtos de assinatura de SaaS](#saas-subscription-integration-testing)
## Cenário: seu serviço valida novos clientes
Quando um cliente assina seu produto, ele é redirecionado para o URL de registro, que é uma solicitação HTTP POST com um token `x-amzn-marketplace-token` temporário. Responda a essa solicitação das seguintes maneiras:
1. Troque o token por um `CustomerIdentifier``CustomerAWSAccountId`,`LicenseArn`,, e `ProductCode` chamando a operação da `[ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API no AWS Marketplace Metering Service.
1. Mantenha o`CustomerIdentifier`,, `CustomerAWSAccountId``LicenseArn`, e `ProductCode` em seu sistema para futuras chamadas. Você deve armazenar se o cliente tem uma assinatura válida, junto com as informações de que você precisa sobre o cliente.
1. Como resposta à solicitação, você deve mostrar a primeira experiência de uso do usuário (conforme aplicável ao seu serviço).
## Cenário: uso do medidor
Quando o cliente começar a usar seu serviço, você deverá enviar registros de medição de hora em hora. Para obter detalhes sobre como medir, consulte [Configurar a medição para uso com assinaturas SaaS](metering-for-usage.md).
Recomendamos que você use AWS CloudTrail para monitorar a atividade para garantir que as informações de cobrança sejam enviadas para AWS. Tenha em mente o seguinte ao enviar registros de medição:
+ A duplicação de solicitações de medição são eliminadas em uma hora.
+ Os registros enviados a cada hora são cumulativos.
+ Como prática recomendada, mesmo que não haja registros na última hora, recomendamos que você envie registros de medição a cada hora, com uso 0.
## Cenário: monitorar as alterações nas assinaturas dos usuários
Configure uma fila do Amazon Simple Queue Service (Amazon SQS) e assine o tópico do Amazon SNS do seu produto. As informações do tópico do SNS foram incluídas na mensagem de e-mail que você recebeu da equipe de operações do AWS Marketplace vendedor quando criou seu produto. Para obter mais informações, consulte [Criando um produto SaaS em AWS Marketplace](saas-create-product.md). Ao assinar o tópico do SNS, você recebe notificações sobre alterações nas assinaturas de clientes, incluindo o fornecimento ou a revogação do acesso de clientes específicos.
**nota**
Um nome do recurso da Amazon (ARN) do tópico do SNS é semelhante a `arn:aws:sns:us-east-1::aws-mp-subscription-notification-`.
As notificações às quais você deve responder são:
+ `subscribe-success`: o cliente está inscrito e você pode medir com sucesso o ID do cliente.
+ `unsubscribe-pending`: o cliente está cancelando a assinatura. Você deve enviar todos os últimos registros de medição.
+ `unsubscribe-success`: o cliente cancelou a assinatura. Os registros de medição do cliente não serão mais aceitos. Siga suas práticas para fechar os recursos do cliente, aderindo às suas políticas de retenção.
+ `subscribe-fail`: a assinatura do cliente falhou. Você não deve comparar o ID do cliente nem criar recursos em nome do cliente.
## Cenário: verificar a assinatura do cliente
Antes de criar recursos em nome do cliente, verifique se o cliente deve ter acesso ao seu produto. Armazene o status mais recente do cliente a partir das notificações que você recebe via Amazon SQS para saber se o cliente tem acesso.
## Teste da integração de produtos de assinatura de SaaS
Depois de integrar seu produto de assinatura SaaS AWS Marketplace, você deve realizar testes detalhados para garantir que a integração seja bem-sucedida. O procedimento a seguir descreve as etapas para verificar a integração do produto.
**nota**
Use suas próprias contas para assinar o produto e testar se a integração foi bem-sucedida. Os preços podem ser temporariamente reduzidos para permitir que você teste o fluxo de compra sem incorrer em altas taxas nessas contas. Para obter mais informações sobre como reduzir temporariamente os preços ou permitir que contas de teste adicionais acessem seu produto, entre em contato com a equipe de [operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/).
Depois que seu produto for lançado, o serviço deve continuar respondendo a esses cenários para novos clientes.
1. Use uma conta permitida para testar a experiência do cliente assinando seu produto.
1. Depois de se inscrever com a conta permitida, verifique se a conta é redirecionada para o URL de registro e se o redirecionamento é uma solicitação POST que inclui um token temporário. Verifique se o aplicativo mantém o ID do cliente para futuras chamadas. Isso testa parte do [Cenário: seu serviço valida novos clientes](#saas-subscription-validate-customer).
1. Depois de verificar a conta de teste na etapa anterior, incorpore a conta em seu aplicativo. Por exemplo, você pode fazer com que o cliente de teste preencha um formulário para criar um novo usuário. Ou forneça outras próximas etapas para obter acesso ao seu aplicativo SaaS. Isso testa parte do [Cenário: seu serviço valida novos clientes](#saas-subscription-validate-customer).
1. Depois que o cliente de teste estiver integrado, faça solicitações que enviarão registros de medição AWS para fins de cobrança usando a operação de `BatchMeterUsage` API no. AWS Marketplace Metering Service Isso testa [Cenário: uso do medidor](#saas-subscription-meter-usage).
1. Teste as alterações na assinatura. Os cenários possíveis incluem cancelamentos de inscrições, assinaturas bem-sucedidas e assinaturas com falha. Isso testa [Cenário: monitorar as alterações nas assinaturas dos usuários](#saas-subscription-monitor-changes).
1. Verifique uma assinatura bem-sucedida. Depois de receber uma notificação do Amazon SNS para sua conta de teste com uma mensagem de assinatura bem-sucedida, a medição pode começar. Os registros enviados para o AWS Marketplace Metering Service antes de você receber a notificação do Amazon SNS não são medidos. Isso testa [Cenário: verificar a assinatura do cliente](#saas-subscription-verify-subscriptions).
**nota**
Para evitar problemas de faturamento, recomendamos que aguarde programaticamente esta notificação antes de iniciar recursos em nome de seus clientes.
1. Depois de concluir todos os requisitos de integração e testar a solução, notifique a equipe de operações do AWS Marketplace vendedor. Eles executarão uma série de testes finais na solução, verificando se você enviou com êxito os registros medidos com a operação de API `BatchMeterUsage`.
Depois que a integração e o teste estiverem concluídos, você poderá realizar uma análise final e publicar seu produto no público AWS Marketplace. Para obter mais informações, consulte [Criando um produto SaaS em AWS Marketplace](saas-create-product.md).
# Integrando seu produto de contrato SaaS com AWS Marketplace
**Requisitos de integração alterados em 1º de junho de 2026 para novos produtos SaaS**
O AWS Marketplace está introduzindo o suporte para acordos simultâneos, permitindo várias compras do mesmo produto em uma única conta da AWS durante o mesmo período do contrato. A partir de 1º de junho de 2026, todos os novos produtos SaaS serão necessários para oferecer suporte aos requisitos de integração atualizados. [Analise a nova integração para acordos simultâneos](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements).
Integrar seu produto contratual de software como serviço (SaaS) é AWS Marketplace uma etapa. [Criando um produto SaaS em AWS Marketplace](saas-create-product.md) Para integrar seu produto contratual de software como serviço (SaaS) AWS Marketplace, você deve escrever um código e demonstrar que ele pode responder com êxito a vários cenários de clientes. As seções a seguir descrevem esses cenários, explicam como responder a eles e fornecem uma visão geral sobre como testar sua integração.
**nota**
Antes de começar, certifique-se de ter escolhido o modelo de definição de preço certo para o seu produto de software como serviço (SaaS) no AWS Marketplace. Para obter mais informações, consulte [Planejar seu produto de SaaS](saas-prepare.md).
**Topics**
+ [Cenário: seu serviço valida novos clientes](#saas-contract-validate-customer)
+ [Cenário: seu serviço lida com as solicitações dos clientes](#saas-contract-customer-requests)
+ [Cenário: monitorar as alterações nas assinaturas dos usuários](#saas-contract-monitor-changes)
+ [Teste da integração de produtos contratuais de SaaS](#saas-contract-integration-testing)
## Cenário: seu serviço valida novos clientes
Quando um cliente assina seu produto, ele é redirecionado para o URL de registro, que é uma solicitação HTTP POST com um token `x-amzn-marketplace-token` temporário. Responda a essa solicitação das seguintes maneiras:
1. Troque o token por um `CustomerIdentifier``CustomerAWSAccountId`,`LicenseArn`,, e `ProductCode` chamando a operação da `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API no AWS Marketplace Metering Service**.
1. Verifique a assinatura e a quantidade (se aplicável) à qual o cliente tem acesso chamando a operação de API `[ GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)` no AWS Marketplace Entitlement Service.
1. Mantenha o`CustomerIdentifier`,, `CustomerAWSAccountId``LicenseArn`, e `ProductCode` em seu sistema para futuras chamadas. Armazene se o cliente tem uma assinatura válida, junto com as informações de que você precisa sobre o cliente.
1. Como resposta à solicitação, você deve mostrar a primeira experiência de uso do usuário (conforme aplicável ao seu serviço).
## Cenário: seu serviço lida com as solicitações dos clientes
Quando um cliente faz uma solicitação ao seu serviço, você deve responder aos seguintes cenários com ações ou mensagens apropriadas:
+ Eles não têm um ID de cliente em seu sistema. Isso significa que eles ainda não se inscreveram. Você deve dizer ao usuário como se inscrever.
+ Eles têm um ID de cliente e a operação de API `GetEntitlements` retorna um direito apropriado. Nesse cenário, você deve atender à solicitação.
+ Eles têm um ID de cliente, mas a operação de API `GetEntitlements` não retorna nenhum direito ou quantidade insuficiente para atender à solicitação. Nesse cenário, você deve determinar como lidar com o acesso e gerenciar a experiência deles.
## Cenário: monitorar as alterações nas assinaturas dos usuários
**Importante**
As notificações do SNS para produtos AWS Marketplace SaaS estão sendo substituídas pelas notificações da Amazon EventBridge . Se você já tiver produtos SaaS integrados ao SNS, eles continuarão funcionando. Eventualmente, os novos anúncios passarão a usar a Amazon EventBridge em vez do SNS. Para obter mais informações, consulte [Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge](saas-eventbridge-integration.md).
Configure uma fila do Amazon Simple Queue Service (Amazon SQS) como destino para que suas regras da EventBridge Amazon recebam eventos sobre alterações nos direitos dos clientes. Sua configuração de EventBridge eventos da Amazon foi fornecida quando você criou seu produto. Para obter mais informações, consulte [Criando um produto SaaS em AWS Marketplace](saas-create-product.md). Ao configurar EventBridge as regras da Amazon, você recebe eventos sobre mudanças nos direitos dos clientes, incluindo o fornecimento ou a revogação do acesso de clientes específicos.
A única notificação à qual você deve responder é:
+ EventBridge Eventos da Amazon atualizados com a licença — O direito do cliente mudou e você deve chamar a operação da `GetEntitlements` API para ver o novo status. Atualize sua loja de clientes e, se aplicável (por exemplo, o contrato do cliente expirou), siga suas práticas para fechar os recursos do cliente, aderindo às suas políticas de retenção.
**nota**
Para obter informações adicionais, consulte [Verificando direitos usando o AWS Marketplace Entitlement Service](checking-entitlements.md).
## Teste da integração de produtos contratuais de SaaS
Depois de integrar seu produto de contrato SaaS com AWS Marketplace, você deve realizar testes detalhados para garantir que a integração seja bem-sucedida. O procedimento a seguir descreve as etapas para verificar a integração do produto.
**nota**
Use suas próprias contas para assinar o produto e testar se a integração foi bem-sucedida. Os preços podem ser temporariamente reduzidos para permitir que você teste o fluxo de compra sem incorrer em altas taxas nessas contas. Para obter mais informações sobre como reduzir temporariamente os preços ou permitir que contas de teste adicionais acessem seu produto, [entre em contato](https://aws.amazon.com/marketplace/management/contact-us/).
Depois que seu produto for lançado, o serviço deve continuar respondendo a esses cenários para novos clientes.
1. Use uma conta permitida para testar a experiência do cliente obtendo um contrato para seu produto.
1. Depois que a conta tiver o contrato, verifique se a conta é redirecionada para o URL de registro e se o redirecionamento é uma solicitação POST que inclui um token temporário. Certifique-se de que seu aplicativo mantenha o ID do cliente para futuras chamadas e gerencie corretamente os direitos que o cliente tem. Isso testa parte do [Cenário: seu serviço valida novos clientes](#saas-contract-validate-customer).
1. Depois de verificar a conta de teste na etapa anterior, incorpore a conta em seu aplicativo. Por exemplo, você pode fazer com que o cliente de teste preencha um formulário para criar um novo usuário. Ou forneça outras próximas etapas para obter acesso ao seu aplicativo SaaS. Isso testa parte do [Cenário: seu serviço valida novos clientes](#saas-contract-validate-customer).
1. Se nenhum direito for retornado da operação de API `GetEntitlements`, seja durante a integração ou nas execuções de verificação contínua, seu aplicativo deverá gerenciar corretamente o acesso e a experiência dos usuários que não têm direito. Isso testa [Cenário: seu serviço lida com as solicitações dos clientes](#saas-contract-customer-requests).
1. Teste as alterações na assinatura. Verifique se seu aplicativo lida corretamente com cancelamentos de assinaturas, assinaturas bem-sucedidas e cenários de falha na assinatura. Isso testa [Cenário: monitorar as alterações nas assinaturas dos usuários](#saas-contract-monitor-changes).
1. Depois de concluir todos os requisitos de integração e testar a solução, notifique a equipe de AWS Marketplace operações. Eles testarão a solução verificando se você chamou a operação de API `GetEntitlements` com sucesso e incorporou suficientemente novos clientes.
Depois que a integração e o teste estiverem concluídos, você poderá realizar uma análise final e publicar seu produto no público AWS Marketplace. Para obter mais informações, consulte [Criando um produto SaaS em AWS Marketplace](saas-create-product.md). Você também pode cancelar a assinatura de teste preenchendo um Formulário de solicitação de reembolso. Para obter mais informações sobre o cancelamento de uma assinatura, consulte o [Solicitando um ajuste de cobrança (reembolso)](refunds.md#refund-process).
# Integrando seu produto baseado em contratos SaaS com AWS Marketplace
**Requisitos de integração alterados em 1º de junho de 2026 para novos produtos SaaS**
O AWS Marketplace está introduzindo o suporte para acordos simultâneos, permitindo várias compras do mesmo produto em uma única conta da AWS durante o mesmo período do contrato. A partir de 1º de junho de 2026, todos os novos produtos SaaS serão necessários para oferecer suporte aos requisitos de integração atualizados. [Analise a nova integração para acordos simultâneos](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements).
Integrar seu produto com AWS Marketplace é um passo à frente[Criando um produto SaaS em AWS Marketplace](saas-create-product.md). Para integrar seu produto contratual de software como serviço (SaaS) AWS Marketplace, você deve escrever um código e demonstrar que ele pode responder com êxito a vários cenários de clientes. As seções a seguir descrevem esses cenários, explicam como responder a eles e fornecem uma visão geral sobre como testar sua integração.
**nota**
Este guia só é para produtos de SaaS *com base em contrato*. Se você estiver implementando um produto SaaS *Pay-As-You-Go (PAYG)*, use em vez disso[Integrando sua assinatura Pay-As-You-Go ou produto SaaS com AWS Marketplace](saas-integrate-subscription.md). Os produtos PAYG não usam tópicos de SNS de direitos nem a API. GetEntitlements
Antes de começar, certifique-se de ter escolhido o modelo de definição de preço certo para o seu produto de software como serviço (SaaS) no AWS Marketplace. Para obter mais informações, consulte [Planejar seu produto de SaaS](saas-prepare.md).
**Topics**
+ [Cenário: seu serviço valida novos clientes](#saas-contract-with-pay-validate-customer)
+ [Cenário: seu serviço lida com as solicitações dos clientes](#saas-contract-with-pay-customer-requests)
+ [Cenário: uso do medidor](#saas-contract-with-pay-meter-usage)
+ [Cenário: monitorar as alterações nos direitos do usuário](#saas-contract-with-pay-monitor-changes)
+ [Testando seu contrato de SaaS com integração pay-as-you-go](#saas-contract-consumption-integration-testing)
## Cenário: seu serviço valida novos clientes
Quando um cliente assina seu produto, ele é redirecionado para o URL de registro, que é uma solicitação HTTP POST com um token `x-amzn-marketplace-token` temporário. Responda a essa solicitação das seguintes maneiras:
1. Troque o token por um `CustomerIdentifier``CustomerAWSAccountId`,`LicenseArn`,, e `ProductCode` chamando a operação da `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API no AWS Marketplace Metering Service.
1. Verifique a assinatura e a quantidade (se aplicável) à qual o cliente tem acesso chamando a ação `[ GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)` no AWS Marketplace Entitlement Service.
1. Mantenha o`CustomerIdentifier`,, `CustomerAWSAccountId``LicenseArn`, e `ProductCode` em seu sistema para futuras chamadas. Armazene se o cliente tem uma assinatura válida, junto com as informações de que você precisa sobre o cliente.
1. Como resposta à solicitação, você deve mostrar a primeira experiência de uso do usuário (conforme aplicável ao seu serviço).
## Cenário: seu serviço lida com as solicitações dos clientes
Quando um cliente faz uma solicitação ao seu serviço, você deve responder aos seguintes cenários com ações ou mensagens apropriadas:
+ Eles não têm um ID de cliente em seu sistema. Isso significa que eles ainda não se inscreveram. Você deve enviar a eles uma mensagem descrevendo como assinar.
+ Eles têm um ID de cliente e a operação de API `GetEntitlements` retorna um direito apropriado. Nesse cenário, você deve atender à solicitação.
+ Eles têm um ID de cliente, mas a operação de API `GetEntitlements` não retorna nenhum direito ou quantidade insuficiente para atender à solicitação. Nesse cenário, você deve determinar como lidar com o acesso e gerenciar a experiência deles.
## Cenário: uso do medidor
Quando o cliente começar a usar seu serviço, você deverá enviar registros de medição de hora em hora. Para obter detalhes sobre como medir, consulte [Configurar a medição para uso com assinaturas SaaS](metering-for-usage.md).
Recomendamos que você use AWS CloudTrail para monitorar a atividade para garantir que as informações de cobrança sejam enviadas para AWS. Tenha em mente o seguinte ao enviar registros de medição:
+ A duplicação de solicitações de medição são eliminadas em uma hora.
+ Os registros enviados a cada hora são cumulativos.
+ Como prática recomendada, mesmo que não haja registros na última hora, recomendamos que você envie registros de medição a cada hora, com uso 0.
## Cenário: monitorar as alterações nos direitos do usuário
Configure uma fila do Amazon Simple Queue Service (Amazon SQS) e assine os tópicos do Amazon SNS do seu produto. Há dois tópicos do SNS, um para alterações de direitos e outro para alterações de assinatura. As informações do seu tópico foram incluídas na mensagem de e-mail que você recebeu da equipe de operações do AWS Marketplace vendedor quando criou seu produto. Para obter mais informações, consulte [Criando um produto SaaS em AWS Marketplace](saas-create-product.md). Ao assinar os tópicos do SNS, você recebe notificações sobre alterações nas assinaturas de clientes, incluindo o fornecimento ou a revogação do acesso de clientes específicos.
**nota**
O nome do recurso da Amazon (ARN) de um tópico do SNS de uma alteração de assinatura é semelhante a `arn:aws:sns:us-east-1::aws-mp-subscription-notification-`. O ARN de um tópico do SNS para alterações de autorização é semelhante a `arn:aws:sns:us-east-1::aws-mp-entitlement-notification-`.
As notificações às quais você deve responder são as seguintes:
+ `entitlement-updated` (no tópico do SNS de autorização): o direito do cliente foi alterado e você deve chamar a operação de API `GetEntitlements` para ver o novo status. Atualize sua loja de clientes e, se aplicável (por exemplo, o contrato do cliente expirou), siga suas práticas para fechar os recursos do cliente, aderindo às suas políticas de retenção.
+ `subscribe-success` (no tópico do SNS de assinatura): o cliente está inscrito e você pode medir com sucesso o ID do cliente.
+ `unsubscribe-pending` (no tópico de assinatura do SNS): o cliente está cancelando a assinatura. Você deve enviar todos os últimos registros de medição.
+ `unsubscribe-success` (no tópico de assinatura do SNS): o cliente cancelou a assinatura. Os registros de medição do cliente não serão mais aceitos. Siga suas práticas para fechar os recursos do cliente, aderindo às suas políticas de retenção.
+ `subscribe-fail` (no tópico de assinatura do SNS): a assinatura do cliente falhou. Você não deve comparar o ID do cliente nem ativar recursos em nome do cliente.
**nota**
Para obter informações adicionais, consulte [Verificando direitos usando o AWS Marketplace Entitlement Service](checking-entitlements.md).
## Testando seu contrato de SaaS com integração pay-as-you-go
Depois de integrar seu contrato ao pay-as-you-go produto com AWS Marketplace, você deve realizar testes detalhados para garantir que a integração seja bem-sucedida. O procedimento a seguir descreve as etapas para verificar a integração do produto.
**nota**
Use suas próprias contas para assinar o produto e testar se a integração foi bem-sucedida. Os preços podem ser temporariamente reduzidos para permitir que você teste o fluxo de compra sem incorrer em altas taxas nessas contas. Para obter mais informações sobre como reduzir temporariamente os preços ou permitir que contas de teste adicionais acessem seu produto, entre em contato com a equipe de [operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/).
Depois que seu produto for lançado, o serviço deve continuar respondendo a esses cenários para novos clientes.
1. Use uma conta permitida para testar a experiência do cliente obtendo um contrato para seu produto.
1. Depois que a conta tiver o contrato, verifique se a conta é redirecionada para o URL de registro e se o redirecionamento é uma solicitação POST que inclui um token temporário. Certifique-se de que seu aplicativo mantenha o ID do cliente para futuras chamadas e gerencie corretamente os direitos que o cliente tem. Isso testa parte do [Cenário: seu serviço valida novos clientes](#saas-contract-with-pay-validate-customer).
1. Depois de verificar a conta de teste na etapa anterior, incorpore a conta em seu aplicativo. Por exemplo, você pode fazer com que o cliente de teste preencha um formulário para criar um novo usuário. Ou forneça outras próximas etapas para obter acesso ao seu aplicativo SaaS. Isso testa parte do [Cenário: seu serviço valida novos clientes](#saas-contract-with-pay-validate-customer).
1. Se nenhum direito for retornado da operação de API `GetEntitlements`, seja durante a integração ou nas execuções de verificação contínua, seu aplicativo deverá gerenciar corretamente o acesso e a experiência dos usuários que não têm direito. Isso testa [Cenário: seu serviço lida com as solicitações dos clientes](#saas-contract-with-pay-customer-requests).
1. Depois que o cliente de teste estiver integrado, faça solicitações que enviarão registros de medição AWS para fins de cobrança usando a operação de `BatchMeterUsage` API no. AWS Marketplace Metering Service Isso testa [Cenário: uso do medidor](#saas-contract-with-pay-meter-usage).
1. Teste as alterações na assinatura. Verifique se seu aplicativo lida corretamente com cancelamentos de assinaturas, assinaturas bem-sucedidas e cenários de falha na assinatura. Isso testa [Cenário: monitorar as alterações nos direitos do usuário](#saas-contract-with-pay-monitor-changes).
1. Depois de concluir todos os requisitos de integração e testar a solução, notifique a equipe de operações do AWS Marketplace vendedor. Eles testarão a solução verificando se você chamou a operação de API `GetEntitlements` com sucesso e incorporou suficientemente novos clientes. Eles também verificarão se você enviou com sucesso os registros medidos via operação de API `BatchMeterUsage`.
Depois que a integração e o teste estiverem concluídos, você poderá realizar uma análise final e publicar seu produto no público AWS Marketplace. Para obter mais informações, consulte [Criando um produto SaaS em AWS Marketplace](saas-create-product.md).
# Implantação de uma integração de SaaS de tecnologia sem servidor
Quando tem uma solução de SaaS que deseja integrar ao AWS Marketplace, você pode usar abordagens arquitetônicas variadas para a integração.
Para ajudar você a compreender os conceitos de integração de SaaS, a AWS oferece um laboratório de referência que demonstra uma abordagem usando a arquitetura de tecnologia sem servidor.
Acesse o laboratório de referência: [Integrar o SaaS com a referência de integração de SaaS de tecnologia sem servidor](https://aws.amazon.com/quickstart/architecture/aws-marketplace-saas/)
**nota**
Essa implementação de referência é oferecida somente para fins de aprendizado e demonstração. Ela não está pronta para produção e não deve ser usada como está em ambientes de produção. Antes de implementar uma solução semelhante em produção, não se esqueça de atender aos requisitos de segurança, escalabilidade, monitoramento e conformidade específicos do seu caso de uso.
# Planejar seu produto de SaaS
Antes de adicionar seu produto de software como serviço (SaaS) AWS Marketplace, você deve primeiro fazer um planejamento. Esta etapa é fundamental para o sucesso do seu produto. A falta de planejamento pode resultar em problemas de cobrança ou talvez você precise recriar seu produto no AWS Marketplace. As seções a seguir mostram como planejar um produto SaaS,
**Importante**
A maioria das configurações do seu produto não pode ser alterada depois de terem sido configuradas. Se você precisar alterá-los após a criação do produto AWS Marketplace, provavelmente precisará criar um novo produto com as configurações corretas.
**Topics**
+ [Planejamento da definição de preço](#plan-pricing)
+ [Planejamento da integração de faturamento](#saas-plan-integration)
+ [Planejar a integração com o Amazon SNS](#saas-plan-sns)
+ [Planejamento de como os clientes acessarão seu produto](#saas-plan-customer-access)
## Planejamento da definição de preço
Existem três modelos de preços para produtos SaaS em. AWS Marketplace Escolher o modelo de definição de preço certo para o seu produto é a decisão mais importante que você tomará ao planejar o produto. Escolher o modelo de preços errado pode atrasar você em semanas. O modelo de definição de preço determina as opções de pagamento para seus clientes e o código de integração de faturamento que você precisará escrever, testar e implantar. Para obter informações sobre os diferentes tipos de modelos de preços, consulte [Preços de produtos de SaaS](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-pricing-models.html).
**nota**
Todos os modelos de preços de SaaS oferecem suporte a avaliações gratuitas. Para obter mais informações, consulte [Avaliações gratuitas de SaaS](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-free-trials.html).
## Planejamento da integração de faturamento
Um dos benefícios de ter um produto SaaS ativado AWS Marketplace é consolidar o faturamento. Para aproveitar esse benefício, você deve integrar com o Serviço de medição do AWS Marketplace ou o AWS Marketplace Entitlement Service, dependendo do modelo de definição de preço escolhido. Esses dois serviços ajudam você a garantir que seus relatórios de cobrança e uso sejam precisos.
Depois de planejar sua integração, você deve testar a integração com seu produto antes que ele fique ativo. Para obter mais informações sobre integração e testes, consulte [Acessando o AWS Marketplace serviço de medição e direitos APIs](saas-integration-metering-and-entitlement-apis.md).
## Planejar a integração com o Amazon SNS
Há dois tópicos do Amazon Simple Notification Service (Amazon SNS) que você pode assinar para o produto de SaaS. Para obter mais informações, consulte [Notificações de SaaS](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-notification.html). Essas mensagens podem ajudar você a lidar programaticamente com alterações em assinaturas e contratos iniciados por AWS ou por seus clientes. As notificações do Amazon SNS podem ser acionadores programáticos que permitem que os clientes se cadastrem em uma nova conta no site de registro do produto. Elas também podem impedir que clientes com assinaturas expiradas acessem seu produto. Você tem opções de como seus clientes recebem notificações, dependendo de como programa o tratamento dessas notificações.
## Planejamento de como os clientes acessarão seu produto
Esta seção descreve como tornar seu produto acessível aos compradores.
### Planejamento do site de registro do seu produto de SaaS
Os clientes que compram seu produto de SaaS precisam acessá-lo. Você deve planejar e implementar como deseja que seus clientes acessem o produto. Os produtos de SaaS oferecem suporte às seguintes opções de acesso:
+ Início rápido
+ AWS PrivateLink
+ Seu próprio site do produto
Para validar AWS Marketplace clientes usando seu site de registro, consulte Integração de clientes [SaaS](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-customer-setup.html).
#### Uso do início rápido para que os clientes acessem seu produto
Use a opção de implantação de início rápido para reduzir o tempo e os recursos necessários para os compradores configurarem, implantarem e lançarem seus produtos. O início rápido reduz o número de sites que os compradores devem visitar durante o processo. Para obter mais informações, consulte [Configurar o início rápido](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-settings.html#saas-quick-launch).
#### Usando AWS PrivateLink para que os clientes acessem seu produto SaaS
Você pode usar o [Entregando seus produtos por meio de uma Amazon VPC usando AWS PrivateLink](privatelink.md) para configurar seu serviço como um serviço de endpoint Amazon Virtual Private Cloud (Amazon VPC). Seus clientes podem criar um endpoint da VPC e acessar seu software em toda a rede virtual da Nuvem AWS . Como alternativa, você pode fornecer acesso ao produto de software por um site de sua propriedade e mantido por você, em que os clientes criam uma conexão pela Internet.
#### Como usar o próprio site
Seu produto de SaaS está hospedado em seu ambiente e deve ser acessado pela Internet por meio de um endpoint público que você gerencia e mantém, como um site. Normalmente, você tem um site que os clientes usam para se registrarem no seu produto, entrarem para usar o produto e acessarem o suporte para o produto.
# Diretrizes de produtos SaaS para AWS Marketplace
AWS Marketplace mantém as seguintes diretrizes para todos os produtos e ofertas de software como serviço (SaaS) AWS Marketplace para promover uma plataforma segura e confiável para nossos clientes. As seções a seguir fornecem diretrizes para produtos SaaS em. AWS Marketplace
Todos os produtos e seus metadados relacionados são revisados quando enviados para garantir que atendam ou excedam AWS Marketplace as diretrizes atuais. Essas diretrizes são revisadas e ajustadas para atender aos nossos requisitos de segurança em evolução. Além disso, revisa AWS Marketplace continuamente os produtos para verificar se eles atendem às alterações nessas diretrizes. Se os produtos não estiverem em conformidade, poderemos exigir que você atualize seu produto e, em alguns casos, ele poderá ficar temporariamente indisponível para novos assinantes até que os problemas sejam resolvidos.
**Topics**
+ [Diretrizes de configuração do produto](#saas-guidelines-setup)
+ [Requisitos de informações do cliente](#saas-customer-information)
+ [Diretrizes de uso de produtos](#saas-product-usage)
+ [Diretrizes de arquitetura](#saas-architecture)
## Diretrizes de configuração do produto
Todos os produtos de SaaS devem aderir às seguintes diretrizes de configuração de produto:
+ As dimensões dos preços não podem ser limitadas apenas a ofertas privadas. Os compradores devem ser capazes de assinar qualquer uma das dimensões da definição de preço em produtos públicos.
+ As dimensões de preços devem atender aos seguintes requisitos:
+ Para produtos que usam o modelo de preço gratuito, todas as dimensões de preço devem ser definidas como 0,00 USD.
+ Para produtos que usam outros modelos de preços (contrato, uso ou contrato com consumo), pelo menos uma dimensão de preço deve ter um preço maior que 0,00 USD. Se todas as dimensões estiverem definidas como 0,00 USD, o produto será automaticamente convertido para o modelo de preço gratuito.
+ Todas as dimensões de definição de preço devem estar relacionadas ao software real e não podem incluir outros produtos ou serviços que não estejam relacionados ao software.
+ Os produtos SaaS oferecidos exclusivamente nas AWS GovCloud (US) regiões devem incluir `GovCloud` algum lugar no título do produto.
## Requisitos de informações do cliente
Todos os produtos de SaaS devem aderir aos requisitos de informações do cliente a seguir:
+ Os produtos de SaaS devem ser faturados inteiramente de acordo com as dimensões listadas no AWS Marketplace.
+ Não é possível coletar informações de pagamento do cliente para o produto de SaaS a qualquer momento, incluindo as informações do cartão de crédito e da conta bancária.
+ A página de registro de SaaS deve incluir um campo de entrada para o endereço de e-mail do comprador. Você pode incluir campos adicionais como:
+ Nome
+ Código postal
+ Número de telefone
+ Informações sobre a empresa
+ Preferências de configuração do produto
Se pretende usar vários idiomas, você deve oferecer uma exibição em inglês da página de registro.
## Diretrizes de uso de produtos
Todos os produtos de SaaS devem aderir às seguintes diretrizes de uso de produto:
+ Depois de assinar o produto em AWS Marketplace, os clientes devem poder criar uma conta em seu aplicativo SaaS e obter acesso a um console web. Se um cliente não puder obter acesso ao aplicativo imediatamente, será necessário fornecer uma mensagem com instruções específicas sobre quando o acesso será concedido. Quando uma conta for criada, o cliente deverá receber uma notificação confirmando que sua conta foi criada juntamente com as próximas etapas.
+ Se um cliente já tiver uma conta no aplicativo de SaaS, será necessário ter a capacidade de fazer login na página inicial de atendimento.
+ Os clientes devem ter a capacidade de visualizar o status da assinatura no aplicativo de SaaS, incluindo informações relevantes sobre o contrato ou uso da assinatura.
+ Os clientes devem poder obter ajuda facilmente para problemas relacionados ao uso do aplicativo, à solução de problemas e à solicitação de reembolsos (se aplicável). As opções de contato de suporte devem ser especificadas na página inicial de atendimento.
+ Os metadados e software do produto não devem conter linguagem que redirecione os usuários para outras plataformas de nuvem, produtos adicionais, serviços de vendas ou ofertas de avaliação gratuita que não estão disponíveis no AWS Marketplace.
Para obter informações sobre avaliações gratuitas para produtos de SaaS, consulte [Criação de uma oferta de teste gratuito de SaaS em AWS Marketplace](saas-free-trials.md).
+ 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.*
## Diretrizes de arquitetura
Os tópicos a seguir listam e descrevem as diretrizes de arquitetura para produtos de SaaS.
**Topics**
+ [Diretrizes](#march-saas-guidelines)
+ [Criação dos diagramas de arquitetura](#arch-diagram)
### Diretrizes
**nota**
As diretrizes a seguir entram em vigor a partir de 1º de maio de 2025.
+ Você pode publicar todas as arquiteturas de SaaS.
+ Os produtos implantados AWS recebem uma designação especial nos resultados da AWS Marketplace pesquisa e nas páginas de detalhes do produto. AWS Marketplace Para considerar seu produto como “implantado em” AWS, seu produto deve funcionar totalmente ligado AWS. Isso inclui a aplicação e os ambientes de gerenciamento.
O *plano do aplicativo* pode ser executado na AWS conta do vendedor, na AWS conta do comprador ou em ambas. Para obter mais informações, consulte o whitepaper [ambiente de gerenciamento X plano de aplicação](https://docs.aws.amazon.com/whitepapers/latest/saas-architecture-fundamentals/control-plane-vs.-application-plane.html).
Os serviços de terceiros usados pelo produto para transmitir, armazenar ou processar dados de aplicativos — exceto redes de distribuição de conteúdo (CDNs), sistemas de nomes de domínio (DNSs) e provedores de identidade corporativa (IdPs) — também devem ser executados inteiramente. AWS
**nota**
Os *dados de aplicação* são dados que pertencem ao ou são gerados para o comprador.
Os agentes ou gateways usados pelo produto para segurança, monitoramento, replicação de dados ou migração podem ser executados em ambientes externos de propriedade do comprador AWS, inclusive no local, mas devem enviar dados somente AWS para armazenamento e análise.
Você deve incluir um diagrama de arquitetura para análise. Você não pode tornar os diagramas públicos. Para obter mais informações, consulte [Criação dos diagramas de arquitetura](#arch-diagram) na próxima seção.
+ Os vendedores podem publicar produtos não executados totalmente na AWS.
+ As aplicações que exigem recursos adicionais na infraestrutura do comprador devem seguir estas diretrizes:
+ Para ser considerado um produto SaaS e não um serviço gerenciado, seu plano de controle, conforme definido no whitepaper de [Fundamentos da Arquitetura SaaS, deve residir na infraestrutura que você gerencia.](https://docs.aws.amazon.com/whitepapers/latest/saas-architecture-fundamentals/saas-architecture-fundamentals.html) AWS Para obter mais informações, consulte o whitepaper [SaaS X provedor de serviços gerenciados](https://docs.aws.amazon.com/whitepapers/latest/saas-architecture-fundamentals/saas-vs.-managed-service-provider-msp.html).
+ Na descrição do produto, você deve notificar os clientes de que, se eles incorrerem em taxas de AWS infraestrutura separadas da AWS Marketplace transação, deverão pagar essas taxas.
+ Você deve provisionar recursos de forma segura, como usar o AWS Security Token Service (AWS STS) ou o AWS Identity and Access Management (IAM).
+ Você deve seguir o [princípio do privilégio mínimo](https://docs.aws.amazon.com/IAM/latest/UserGuide/LeastPrivilege.html) ao criar instruções de uso ou modelos de implantação que concedam permissões à aplicação.
+ Você deve apresentar uma documentação adicional que descreva todos os serviços da AWS provisionados, declarações de política do IAM e como um perfil do IAM ou um usuário é implantado e usado na conta do cliente.
+ Você deve fornecer instruções ou modelos de implantação que permitam aos compradores implantar os recursos necessários em suas AWS contas.
+ Se você fornecer CloudFormation modelos (CFTs) para implantar recursos na AWS conta do comprador, eles deverão estar em conformidade com [AWS Marketplace as políticas de CFTs](https://docs.aws.amazon.com/marketplace/latest/userguide/cloudformation.html#aws-cloudformation-template-preparation). Você deve publicá-los CFTs como parte de sua listagem de SaaS seguindo o método fornecido ao ativar a [opção de implantação do SaaS Quick Launch](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-settings.html#saas-quick-launch) para seus compradores. O Início Rápido de SaaS facilita para que os compradores configurem a solução de SaaS.
+ Se uma Amazon Machine Image (AMI) for implantada na AWS conta do comprador, ela deverá estar em conformidade com o. [Requisitos de produto baseados em AMI para AWS Marketplace](product-and-ami-policies.md) Você deve publicar a AMI como um produto separado baseado em AMI AWS Marketplace e indicar que é um produto complementar, conforme exigido no. [Políticas de uso do produto](product-and-ami-policies.md#product-usage) Você pode definir o preço de seu produto baseado em AMI como BYOL porque é uma extensão da sua oferta de SaaS. AWS Marketplace examina produtos baseados em AMI em busca de vulnerabilidades e exposições comuns não corrigidas () e requisitos de segurança. CVEs Seus compradores também devem assinar seu produto baseado em AMI antes de implantá-lo.
+ Se uma imagem de contêiner for implantada na AWS conta do comprador, ela deverá estar em conformidade com o. [Requisitos de produtos baseados em contêineres para AWS Marketplace](container-product-policies.md) Você deve publicar a imagem do contêiner como um produto separado baseado em contêiner AWS Marketplace e indicar que é um produto complementar, conforme exigido no. [Requisitos de uso do produto](container-product-policies.md#container-usage-requirements) Você pode definir o preço de seu produto baseado em contêineres como BYOL porque é uma extensão da sua oferta de SaaS. AWS Marketplace examina produtos baseados em contêineres em busca de vulnerabilidades e exposições comuns não corrigidas () e requisitos de segurança. CVEs Seus compradores também devem assinar seu produto baseado em contêineres antes de implantá-lo.
+ Ligue com sucesso para Conta da AWS aquele que se registrou como provedor e enviou a solicitação de publicação de SaaS. AWS Marketplace APIs O modelo de preços de SaaS determina o que APIs deve ser chamado:
+ Contratos SaaS — [GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)no. AWS Marketplace Entitlement Service
+ Contratos de SaaS com consumo — [GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)no AWS Marketplace Entitlement Service e [BatchMeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_BatchMeterUsage.html)no AWS Marketplace Metering Service.
+ Assinaturas de SaaS — no [BatchMeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_BatchMeterUsage.html)AWS Marketplace Metering Service.
+ Os produtos SaaS oferecidos exclusivamente nas AWS GovCloud (US) regiões devem explicar os limites arquitetônicos entre outras Regiões da AWS e as AWS GovCloud (US) regiões, os casos de uso do produto e as cargas de trabalho não recomendadas para o produto.
Para obter mais informações sobre arquiteturas SaaS, consulte o whitepaper Fundamentos da Arquitetura [SaaS](https://docs.aws.amazon.com/whitepapers/latest/saas-architecture-fundamentals/saas-architecture-fundamentals.html). AWS
### Criação dos diagramas de arquitetura
Para receber a designação especial na qual seu produto está implantado AWS, [atualize os detalhes da arquitetura do produto no Portal](saas-product-settings.md#updating-architecture-details) AWS Marketplace de Gerenciamento. Selecione um padrão de hospedagem que seja implantado AWS e faça o upload de um diagrama de arquitetura que AWS revise. Para padrões de hospedagem AWS Marketplace considerados implantados AWS, consulte a [Diretrizes](#march-saas-guidelines) seção anterior. Se o padrão de hospedagem mudar, você deverá atualizar os detalhes da arquitetura do produto.
**nota**
Você não pode tornar seus diagramas públicos.
Você pode publicar produtos não executados totalmente na AWS.
Use os seguintes critérios ao criar um diagrama:
+ Agrupe e identifique os componentes como parte do [plano de aplicação ou do ambiente de gerenciamento](https://docs.aws.amazon.com/whitepapers/latest/saas-architecture-fundamentals/control-plane-vs.-application-plane.html).
+ Para quaisquer componentes fora AWS disso que façam parte da lógica de negócios principal do seu produto, agrupe-os com o plano de aplicação.
+ Os componentes podem representar detalhes de baixo nível (por exemplo, instâncias de computação e sub-redes de rede) ou serviços de alto nível (por exemplo, uma plataforma de data analytics).
+ Os componentes não precisam identificar o nome dos AWS serviços ou não AWS serviços usados.
+ Coloque os componentes onde são executados logicamente. Por exemplo, na AWS conta do vendedor, na AWS conta do comprador, no AWS ambiente externo do vendedor ou em outro ambiente.
+ Para produtos da replicação de dados ou da migração de workload, inclua todos os ambientes de origem e destino compatíveis.
**nota**
O diagrama da arquitetura usado para atualizar os detalhes da arquitetura do produto de SaaS não é publicado e não está disponível publicamente para os compradores.
#### Nível de detalhes
Você pode criar um diagrama de alto nível que mostre os componentes principais do sistema, inclua fluxos de dados básicos e se concentre nos serviços do plano de aplicação e do ambiente de gerenciamento. Ou você pode criar um diagrama detalhado de baixo nível que divida cada componente, mostre conexões específicas e inclua especificações técnicas com diferentes níveis de detalhes.
Os diagramas a seguir mostram a arquitetura de um aplicativo de SaaS de videoanálise hipotético. Cada um mostra um nível de detalhes diferente. Ambos são aceitáveis. Use-os como exemplos do nível de detalhe a ser incluído nos diagramas.
Este é um exemplo de um diagrama de alto nível.
![\[Um diagrama de arquitetura de um aplicativo de SaaS de videoanálise hipotético com serviços de alto nível. Entre os serviços estão machine learning, armazenamento, web e serviços de cobrança agrupados e identificados como parte do ambiente de gerenciamento e do plano de aplicação.\]](http://docs.aws.amazon.com/pt_br/marketplace/latest/userguide/images/example-architecture-diagram-with-high-level-services.png)
Este é um exemplo de um diagrama detalhado de baixo nível.
![\[Um diagrama de arquitetura de um aplicativo de SaaS de videoanálise hipotético com detalhes de baixo nível. Os detalhes incluem ícones de AWS serviços para AWS Fargate nuvem privada virtual (VPC) e Amazon SageMaker AI que são agrupados e rotulados como parte do plano de controle e do plano de aplicação.\]](http://docs.aws.amazon.com/pt_br/marketplace/latest/userguide/images/example-architecture-diagram-with-low-level-details.png)
Para obter mais informações, consulte [O que é diagramação de arquitetura?](https://aws.amazon.com/what-is/architecture-diagramming/). Depois de criar um diagrama, atualize os detalhes da arquitetura no Portal de gerenciamento do AWS Marketplace (AMMP). Para obter mais informações, consulte [Atualizar detalhes da arquitetura](saas-product-settings.md#updating-architecture-details).
# Preços de produtos SaaS em AWS Marketplace
Depois que um comprador compra seu produto de software como serviço (SaaS) AWS Marketplace, AWS Marketplace fornece o identificador de cobrança. Você usa o identificador de faturamento para chamar o AWS Marketplace Entitlement Service e o AWS Marketplace Metering Service. Em seguida, os clientes acessam o produto em seu AWS ambiente ou por meio de uma conexão de endpoint de nuvem privada virtual (VPC) criada por você. Este tópico fornece uma lista de modelos de preços de SaaS para. AWS Marketplace
**nota**
Todos os modelos de preços de SaaS oferecem suporte a avaliações gratuitas. Para obter mais informações, consulte [Avaliações gratuitas de SaaS](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-free-trials.html).
**Modelos de definição de preço de SaaS**
| Modelo de definição de preços | Description |
| --- | --- |
| Assinaturas de SaaS | Um pay-as-you-go modelo em que cobramos dos compradores pelo uso horário de seu produto SaaS. Para obter mais informações, consulte [Definição de preço de assinaturas de SaaS](saas-subscriptions.md). |
| Contratos de SaaS | Os compradores são cobrados com antecedência pelo uso de seu software, ou você pode oferecer uma programação de pagamento flexível. Os clientes também podem pagar pelo uso adicional acima de seu contrato. Para obter mais informações, consulte [Definição de preço para contratos de SaaS](saas-contracts.md). |
| Contratos SaaS com pay-as-you-go | Os compradores são cobrados com antecedência pelo uso de seu software, ou você pode oferecer uma programação de pagamento flexível. Os compradores também recebem uma taxa adicional medida pelo uso, além do preço do contrato. Para obter mais informações, consulte [Definição de preço para contratos de SaaS](saas-contracts.md). |
| SaaS grátis | Um modelo de preços gratuito em que os clientes podem usar seu produto SaaS sem nenhum custo. Todas as dimensões de preço devem ser definidas como 0,00 USD. |
**nota**
Depois de criar o anúncio e publicá-lo como limitado, você não poderá alterar o modelo da definição de preço.
[Para disponibilizar seu produto SaaS em AWS Marketplace, decida se você deseja oferecer o modelo de preços de [assinaturas SaaS ou o modelo de preços](saas-subscriptions.md) de contratos de SaaS.](saas-contracts.md)
# Definição de preço de assinaturas de SaaS
Para assinaturas de software como serviço (SaaS), AWS Marketplace faturas de seus clientes com base nos registros de medição que você nos envia. Todas as cobranças devem ser medidas e relatadas a cada hora a partir do software implantado na conta do cliente. Todo o uso é então calculado mensalmente e cobrado mensalmente usando o mesmo mecanismo das AWS Marketplace ofertas baseadas em AMI. Nossa capacidade de cobrar os clientes pelo uso do produto depende do recebimento dos registros de medição de você. Você é responsável por garantir que os registros de medição do produto sejam transmitidos e recebidos.
Antes de poder publicar um produto de SaaS com preços de assinatura, você deve fazer o seguinte:
1. Crie um novo produto SaaS no Portal de gerenciamento do AWS Marketplace, escolha Nova assinatura **SaaS**.
1. Preencha os campos na guia **Geral** com as informações necessárias. Anote o código do produto.
1. Na guia **Preços**, em **Definir preços**, selecione a **Categoria** que descreve os preços do seu produto com mais precisão. A categoria de preços aparece para os clientes no AWS Marketplace site. Você pode escolher entre **largura de banda** (GBps, MBps), **dados** (GB, MB, TB), **hosts** (horas), **solicitações** ou **usuários** (horas). Se nenhuma das categorias predefinidas atender às suas necessidades, você poderá escolher a categoria mais genérica **Unidades**.
Em seguida, defina as dimensões de preço. Cada dimensão de preço representa um recurso ou serviço para o qual você pode definir um preço por unidade. Os exemplos de dimensões incluem usuários, hosts verificados e GB de logs ingeridos. Você pode definir, no máximo, 200 dimensões. Para cada dimensão que você definir, será necessário adicionar as seguintes informações:
+ **Nome da API da dimensão**: o nome da API usada ao enviar registros de medição para o [AWS Marketplace Metering Service](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html). Esse nome indica a dimensão usada pelo seu cliente. Esse nome é visível em relatórios de faturamento. O nome não precisa ser amigável ao leitor porque você é o único com acesso a seus relatórios. Depois de definir o nome, você não poderá alterá-lo.
+ **Descrição da dimensão**: 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 são 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 da dimensão**: a cobrança por unidade de FCP do software para esse produto, em USD. Este campo dá suporte a oito casas decimais.
## Quando uma assinatura SaaS termina
**Importante**
As notificações do SNS para produtos AWS Marketplace SaaS estão sendo substituídas pelas notificações da Amazon EventBridge . Se você já tiver produtos SaaS integrados ao SNS, eles continuarão funcionando. Eventualmente, os novos anúncios passarão a usar a Amazon EventBridge em vez do SNS. Para obter mais informações, consulte [Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge](saas-eventbridge-integration.md).
Um cliente pode cancelar a assinatura do produto de assinatura de SaaS por meio do Console de gerenciamento da AWS. Os principais pontos do processo de encerramento da assinatura de SaaS incluem o seguinte:
1. Seu EventBridge ônibus padrão da Amazon receberá um evento encerrado com o contrato de compra para esse cliente.
1. Você tem uma hora para medir qualquer uso restante para o cliente.
1. Após essa hora, você recebe uma licença desprovisionada - evento do fabricante. Nesse momento, não será mais possível enviar registros de medição ao cliente.
Fica a seu critério decidir como deseja desativar a funcionalidade no produto de SaaS para clientes que cancelaram a assinatura. Por exemplo, o produto pode concluir trabalhos existentes do cliente, mas impedir que ele crie novos trabalhos. Você pode exibir uma mensagem para o cliente informando que o uso foi desativado. Os clientes podem assinar novamente seu produto por meio AWS Marketplace de.
## Quando uma assinatura de SaaS é cancelada
Os principais pontos do processo de cancelamento da assinatura de SaaS incluem o seguinte:
1. Um cliente pode cancelar a assinatura do seu produto de assinatura SaaS na página Your **Marketplace Software** do AWS Marketplace site.
Seu EventBridge ônibus padrão da Amazon receberá um evento encerrado com o contrato de compra para esse cliente.
1. Você tem uma hora para medir qualquer uso restante para o cliente.
1. Notifique o cliente do seu produto de que o cancelamento está em andamento. Se um cliente indicar que deseja cancelar por meio do produto, direcione-o para o AWS Marketplace. Para garantir que não haverá cobranças futuras, os clientes devem confirmar o cancelamento com. AWS Marketplace
# Definição de preço para contratos de SaaS
Os contratos de SaaS permitem que os clientes comprem seu software por meio de um contrato inicial. De acordo com o contrato, os clientes têm direito a uma quantidade específica de uso do seu produto SaaS. Você define as categorias de uso, as dimensões e a duração do contrato. AWS Marketplace fatura seus clientes antecipadamente ou de acordo com o cronograma de pagamento definido por você. Para uso adicional acima do contrato, seu software relata o uso por meio do AWS Marketplace Metering Service (AWS Marketplace Metering Service).
Ao usar o modelo de preço de contrato de SaaS, o aplicativo nunca envia registros de medição. Em vez disso, ele verifica o direito chamando o AWS Marketplace Entitlement Service ().AWS Marketplace Entitlement Service AWS Marketplace comunica esses direitos ao seu aplicativo SaaS.
## Criação de um produto de contrato SaaS
Antes de poder publicar um produto de SaaS com preços contratuais, você deve fazer o seguinte:
1. Crie um novo produto SaaS no e escolha Novo Portal de gerenciamento do AWS Marketplace contrato de **SaaS**.
1. Preencha os campos na guia **Geral** com as informações necessárias. Anote o código do produto.
1. Na guia **Preços**:
1. Em **Definir preços**, escolha a **duração do contrato** que você deseja oferecer aos clientes. Você pode inserir preços diferentes para cada duração de contrato. Você pode selecionar uma ou mais das seguintes opções: **mensal**, **1 ano**, **2 anos** e **3 anos**. Se você estiver criando uma oferta privada, poderá escolher uma duração personalizada em meses (até 60 meses).
1. Em **Escolha o tipo de contrato que você deseja oferecer**, escolha como você deseja que os clientes possam comprar seu produto entre as seguintes opções:
+ **O comprador pode escolher uma ou mais opções oferecidas**: os clientes podem selecionar uma quantidade para cada dimensão de preço oferecida.
+ **O comprador pode escolher apenas um nível oferecido**: os clientes optam por um nível entre as opções que incluem diferentes conjuntos de recursos, serviços e quantidades de uso.
1. Escolha a categoria de unidade de uso que melhor descreve a definição de preço do seu produto. A categoria de preços aparece para os clientes no AWS Marketplace site. Você pode escolher entre **largura de banda** (GBps, MBps), **dados** (GB, MB, TB), **hosts** (horas), **solicitações** ou **usuários** (horas). Se nenhuma das categorias predefinidas atender às suas necessidades, você poderá escolher a categoria mais genérica **Unidades**.
1. Defina suas dimensões de preços. Cada dimensão representa um recurso ou serviço que você deseja precificar separadamente. Para obter informações detalhadas sobre as dimensões de preços e os campos obrigatórios, consulte[Entendendo as dimensões de preços de contratos de SaaS](#understanding-saas-contract-pricing-dimensions).
## Entendendo as dimensões de preços de contratos de SaaS
Cada dimensão de preço representa um recurso ou serviço para o qual você pode definir um preço por unidade. Os exemplos de dimensões são usuários, hosts verificados e GB de logs ingeridos. Para cada dimensão definida, você adiciona um nome, uma descrição, um preço e um nome de API. O nome, o preço e a descrição são exibidos para os clientes. Você usa o nome da API para rastrear e gerar relatórios da AWS Marketplace seguinte forma:
+ Chamar o [AWS Marketplace Entitlement Service](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/Welcome.html) para recuperar as dimensões que seus clientes compraram.
+ Chamar o [AWS Marketplace Metering Service](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html) para indicar quais dimensões os clientes usaram.
Para cada dimensão de preço no contrato, você pode optar por permitir que os clientes paguem à medida que fazem uso adicional dessa dimensão acima de seu contrato. Você também pode adicionar outras dimensões sem preços de contrato que os clientes só consumirão pagando sob demanda.
Ao usar o assistente para criar os contratos para seu produto de SaaS, você deve definir os seguintes campos para suas dimensões de definição de preço:
**Nome da API Dimension**
O nome usado ao chamar a API Entitlements. Esse nome é visível nos relatórios de cobrança e os relatórios não estão disponíveis externamente. O tamanho máximo do nome da API é de 15 caracteres. Depois de definir o nome, você não poderá alterá-lo.
**Nome de exibição da dimensão**
O nome de uma dimensão voltado para o cliente. Esse nome deve ajudar o cliente a entender a dimensão para o produto. O nome deve ser fácil para o usuário e o comprimento máximo é de 24 caracteres. Este valor pode ser alterado.
**Descrição da dimensão**
A descrição de uma dimensão voltada para o cliente que fornece informações adicionais sobre a dimensão do produto. O comprimento máximo para a descrição é de 70 caracteres.
**Dimensão - preço mensal**
A cobrança de software por unidade para a opção de 1 mês para essa dimensão. Esse campo é compatível com três casas decimais.
**Dimensão - preço de 1 ano**
A cobrança de software por unidade para a opção de 12 meses para essa dimensão. Esse campo é compatível com três casas decimais. Não é uma cobrança mensal. O preço deve refletir o preço de cobrança única de 12 meses.
**Dimensão - preço de 2 anos**
A cobrança de software por unidade para a opção de 24 meses para essa dimensão. Esse campo é compatível com três casas decimais.
**Dimensão - preço de 3 anos**
A cobrança de software por unidade para a opção de 36 meses para essa dimensão. Esse campo é compatível com três casas decimais.
**Exemplo: aplicativo de armazenamento de dados**
| | Preço mensal | Preço para 12 meses | Preço para 24 meses | Pay-as-you-go preço para uso adicional |
| --- | --- | --- | --- | --- |
| Dados não criptografados (GB) | 1,50 USD/GB | 16,00 USD/GB | 30,00 USD/GB | 0,1/GB USD por hora |
| Dados criptografados (GB) | 1,55 USD/GB | 16,60 USD/GB | 31,20 USD/GB | 0,11/GB USD por hora |
**Exemplo: produto de monitoramento de log**
| | Preço mensal | Preço para 12 meses | Pay-as-you-go preço para uso adicional |
| --- | --- | --- | --- |
| Básico (10 hosts monitorados, 5 contêineres monitorados) | 100 USD | 1000 USD | |
| Padrão (20 hosts monitorados, 10 contêineres monitorados) | 200 USD | 2000 USD | |
| Pro (40 hosts monitorados, 20 contêineres monitorados) | 400 USD | 4000 USD | |
| Outros hosts monitorados por hora | | | 0,1 USD |
| Outros contêineres monitorados por hora | | | 0,2 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. Por exemplo, suponha que você tenha dimensões `ReadOnlyUsers` e `AdminUsers`. Se você oferecer um preço anual para `ReadOnlyUsers`, também deverá oferecer um preço anual para `AdminUsers`.
## Atualizações de contratos de SaaS
Os clientes podem atualizar um contrato para um de valor mais alto, mas não de maior duração. Por exemplo, ele pode atualizar para maiores quantidades ou autorizações de valores mais altos. Os clientes receberão um crédito pro-rata para seu contrato existente. Os clientes não podem diminuir o tamanho de seu contrato existente. Eles só podem diminuir o tamanho na renovação ou cancelar a renovação.
As autorizações são verificadas pelo seu produto de SaaS, que faz chamadas para o AWS Marketplace Entitlement Service.
## Renovações automáticas
Quando um cliente compra seu produto AWS Marketplace usando contratos SaaS, ele pode concordar com a renovação automática dos termos do contrato. O cliente continua a pagar pelas autorizações a cada mês ou por um, dois ou três anos. O cliente sempre tem a opção de modificar as configurações da renovação. Ele pode cancelar a renovação ou renovar o contrato com diferentes quantidades e durações.
## Quando um contrato de SaaS termina
Um produto de contrato de SaaS tem um prazo de expiração. Quando um contrato termina, ocorrem os seguintes eventos:
1. Seu produto de SaaS recebe uma notificação `entitlement-updated` indicando que os direitos do comprador foram alterados. O AWS Marketplace Entitlement Service retorna uma resposta vazia.
1. Você tem uma hora para medir qualquer uso restante para o cliente. Depois desse tempo, não será mais possível enviar registros de medição ao cliente.
## Quando um contrato de SaaS é cancelado
Os principais pontos do processo de cancelamento do contrato de SaaS incluem o seguinte:
1. O cliente pode solicitar um cancelamento e um reembolso para produtos de contrato de SaaS por meio do AWS Support.
Os clientes devem solicitar reembolsos dentro de 48 horas. AWS Support
O reembolso total ou proporcional normalmente é concedido em 3 a 5 dias úteis.
1. Seu produto SaaS recebe notificações por meio de EventBridge eventos da Amazon para esse cliente.
1. Você tem uma hora para enviar um registro final de medição para o cliente para quaisquer cobranças adicionais de uso.
1. Notifique o cliente do seu produto de que o cancelamento está em andamento. Se um cliente indicar que deseja cancelar por meio do produto, direcione-o para o AWS Marketplace. Para garantir que não haverá cobranças futuras, os clientes devem confirmar o cancelamento com. AWS Marketplace
# Criação de uma oferta de teste gratuito de SaaS em AWS Marketplace
Como AWS Marketplace vendedor, você pode criar ofertas de teste gratuito de software como serviço (SaaS) no Portal de gerenciamento do AWS Marketplace (AMMP). Os clientes podem avaliar os produtos de software antes de tomar grandes decisões de compra usando a opção de avaliação gratuita do SaaS. Depois que um cliente assina seu produto, ele realiza verificações de direitos da mesma forma que faz com clientes pagantes.
Cada um só Conta da AWS pode usar uma avaliação gratuita de um produto SaaS uma vez. O valor de uso gratuito concedido durante um teste gratuito não é compartilhado entre contas vinculadas em uma AWS organização. Diferentes contas vinculadas em uma única conta de pagador principal podem criar suas próprias avaliações gratuitas individuais.
**nota**
Se usar o Seller Data Delivery Service (SDDS), você receberá um [relatório de teste com detalhes do contrato](https://docs.aws.amazon.com/marketplace/latest/userguide/supplementary-reports.html) no bucket do Amazon Simple Storage Service. O relatório inclui detalhes do contrato, como nome e ID do assinante, ID da oferta e datas de início e término do contrato.
Os vendedores também recebem [notificações do Amazon Simple Notification Service (Amazon SNS)](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-notification.html) quando novas assinaturas são criadas. As notificações do Amazon SNS incluem uma sinalização `isFreeTrialTermPresent` para identificar contratos de avaliação gratuita.
Além disso, os clientes que assinam o teste gratuito são redirecionados para o URL de registro com um token adicional, `x-amzn-marketplace-offer-type=free-trial`. Você pode usar o token para criar uma experiência de registro exclusiva para os clientes que usam os testes gratuitos.
## Criação de uma oferta de avaliação gratuita de SaaS
Os vendedores podem criar ofertas de teste gratuito de SaaS no ( Portal de gerenciamento do AWS Marketplace AMMP).
**Para criar uma oferta de avaliação gratuita de SaaS**
1. Faça login no [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management).
1. No Portal de gerenciamento do AWS Marketplace, escolha uma das seguintes opções:
+ **Criar ou gerenciar ofertas**
+ A guia **Ofertas**
1. Na página **Ofertas**, escolha a guia **Avaliações gratuitas públicas** para revisar todas as avaliações gratuitas de SaaS.
1. Escolha **Criar oferta de avaliação gratuita**. Os vendedores podem criar uma oferta de avaliação gratuita de SaaS para cada produto público de SaaS.
1. Em **Fundamentos da oferta**, selecione seu **Produto** e escolha **Avançar**.
1. Nas **Configurações de avaliação gratuita**:
1. Insira o número de dias da **Duração da avaliação gratuita (dias)**.
A duração dessas avaliações varia de 7 a 90 dias.
1. Veja as **Dimensões do produto** de sua oferta pública existente.
Você não pode mudar as dimensões do produto para avaliações gratuitas de assinatura de SaaS.
Você pode definir os limites de quantidade por cada dimensão para avaliações gratuitas do contrato de SaaS e **Remover** ou **Adicionar dimensões**.
1. Veja o **Contrato de serviço**.
Para a versão do EULA, você pode selecionar **Contrato padrão do AWS Marketplace** ou **EULA personalizado** e, em seguida, escolher **Revisar oferta**.
1. Verifique e revise todas as informações da oferta e, em seguida, escolha **Criar oferta**.
## Cancelamento de uma oferta de avaliação gratuita de SaaS
Os vendedores podem cancelar as ofertas de avaliação gratuita a qualquer momento no Portal de gerenciamento do AWS Marketplace.
Para cancelar uma oferta de avaliação gratuita de SaaS
1. Faça login no [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management).
1. No Portal de gerenciamento do AWS Marketplace, escolha uma das seguintes opções:
+ **Criar ou gerenciar ofertas**
+ A guia **Ofertas**
1. Na página **Ofertas**, selecione a oferta.
1. Escolha **Exibir oferta**.
1. Escolha **Cancelar oferta**.
Depois que uma oferta é cancelada, os contratos ativos dessa oferta ficam ativos até o vencimento. Não é possível criar novos contratos para uma oferta cancelada.
# Integrando clientes ao seu produto SaaS por meio de AWS Marketplace
Com assinaturas de software como serviço (SaaS) e contratos SaaS, seus clientes assinam seus produtos AWS Marketplace por meio de, mas acessam o produto em seu ambiente. AWS Depois de assinar o produto, seu cliente é direcionado para um site que você cria e gerencia como parte de seu produto SaaS para registrar sua conta e configurar o produto.
Ao criar listas de produtos de SaaS, forneça um URL para a página inicial do registro. Usamos esse URL para redirecionar os clientes para sua página de destino de registro depois que eles assinam. Na página de destino de registro do software, você coleta todas as informações necessárias para criar uma conta para o cliente. Recomendamos coletar o endereço de e-mail do cliente se você planeja entrar em contato para enviar notificações de uso.
A página inicial de registro deve ser capaz de identificar e aceitar o `x-amzn-marketplace-token` token nos dados do formulário AWS Marketplace com o identificador do cliente para cobrança. Em seguida, ele deve passar esse valor do token AWS Marketplace Metering Service para resolver o Conta da AWS ID exclusivo do cliente, o identificador do cliente (para novas implementações ou ao atualizar sua integração, use o ID da conta AWS do cliente) e o código do produto correspondente. Para ver um exemplo de código, consulte [Exemplo de código `ResolveCustomer`](saas-code-examples.md#saas-resolvecustomer-example).
**nota**
O token de registro é transferido para um cliente inscrito específico e cada token gerado tem uma janela de expiração de 4 horas. Enquanto o chamador estiver chamando a API com o mesmo token, ele continuará retornando os mesmos valores de resposta até que o token expire.
## Configurar o produto de SaaS para aceitar novos compradores
Você é responsável por configurar corretamente seu software SaaS para aceitar novos clientes e medi-los adequadamente. O processo a seguir descreve uma maneira recomendada de identificar, implementar e medir o acesso de um novo cliente ao seu software:
1. Quando um cliente visita a página do seu produto no AWS Marketplace site, ele opta por assinar seu produto.
1. O cliente Conta da AWS está inscrito em seu produto. Isso significa que os registros de assinatura e medição enviados do seu produto se tornam parte da AWS fatura do cliente.
1. Um token de registro é gerado para o cliente que contém o ID da Conta da AWS , o identificador do cliente e o código do produto.
1. O cliente é redirecionado para a página de destino de registro do software. Essa página deve ser capaz de aceitar o token com o identificador do cliente.
1. O navegador do cliente envia uma solicitação `POST` para o URL da página de destino de registro do seu software. A solicitação contém um parâmetro `POST`, `x-amzn-marketplace-token`, que contém o token de registro do cliente. Na perspectiva do site de registro, o cliente enviou um formulário com esse parâmetro. O token de registro é uma string invisível. Se o tipo de oferta for uma avaliação gratuita, um segundo parâmetro, `x-amzn-marketplace-offer-type` com o valor `free-trial`, será adicionado à solicitação.
1. Para resgatar esse token de registro por um Conta da AWS ID de cliente, identificador de cliente e código de produto, seu site deve recorrer [ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)ao AWS Marketplace Metering Service. Para obter um exemplo de uma chamada `ResolveCustomer`, consulte [Exemplo de código `ResolveCustomer`](saas-code-examples.md#saas-resolvecustomer-example). O identificador do cliente não é o Conta da AWS ID do cliente, mas é universal entre os produtos e deve ser salvo em uma fonte interna como parte dos registros do cliente. O código do produto é uma string exclusiva para seu produto SaaS que AWS fornece a você. Cada AWS produto tem um código de produto exclusivo, que é atribuído a você durante o registro.
1. O cliente é instruído a criar uma conta no produto ou fazer login em uma conta existente.
**nota**
Se a configuração ou vinculação a uma conta de cliente existente em seu produto exigir um processo manual da equipe, você poderá usar um formulário de contato para coletar as informações de contato do cliente. Depois de coletar as informações de contato e resolver o ID da Conta da AWS e o identificador exclusivo do cliente (conforme obtido na etapa 6), exiba uma mensagem de notificação para o cliente. Na notificação, informe que a conta dele está sendo configurada e peça para ele aguardar você entrar em contato. Forneça ao cliente o tempo de resposta esperado e suas informações de contato. Envie também uma mensagem de e-mail para o cliente com os mesmos detalhes.
1. O cliente agora faz login no site usando as credenciais específicas daquele produto de SaaS. No banco de dados da sua conta, é possível ter uma entrada para cada cliente. Seu banco de dados de contas deve ter uma coluna para o Conta da AWS ID. Verifique se nenhuma outra conta em seu sistema compartilha a Conta da AWS ID.
1.
**Importante**
As notificações do SNS para produtos AWS Marketplace SaaS estão sendo substituídas pelas notificações da Amazon EventBridge . Se você já tiver produtos SaaS integrados ao SNS, eles continuarão funcionando. Eventualmente, os novos anúncios passarão a usar a Amazon EventBridge em vez do SNS. Para obter mais informações, consulte [Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge](saas-eventbridge-integration.md).
Durante o processo de registro de vendedor, você configura EventBridge as regras da Amazon para receber eventos que o notificam quando os clientes assinam ou cancelam a assinatura do seu produto. Esses são EventBridge eventos da Amazon no formato JSON que informam você sobre as ações do cliente:
+ Notificação de direitos: para produtos com modelos de preços que incluem um contrato, você é notificado quando os compradores criam um novo contrato, atualizam, renovam ou ele expira. O banco de dados das suas contas deve ter uma coluna adicional para o estado da assinatura. Para obter mais informações, consulte [Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge](saas-eventbridge-integration.md).
+ Notificação de assinatura: para produtos com qualquer modelo de preço, incluindo contratos e assinaturas, você é notificado quando um comprador assina ou cancela a assinatura de um produto. Para obter mais informações, consulte [Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge](saas-eventbridge-integration.md).
Recomendamos que você use o Amazon Simple Queue Service (Amazon SQS) (Amazon SQS) como alvo para EventBridge suas regras capturarem esses eventos. Depois de receber uma notificação de assinatura com `subscribe-success`, a conta do cliente está pronta para a medição. Os registros que você envia antes desse evento não são medidos. Para obter informações sobre como configurar EventBridge regras com destinos do SQS, consulte os destinos do [Amazon SQS](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html#eb-targets-sqs) no Guia do usuário da * EventBridge Amazon*.
**nota**
Não ative uma assinatura de produto a menos que você receba uma notificação `subscribe-success`.
1. Use a Conta da AWS ID armazenada em seu banco de dados para medir o uso por meio do AWS Marketplace Metering Service ou verifique os direitos por meio do. AWS Marketplace Entitlement Service
## Segurança e encomenda
Como vendedor, é sua responsabilidade confiar somente naqueles Conta da AWS IDs que são devolvidos imediatamente AWS ou naqueles que seu sistema assinou. É recomendável resolver imediatamente o token de registro, pois ele poderá expirar depois de aproximadamente uma hora. Depois de resolver o token de registro, armazene o Conta da AWS ID como um atributo assinado na sessão do navegador do cliente até que o registro seja concluído.
# Notificações do Amazon SNS para produtos de SaaS
**Importante**
As notificações do SNS para produtos AWS Marketplace SaaS estão sendo substituídas pelas notificações da Amazon EventBridge . Se você já tiver produtos SaaS integrados ao SNS, eles continuarão funcionando. Eventualmente, os novos anúncios passarão a usar a Amazon EventBridge em vez do SNS. Para obter mais informações, consulte [Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge](saas-eventbridge-integration.md).
Para receber notificações, você assina os tópicos do Amazon Simple Notification Service (Amazon SNS) fornecidos AWS Marketplace durante a criação do produto. Os tópicos fornecem notificações sobre alterações nas assinaturas e nos direitos contratuais dos clientes para seus produtos. Isso permite que você saiba quando fornecer e revogar o acesso de clientes específicos.
**nota**
Durante o processo de criação do produto, você receberá o nome do recurso da Amazon (ARN) para o tópico do SNS. Por exemplo: `arn:aws:sns:us-east-1:123456789012:aws-mp-subscription-notification-PRODUCTCODE`
Os seguintes tópicos do Amazon SNS estão disponíveis para produtos de software como serviço (SaaS):
+ [Tópico do Amazon SNS: `aws-mp-entitlement-notification`](#saas-sns-message-body): este tópico notifica você quando os compradores criam um novo contrato, o atualizam, o renovam ou ele expira. Isso só está disponível para produtos com modelos de preços que incluem um contrato (também conhecido como **Contratos de SaaS** e **Contratos de SaaS com consumo (excedentes))**.
+ [Tópico do Amazon SNS: `aws-mp-subscription-notification`](#saas-sns-subscription-message-body): este tópico notifica você quando um comprador assina ou cancela a assinatura de um produto e inclui o `offer-identifier` para ofertas privadas e um sinalizador de avaliações gratuitas de SaaS. Isso está disponível para todos os modelos de preços, incluindo contratos e assinaturas (também conhecidos como **Assinaturas de SaaS**, **Contratos de SaaS** e **Contratos de SaaS com consumo (excedentes)**.
Para saber mais sobre os cenários nos quais você responde a essas notificações, consulte os seguintes tópicos:
+ [Integrando sua assinatura Pay-As-You-Go ou produto SaaS com AWS Marketplace](saas-integrate-subscription.md)
+ [Integrando seu produto de contrato SaaS com AWS Marketplace](saas-integrate-contract.md)
+ [Integrando seu produto baseado em contratos SaaS com AWS Marketplace](saas-integrate-contract-with-pay.md)
## Tópico do Amazon SNS: `aws-mp-entitlement-notification`
Cada mensagem no tópico `aws-mp-entitlement-notification` tem o formato a seguir.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
}
```
Sempre ** serão` entitlement-updated`.
**nota**
Para mensagens de autorização, independentemente da ação (nova, atualização, renovação ou expirada), a mensagem é a mesma. É necessária uma chamada subsequente para `GetEntitlement` para descobrir o conteúdo da atualização.
Para **Contratos de SaaS com consumo (excedentes)**, os vendedores recebem o [tópico do SNS `aws-mp-subscription-notification`](#saas-sns-subscription-message-body). Essa é uma notificação extra que o vendedor recebe quando adiciona preços excedentes. Quando um vendedor adquire novos clientes, em vez de apenas obter `entitlement-updated` (o que pode se referir a qualquer tipo de ação), o vendedor recebe uma mensagem de assinatura indicando que se trata de um novo cliente.
Para contratos com data futura (FDAs), este tópico é iniciado na data de início do contrato (e não na data de assinatura do contrato). Também é iniciado quando ocorrem alterações subsequentes no direito, como cancelamento, substituição, renovação ou expiração do contrato.
Os produtos com preços contratuais (incluindo contratos com pay-as-you-go) devem responder a essas mensagens. Para obter mais informações sobre como responder, consulte [Cenário: monitorar as alterações nas assinaturas dos usuários](saas-integrate-contract.md#saas-contract-monitor-changes).
## Tópico do Amazon SNS: `aws-mp-subscription-notification`
Cada mensagem no tópico `aws-mp-subscription-notification` tem o formato a seguir.
```
{
"action": "",
"customer-identifier": " X01EXAMPLEX",
"product-code": "n0123EXAMPLEXXXXXXXXXXXX",
"offer-identifier": "offer-abcexample123",
"isFreeTrialTermPresent":"true"
}
```
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.
A propriedade `isFreeTrialTermPresent` indica se a assinatura do comprador é uma avaliação gratuita. O valor JSON dessa propriedade não é um tipo de dados *booleano*. Em vez disso, o valor é convertido em um tipo de dados de *string*. Para obter mais informações, consulte [Avaliações gratuitas de SaaS](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-free-trials.html).
**Isso variará de acordo com a notificação. As ações possíveis são:
+ `subscribe-success`: a mensagem `subscribe-success` indica quando o vendedor pode começar a enviar registros de medição. Se uma [oferta baseada em contrato](https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html#private-offers-upgrades-and-renewals-process) for aceita pelo comprador, essa mensagem será enviada novamente com o novo `offer-identifier`.
+ `subscribe-fail`— Se a `subscribe-fail` mensagem for gerada, o pagamento pode ter falhado, mesmo que o comprador já tenha feito a transição da página inicial SaaS AWS Marketplace para a página de destino SaaS do vendedor. O vendedor deve aguardar a mensagem `subscribe-success` antes de permitir o consumo do produto.
+ `unsubscribe-pending`: quando um comprador cancela a assinatura, uma mensagem `unsubscribe-pending` é enviada primeiro. Isso indica que o vendedor tem um tempo limitado (cerca de uma hora) para enviar os registros finais de medição antes que o comprador seja totalmente cancelado.
+ `unsubscribe-success`: a mensagem `unsubscribe-success` sinaliza a conclusão do cancelamento, após o qual nenhum outro registro de medição será aceito.
**nota**
Se um comprador cancelar a assinatura e se inscrever novamente imediatamente antes do envio da mensagem `unsubscribe-success` final, a mensagem `unsubscribe-success` final não será enviada e, em vez disso, uma mensagem `subscribe-success` será enviada.
Para contratos com data futura (FDAs), a `subscribe-success` ação é iniciada na data de início do contrato (e não na data de assinatura do contrato).
Os produtos com preços de assinatura (incluindo contratos com pay-as-you-go) devem responder a essas mensagens. Para obter mais informações sobre como responder, consulte os tópicos a seguir:
+ [Integrando sua assinatura Pay-As-You-Go ou produto SaaS com AWS Marketplace](saas-integrate-subscription.md)
+ [Integrando seu produto baseado em contratos SaaS com AWS Marketplace](saas-integrate-contract-with-pay.md)
## Assinar uma fila do SQS no tópico do 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.
# Gerenciando eventos de assinatura de SaaS com a Amazon EventBridge
Você pode usar EventBridge a Amazon para integrar e gerenciar produtos SaaS com o. AWS Marketplace Os eventos são enviados para alterações nas assinaturas dos clientes e nos direitos contratuais de seus produtos. Você recebe notificações quando os clientes se inscrevem, quando seus direitos mudam e quando eles cancelam, para que você saiba exatamente quando conceder ou revogar o acesso. Esses eventos têm duas funções principais:
+ **Fabricante** — Este é o fabricante original do produto listado em AWS Marketplace, também conhecido como Fornecedor Independente de Soluções (ISV).
+ **Proponente** — Este é o proponente original de um contrato de compra para o produto listado em. AWS Marketplace Pode ser o ISV ou um parceiro de canal autorizado a revender o produto.
Dois padrões de venda distintos determinam se você, como ISV, atua como fabricante ou proponente. Sua função determina por meio de quais notificações você recebe EventBridge.
| Padrão de venda | Description | Papel do ISV |
| --- | --- | --- |
| AWS Marketplace oferta pública ou privada | Você estende uma oferta ou contrato diretamente ao comprador. | Fabricante e proponente |
| Oferta privada de parceiros de canal | Um parceiro de canal autorizado a revender seu produto estende uma oferta ou contrato ao comprador. | Fabricante |
## EventBridge eventos para produtos SaaS
Quando ocorre uma AWS Marketplace transação, EventBridge envia eventos para seu barramento de eventos padrão. Sua função como fabricante ou proponente determina quais eventos você receberá.
| Nome do evento | Iniciado por | Resposta | Destinatário |
| --- | --- | --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/marketplace/latest/userguide/saas-eventbridge-integration.html) | Um novo contrato é criado, um contrato existente é substituído ou um contrato existente é renovado. | O contrato de compra é registrado e as ações pós-venda são tomadas. DescribeAgreement A API é usada para determinar se o novo contrato é um teste gratuito. | Fabricante e proponente |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/marketplace/latest/userguide/saas-eventbridge-integration.html) | Um contrato existente é alterado. | O registro do contrato de compra foi alterado. | Fabricante e proponente |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/marketplace/latest/userguide/saas-eventbridge-integration.html) | Um contrato expirou, foi cancelado, foi rescindido. | O fechamento do contrato de compra é registrado e as ações de cancelamento pós-contrato acontecem. O ISV começa a revogar os direitos dos clientes. | Fabricante e proponente |
| Licença atualizada - Fabricante | O direito do comprador a um produto foi alterado. | Os direitos do cliente são verificados usando a GetEntitlements API e os serviços são provisionados adequadamente. | Somente fabricante |
| Licença desprovisionada - Fabricante | O direito do comprador a um produto terminou. | Para produtos baseados em uso, esse evento marca o início de uma janela de relatório final de 1 hora. Os vendedores devem coletar e relatar qualquer uso não declarado usando a BatchMeterUsage API. Depois que essa janela for fechada, os direitos do cliente serão totalmente revogados e os relatórios de uso não serão mais aceitos. | Somente fabricante |
**nota**
Os tipos de eventos do contrato de compra para fabricante e proponente são quase idênticos, exceto pela presença de uma ID de autorização de revenda. Para evitar mensagens redundantes, somente o evento do contrato de compra do proponente é enviado quando você é o fabricante e o proponente.
Para ver a lista completa dos tipos de eventos e seus esquemas detalhados, consulte [EventBridge Eventos da Amazon](notifications-eventbridge.md) o Guia do Vendedor.
## Janela final de relatórios de uso para produtos baseados em uso
Para produtos com um componente de cobrança baseado no uso, o AWS Marketplace dá aos vendedores uma hora para enviar registros de uso final para clientes cujos direitos terminaram. Após esse período, a `BatchMeterUsage` API rejeita o uso relatado e você não pode cobrar o cliente.
AWS O Marketplace envia o evento License Deprovisioned - Manufacturer para sinalizar o início da janela final de relatórios. Após receberem esse evento, os vendedores têm uma hora para coletar qualquer uso não declarado do cliente e denunciá-lo usando a `BatchMeterUsage` API.
Após o fechamento da janela de uma hora, o AWS Marketplace revoga totalmente os direitos do cliente e não aceita mais relatórios de uso.
## Integre EventBridge com seu produto SaaS
Use EventBridge para integrar suas operações de provisionamento de inquilinos com sua listagem de SaaS no Marketplace. AWS
+ As regras do evento definem como reagir a um evento. Essas regras podem reagir imediatamente ou em um cronograma definido.
+ Os padrões de eventos são definidos nas regras de eventos e permitem que você filtre por tipos específicos de eventos enviados ao seu barramento de eventos padrão. Modelos de padrões para cada tipo de evento estão disponíveis no EventBridge console. Na etapa de configuração do padrão de eventos, selecione AWS serviços como origem do evento e AWS Marketplace Agreements and Licenses como AWS serviço.
+ Todos os tipos de eventos do AWS Marketplace Agreements and Licenses usam a estrutura a seguir.
```
{
"detail-type": ["e.g. Purchase Agreement Ended - Manufacturer"],
"source": ["aws.agreement-marketplace"]
}
```
+ Os alvos são recursos que recebem eventos quando correspondem ao padrão de eventos definido para uma regra. Muitos AWS serviços se integram EventBridge e podem servir como alvos, incluindo funções Lambda, Step Functions e API Gateway.
Para obter mais informações sobre a configuração de EventBridge regras, consulte [Introdução: criar uma regra de barramento de EventBridge eventos da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html).
# Acessando o AWS Marketplace serviço de medição e direitos APIs
Esta seção descreve o processo de integração com o Serviço de medição do AWS Marketplace ou AWS Marketplace Entitlement Service, usados para garantir que o faturamento e o relatório sobre o uso do cliente de seus produtos de software como serviço (SaaS) sejam precisos. Supõe-se que você tenha enviado um produto de assinaturas SaaS ou um produto de contratos de SaaS que tenha sido publicado em um estado limitado. Em um estado limitado, você pode usar suas contas de teste para verificar a configuração e a função adequada, mas o seu produto não está disponível publicamente.
**nota**
Se seu produto SaaS estiver integrado a outro serviço AWS gerenciado que gerencia a medição de uma maneira diferente (como Amazon SageMaker Ground Truth ou AWS WAF), você não precisará se integrar ao serviço de medição do AWS Marketplace. A medição do seu produto só deve acontecer em um sistema para evitar a cobrança dupla do cliente.
**Topics**
+ [Configurar a medição para uso com assinaturas SaaS](metering-for-usage.md)
+ [Verificando direitos usando o AWS Marketplace Entitlement Service](checking-entitlements.md)
+ [Lista de verificação de integração de produtos de SaaS](aws-marketplace-integration-checklist.md)
Para obter informações sobre como configurar o AWS CLI, junto com as credenciais, consulte [Configurando o AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) no Guia do *AWS Command Line Interface Usuário*. [Se você não conhece o SDK para AWS Python, consulte o Guia de início rápido do Boto 3.](https://boto3.readthedocs.io/en/latest/guide/quickstart.html)
# Configurar a medição para uso com assinaturas SaaS
Para assinaturas de software como serviço (SaaS), você mede todo o uso e, em seguida, os clientes são cobrados AWS com base nos registros de medição que você fornece. Para os contratos de SaaS, você só mede o uso além das autorizações de contrato do cliente. As seções a seguir fornecem informações sobre como configurar a medição para uso com produtos SaaS.
Quando seu aplicativo mede o uso de um cliente, ele está AWS fornecendo uma quantidade de uso acumulada. Seu aplicativo mede as dimensões de definição de preço definidas quando você criou o produto, como os gigabytes transferidos ou os hosts verificados em uma hora específica. Por exemplo, se você cobrar com base na quantidade de dados enviados ao seu aplicativo, poderá medir a quantidade de dados e enviar um registro de medição correspondente uma vez por hora. AWS calcula a fatura de um cliente usando os dados de medição junto com os preços que você forneceu quando criou seu produto.
Para produtos que oferecem suporte a contratos simultâneos, a medição opera no nível da licença e não no nível do produto. Cada registro de uso deve incluir um `LicenseArn` para identificar a qual contrato específico o uso se aplica. `LicenseArn`É obtido da resposta da `ResolveCustomer` API durante o registro do SaaS. Isso permite que os compradores mantenham vários contratos ativos para o mesmo produto, com o uso rastreado e cobrado separadamente por contrato.
**nota**
Se desejar, você pode dividir o uso entre as propriedades rastreadas. Essas propriedades são expostas ao comprador como tags. Essas tags permitem que o comprador visualize os custos divididos em uso por valores de tag. Por exemplo, se você cobrar pelo usuário e os usuários tiverem uma propriedade `Department`, será possível criar alocações de uso com tags que tenham uma chave de `Department` e uma alocação por valor. Isso não altera o preço, as dimensões ou o uso total que você relata, mas permite que seu cliente visualize os custos por categorias apropriadas ao seu produto. Para obter mais informações, consulte [Marcação medida pelo fornecedor (opcional)](#saas-vendor-metered-tagging).
**Topics**
+ [Medidor por hora](#metering-hourly)
+ [Configurar o produto para medir o uso](#configure-application-for-meter-usage)
+ [Marcação medida pelo fornecedor (opcional)](#saas-vendor-metered-tagging)
## Medidor por hora
Recomendamos que você relate o uso de hora AWS em hora para todos os seus clientes em lotes de até 25 por vez. Isso dá aos clientes a maior visibilidade granular possível de seu uso e custos. Se você agregar o uso em períodos maiores que uma hora (por exemplo, um dia), observe as seguintes considerações.
+ AWS só pode cobrar dos clientes pelo uso de seu produto ao receber seus registros de medição. Você é responsável por garantir que os registros de medição do produto sejam transmitidos e recebidos com êxito. Você pode usar AWS CloudTrail para verificar se o registro ou registros enviados estão corretos. Você também pode usar as informações para realizar auditorias ao longo do tempo. Para obter mais informações, consulte [Registrando chamadas de AWS Marketplace API com AWS CloudTrail](cloudtrail-logging.md).
+ Se for um SaaS com o modelo de preços “Assinatura” (não os modelos de preços “Contrato” ou “Contrato com Consumo”), o comprador poderá cancelar a assinatura a qualquer momento. Quando o comprador iniciar essa ação de cancelamento de assinatura, o vendedor receberá uma `unsubscribe-pending` [notificação](saas-notification.md#saas-sns-subscription-message-body) e terá 1 hora para enviar todo o uso não declarado antes da notificação final `unsubscribe-success`. Qualquer coisa após a segunda notificação não será honrada. Os outros dois modelos de preços têm uma duração definida com base no momento da assinatura e o comprador não pode cancelar a assinatura durante a assinatura. Eles só podem desativar a renovação automática. A mesma notificação é enviada no final desse período, se não for renovada automaticamente.
+ Para produtos com contratos simultâneos: a notificação de cancelamento de assinatura e o período de 1 hora se aplicam por contrato individual, não por produto. Se um comprador cancelar um dos vários contratos ativos, você poderá continuar comparando as licenças ativas restantes. Somente o uso do contrato cancelado deve ser enviado dentro do período de 1 hora após o recebimento da `unsubscribe-pending` notificação dessa licença específica.
+ Se você não enviar registros de medição de hora em hora e houver uma interrupção na aplicação ou na rede, seus registros ficarão ainda mais atrasados. Isso pode resultar em uso não declarado se a interrupção da aplicação ou da rede for restaurada após a expiração da assinatura.
+ Mesmo que não haja uso para relatar, você pode continuar enviando registros de medição a cada hora e registrar uma quantidade de 0 se não houver uso para relatar nessa hora. Observe que depois de relatar o uso de uma dimensão 0 ou mais pelo comprador, você não pode alterar o registro. Portanto, é uma prática recomendada relatar o uso da hora anterior. O uso relatado permanece visível no console [Gerenciamento de Faturamento e Custos da AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html) do comprador ao longo de todo o ciclo de faturamento. O console mostra cada dimensão do seu produto em um item de linha separado com o número total de unidades consumidas e o custo total desse item de linha consumido nesse ciclo de cobrança ou até agora, mesmo que o preço da dimensão seja 0 USD por unidade. Se habilitado, o [Relatório de Custos e Uso da AWS (CUR)](https://docs.aws.amazon.com/cur/latest/userguide/what-is-data-exports.html) mostra esse detalhe, incluindo a taxa por unidade. Esses relatórios não são atualizados em tempo real.
+ Durante a publicação, a equipe de AWS Marketplace operações testará se o aplicativo SaaS envia o registro de medição com sucesso antes de permitir que o produto seja publicado. Normalmente, a equipe realiza uma inscrição simulada do SaaS e confirma que um registro de medição foi recebido.
**nota**
Se seu produto SaaS estiver integrado a outro serviço AWS gerenciado que gerencia a medição de uma maneira diferente (como Amazon SageMaker Ground Truth ou AWS WAF), você não precisará se integrar ao serviço de medição do AWS Marketplace. A medição do seu produto só deve acontecer em um sistema para evitar a cobrança dupla do cliente. Observe que AWS Marketplace não está publicando novos AWS WAF produtos no momento.
## Configurar o produto para medir o uso
Você usa a operação `BatchMeterUsage` no Serviço de medição do AWS Marketplace para fornecer os registros de medição à AWS. Lembre-se do seguinte:
+ É necessário que os vendedores usem o agrupamento em lotes usando a operação `BatchMeterUsage`.
+ Eliminamos a duplicação de solicitações de medição a cada hora.
+ Para produtos de contratos não simultâneos: as solicitações são desduplicadas por. product/customer/hour/dimension. For Concurrent Agreements products: Requests are deduplicated per license/customer/hour/dimension
+ É sempre possível repetir qualquer solicitação, mas, se você medir uma quantidade diferente, a quantidade original será cobrada. Para produtos de contratos simultâneos: tentar novamente com o mesmo `LicenseArn` é seguro e segue as regras padrão de desduplicação. No entanto, alternar entre `ProductCode` e `LicenseArn` para a mesma janela de uso causará cobrança duplicada.
+ Se você enviar várias solicitações para a mesmacustomer/dimension/hour, os registros não serão agregados.
+ Os vendedores podem enviar registros de medição com um registro de data e hora de até 6 horas no passado, se o cliente tiver assinado seu produto. Se o cliente cancelar a assinatura, os vendedores deverão enviar os registros de medição em até 1 hora após o cancelamento da assinatura do cliente.
+ As cargas `BatchMeterUsage` não devem exceder 1 MB. Escolha o número de registros de uso a serem enviados em uma solicitação `BatchMeterUsage` para que você não exceda o tamanho da carga.
+ *O AWS Marketplace Metering Service está disponível na Regiões da AWS lista de [AWS Marketplace endpoints e cotas na AWS Referência](https://docs.aws.amazon.com/general/latest/gr/aws-marketplace.html) geral.* Por padrão, a região Leste dos EUA (Norte da Virgínia) está habilitada para produtos de medição de SaaS quando você solicita o produto. Se você pretende usar outras regiões, entre em contato com a equipe de [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/). Para obter mais informações, consulte [BatchMeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_BatchMeterUsage.html).
+ Acordos simultâneos: um único cliente pode ter vários contratos ativos para seu produto. Cada contrato tem um contrato exclusivo `LicenseArn` e o uso é monitorado separadamente por licença. Analise a nova integração para acordos simultâneos [aqui.](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements) Para novas implementações, cada uma `UsageRecord` deve incluir um `LicenseArn` campo para identificar a qual contrato o uso se aplica. O `LicenseArn` é obtido da resposta `ResolveCustomer` da API.
**nota**
Para implementações existentes: ao migrar da medição baseada em produto para a medição baseada em licença, não envie registros de medição com ambos `LicenseArn` e `ProductCode` para o mesmo cliente na mesma hora. Isso resultará em cobrança duplicada. Não inclua `ProductCode` no nível da solicitação. O `LicenseArn` em cada um `UsageRecord` identifica o produto e o contrato específico.
Para obter exemplos de código, consulte [Exemplos de código para integração de produtos de SaaS](saas-code-examples.md).
### Exemplo: Verificação de host
O produto analisa o hardware computacional em busca de vulnerabilidades de segurança conhecidas. Os clientes iniciam manualmente ou programam essas verificações das instâncias do Amazon Elastic Compute Cloud (Amazon EC2). À medida que o produto executa essas verificações, ele registra o número de hosts exclusivos verificados a cada hora. Neste exemplo, o produto usa a categoria **Hosts**. Você pode declarar várias dimensões para os tipos de hosts verificados. Por exemplo, você pode cobrar preços diferentes para hosts pequenos, médios e grandes.
### Exemplo: Análise de log
Seu produto de SaaS digere logs gerados por produtos do cliente, relatando tendências e anomalias. À medida que os clientes fazem upload dos logs para o produto, meça a quantidade de dados recebidos em megabytes, gigabytes ou terabytes. No décimo minuto de cada hora, um trabalho cron lê esse uso de cada cliente para a hora anterior. O trabalho cria um relatório de lote e usa a operação `BatchMeterUsage` para enviá-lo para a AWS. Nesse exemplo, o produto usa a categoria **Dados**. O produto também pode medir a quantidade de dados de log armazenados para qualquer hora. Nesse caso, o produto pode medir duas dimensões em conjunto: os dados recebidos na hora e o total de dados armazenados na hora. Você pode continuar a medir os dados armazenados até que o cliente exclua esses dados ou até que eles expirem.
## 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.
Existem diversas maneiras de marcar o uso do software do comprador. Uma maneira é primeiro perguntar 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.
**nota**
Atualmente, a medição em nível de licença de contratos simultâneos não é suportada para produtos de marcação medida pelo fornecedor (VMT). Se seu produto usa VMT, continue usando a medição `ProductCode` padrão.
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` e enviá-los como uma das entradas em `UsageAllocations`.
Os limites incluem:
+ Número de tags: 5
+ Quantidade de `UsageAllocations` (cardinalidade): 2.500
+ Tamanho máximo da solicitação: 1 MB
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.
+ O tamanho máximo da carga não pode ser superior a 1 MB. Isso inclui chaves de atributos de entrada (por exemplo, `UsageRecords`, `AllocatedUsageQuantity`, tags).
**nota**
Para garantir que você não esteja ultrapassando o limite de carga, crie um objeto de solicitação de amostra com um tamanho máximo com base nos requisitos comerciais, converta o objeto em uma string JSON e obtenha o tamanho em bytes. Certifique-se de que uma única chamada de API não ultrapasse o limite de 1 MB. Por exemplo, se uma solicitação com um `UsageRecord` tiver um tamanho máximo de 200 KB, não envie mais de cinco `UsageRecords` como parte da solicitação (200 KB \$1 5 = 1 MB).
### 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 [Exemplo de código `BatchMeterUsage` com marcação de alocação de uso (opcional)](saas-code-examples.md#saas-batchmeterusage-tagging).
# Verificando direitos usando o AWS Marketplace Entitlement Service
Se seu produto for um produto contratado de SaaS, seu produto liga AWS Marketplace Entitlement Service para o para recuperar o direito do cliente usando a API. [GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html) Seu produto deve verificar o uso subsequente dessa conta em relação ao AWS Marketplace Entitlement Service. Por exemplo, se o cliente provisionar 10 usuários na conta, seu produto deverá verificar o AWS Marketplace direito a essa capacidade no Entitlement Service.
Para verificar o direito de um cliente ao seu produto, use a `GetEntitlements` operação no AWS Marketplace Entitlement Service. O AWS Marketplace Entitlement Service está disponível somente na região Leste dos EUA (Norte da Virgínia), acessível por meio `entitlement.marketplace.us-east-1.amazonaws.com` de ou. `entitlement-marketplace.us-east-1.api.aws`
`GetEntitlements`aceita o ID da conta da AWS, o identificador do cliente, o ARN da licença e a dimensão do cliente como filtros. `ProductCode`é um parâmetro obrigatório. A operação retorna uma lista paginada de autorizações. O resultado tem um campo `ExpirationDate` que mostra o período mínimo pelo qual a autorização é válida. Se o cliente tiver configurado a renovação automática, a data no ExpirationDate campo será a data de renovação.
Para obter exemplos de código, consulte [Exemplos de código para integração de produtos de SaaS](saas-code-examples.md).
## Recuperar autorização sobre ações do usuário
Os exemplos a seguir podem ajudar você a entender melhor o processo para recuperar autorizações sobre ações do usuário.
### Exemplo: Produto baseado em usuário
Você oferece um produto que permita um determinado número de contas para um cliente específico. O cliente pode acessar um painel para provisionar novos usuários (por exemplo, para atribuir credenciais). Quando o cliente provisiona um novo usuário, seu produto chama `GetEntitlements` para verificar se a capacidade existe. Caso contrário, você pode ligar para o Serviço de AWS Marketplace Medição para cobrar por usuários adicionais.
### Exemplo: Produto de armazenamento de dados
Você oferece um produto que permite que os clientes armazenem uma determinada quantidade de dados em formato criptografado ou não criptografado. O cliente pode visualizar um painel que exibe a quantidade de dados existentes e alocados em seu produto. Seu painel recupera a quantidade de alocação por meio de `GetEntitlements`.
# Lista de verificação de integração de produtos de SaaS
Antes de seu produto de software como serviço (SaaS) entrar em operação, você deve verificar se concluiu a configuração necessária. Você pode usar a seguinte lista de verificação de integração de SaaS para verificar se você concluiu as configurações necessárias.
| **Categoria** | **Requisitos** |
| --- | --- |
| Acesso | Enviou um formulário de registro de vendedor com a AWS conta desejada para AWS Marketplace uso. |
| Acesso | Conclusão do registro do vendedor, incluindo os termos e condições, a conta bancária e o formulário de impostos W8 ou W9. |
| Acesso | Funções de várias contas configuradas para a AWS Marketplace conta registrada. |
| Produto | Preenchimento do formulário de solicitação de produto no Portal de gerenciamento do AWS Marketplace. |
| Produto | AWS Conta fornecida IDs para testes na guia Notas do assistente de criação de produto no AMMP. |
| Produto | Fornecimento de um URL do EULA no formato.txt na guia Produtos. |
| Produto | Recebi seu código de produto e informações sobre tópicos do Amazon SNS de. AWS Marketplace |
| Produto | Assinatura no tópico do Amazon SNS e criação de uma fila do Amazon SQS para assinar o tópico do Amazon SNS. |
| Solução de faturamento | Validado, você pode enviar registros de medição para a BatchMeterUsage operação a cada hora para licenças de cada cliente para produtos de assinatura SaaS. É possível enviar registros de medição para uso adicional por cada cliente para produtos de contratos de SaaS. |
| Solução de faturamento | Validado, você pode verificar os direitos do cliente no AWS Marketplace Entitlement Service para produtos de contratos SaaS. |
| Solução de faturamento | Validação de que os custos aparecem como esperado nas faturas geradas para contas de teste. |
| Solução de faturamento | Testado para situações como clientes inválidos IDs e assinaturas canceladas. |
| Produto | Enviei a solicitação do produto de volta AWS Marketplace para publicação. |
| Registro | Implementação de uma página de registro HTTPS que pode aceitar solicitações HTTP POST. |
| Registro | Validação de que você pode aceitar novos registros de clientes. |
| Registro | Validação de que você não está armazenando o token de registro em um cookie. |
| Registro | Validado que você está usando ResolveCustomer para obter o ProductCodeCustomerAWSAccountId, e LicenseArn do AWS token. |
| Registro | Validado, você pode resolver o token de registro recebido AWS sem atrasos. |
| Registro | Teste se você não está bloqueado para registrar com endereços de serviços de e-mail, como o Gmail. |
| Registro | Teste de que você pode aceitar registros incompletos e várias tentativas de registro. |
| Assinatura | Teste de se você pode manipular as mensagens unsubscribe-pending e unsubscribe-success. |
| Assinatura | Validação de que você enviou registros de medição final em até uma hora após o recebimento de uma mensagem `unsubscribe-pending`. |
| Segurança | Validada, a conta AWS raiz não tem chaves de API, tem uma senha forte e está associada a um dispositivo de autenticação multifator (MFA) de hardware. Todo o acesso administrativo é feito por meio de identidades criadas com AWS Identity and Access Management (IAM). Nenhuma conta compartilhada. |
| Segurança | Validação de que os perfis do IAM são usados para todo o acesso programático do Amazon Elastic Compute Cloud (Amazon EC2). As credenciais não são codificadas em scripts, cabeçalhos ou código-fonte. |
| Segurança | Validação de que você mantém um registro em log e uma consolidação de log abrangentes. |
| Segurança | Verificação de se você tem limites de sub-redes privada e pública bem-definidos que isolam serviços de aplicativos e acesso a banco de dados e a sistemas de arquivos. Definições distintas de classes de dados que demarcam dados confidenciais e segregam dados públicos e privados. |
| Segurança | Verificação de que você tem criptografia de dados privados em trânsito e em repouso com alternância programada de chaves. |
| Segurança | Validação de que você tem ferramentas para incidentes de segurança e acesso estabelecidos e exercícios de resposta a incidentes programados rotineiramente que acomodem investigação e recuperação em tempo hábil. |
| Confiabilidade | Verificação de que o sistema se adapta às alterações na demanda expandindo e reduzindo, conforme necessário, e emprega o balanceamento de carga para garantir alto desempenho. O sistema também fornece cache baseado em presença, conforme necessário. |
| Confiabilidade | Validação de que o tempo de recuperação e os objetos pontuais estão especificados e a recuperação de desastres está programada em intervalos regulares. A falha do componente é de autorrecuperação por meio de triggers automatizados e notificações. |
# Relatórios para produtos SaaS em AWS Marketplace
AWS Marketplace produz relatórios para seus produtos de software como serviço (SaaS) que incluem dados sobre assinantes, finanças, uso e impostos. A tabela a seguir fornece as informações sobre os relatórios disponíveis. Você pode usar relatórios para obter mais informações sobre sua base de clientes e entender melhor suas finanças, incluindo vendas e impostos. A tabela a seguir resume como as finanças são relatadas para os produtos de SaaS.
| Relatório | Conteúdo de SaaS |
| --- | --- |
| Relatório diário de negócios | As cobranças de contrato de pagamento adiantado são exibidas na seção **Taxas**. As cobranças de uso medidas são exibidas na seção **Uso**. |
| Relatório da receita mensal | As cobranças de contrato de pagamento adiantado são exibidas na seção **Assinaturas anuais**. As cobranças de uso medidas são exibidas na seção **Dados de faturamento e receita**. |
| Relatório de compensação de vendas | As cobranças de contrato de pagamento adiantado e as cobranças de uso adicional mensais são exibidas como itens de linha separados. |
| Relatório de clientes assinantes | Os novos contratos de SaaS são exibidos na seção **Assinaturas anuais**. As novas assinaturas de SaaS são exibidas na seção **Assinaturas por hora/mensais**. |
# Exemplos de código para integração de produtos de SaaS
Você pode usar os exemplos de código a seguir para integrar seu produto de software como serviço (SaaS) com AWS Marketplace APIs o necessário para publicar e manter seu produto. Para obter mais informações, consulte as seções a seguir.
**Topics**
+ [Exemplo de código `ResolveCustomer`](#saas-resolvecustomer-example)
+ [Exemplo de código `GetEntitlement`](#saas-getentitlement-example)
+ [Exemplo de código `BatchMeterUsage`](#saas-batchmeterusage-example)
+ [`BatchMeterUsage`exemplo de código: Com ARN de licença](#saas-batchmeterusage-licensearn-example)
+ [Exemplo de código `BatchMeterUsage` com marcação de alocação de uso (opcional)](#saas-batchmeterusage-tagging)
## Exemplo de código `ResolveCustomer`
O exemplo de código a seguir é relevante para todos os modelos de definição de preço. O exemplo do Python troca um `x-amzn-marketplace-token` token por um`CustomerIdentifier`, `ProductCode``LicenseArn`, e. `CustomerAWSAccountId` `CustomerAWSAccountId`É o Conta da AWS ID associado à assinatura e `LicenseArn` é um identificador exclusivo para uma licença específica concedida. Eles são usados para software adquirido por meio de AWS Marketplace. Este código é executado em um aplicativo em seu site de registro, quando o Portal de gerenciamento do AWS Marketplace o redireciona para lá. O redirecionamento é uma solicitação POST que inclui o token.
Para obter mais informações sobre`ResolveCustomer`, consulte [ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)na *Referência da API do AWS Marketplace Metering Service*.
**nota**
Para uma nova implementação ou ao atualizar sua integração, use o AWSAccount ID do cliente em vez de CustomerIdentifier.
```
# Import AWS Python SDK and urllib.parse
import boto3
import urllib.parse as urlparse
# Resolving Customer Registration Token
formFields = urlparse.parse_qs(postBody)
regToken = formFields['x-amzn-marketplace-token'][0]
# If regToken present in POST request, exchange for customerID
if (regToken):
marketplaceClient = boto3.client('meteringmarketplace')
customerData = marketplaceClient.resolve_customer(RegistrationToken=regToken)
productCode = customerData['ProductCode']
customerID = customerData['CustomerIdentifier']
customerAWSAccountId = customerData['CustomerAWSAccountId']
licenseARN = customerData['LicenseArn']
# TODO: Store customer information
# TODO: Validate no other accounts share the same customerID
```
### Exemplo de resposta
```
{
'CustomerIdentifier': 'string',
'CustomerAWSAccountId':'string',
'ProductCode': 'string',
'LicenseArn' : 'string'
}
```
## Exemplo de código `GetEntitlement`
O exemplo de código a seguir é relevante para produtos de SaaS com contrato e contrato de SaaS com modelo de definição de preço de consumo. O exemplo Python verifica se um cliente tem uma autorização ativa.
Para obter mais informações sobre`GetEntitlement`, consulte a Referência [GetEntitlement](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)da *API do AWS Marketplace Entitlement Service*.
```
# Import AWS Python SDK
import boto3
marketplaceClient = boto3.client('marketplace-entitlement', region_name='us-east-1')
# Filter entitlements for a specific customerID
#
# productCode is supplied after the AWS Marketplace Ops team has published
# the product to limited
#
# customerID is obtained from the ResolveCustomer response
entitlement = marketplaceClient.get_entitlements({
'ProductCode': 'productCode',
'Filter' : {
# Option 1: Using CustomerIdentifier (for new or updated integrations, use the customer AWS account ID)
'CUSTOMER_IDENTIFIER': [
'customerID',
]
# Option 2: Using CustomerAWSAccountId (preferred)
# 'CUSTOMER_AWS_ACCOUNT_ID': [
# 'awsAccountId',
# ]
# Option 3: Using LICENSE_ARN (to get entitlements for the license)
# 'LICENSE_ARN': [
# 'licenseARN',
# ]
},
'NextToken' : 'string',
'MaxResults': 123
})
# TODO: Verify the dimension a customer is subscribed to and the quantity,
# if applicable
```
### Exemplo de resposta
O valor retornado corresponde às dimensões criadas quando você criou o produto no Portal de gerenciamento do AWS Marketplace.
```
{
"Entitlements": [
{
"CustomerIdentifier": "string",
"CustomerAWSAccountId": "string",
"Dimension": "string",
"ExpirationDate": number,
"ProductCode": "string",
"LicenseArn": "string",
"Value": {
"BooleanValue": boolean,
"DoubleValue": number,
"IntegerValue": number,
"StringValue": "string"
}
}
],
"NextToken": "string"
}
```
## Exemplo de código `BatchMeterUsage`
O exemplo de código a seguir é relevante para assinatura SaaS e contrato com modelos de definição de preço de consumo, mas não para produtos de contrato de SaaS sem consumo. O exemplo do Python envia um registro de medição 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
#
# You can use either:
# - customerID from the ResolveCustomer response
# - AWS account ID of the buyer
# Import AWS Python SDK
import boto3
from datetime import datetime
# Option 1: Using CustomerIdentifier (for new or updated integrations, use the customer AWS account ID)
usageRecord = [
{
'Timestamp': datetime(2015, 1, 1),
'CustomerIdentifier': 'customerID',
'Dimension': 'string',
'Quantity': 123
}
]
# Option 2: Using CustomerAWSAccountId (preferred)
# usageRecord = [
# {
# 'Timestamp': datetime(2015, 1, 1),
# 'CustomerAWSAccountId': 'awsAccountId',
# 'Dimension': 'string',
# 'Quantity': 123
# }
# ]
marketplaceClient = boto3.client('meteringmarketplace')
response = marketplaceClient.batch_meter_usage(
UsageRecords=usageRecord,
ProductCode='productCode'
)
```
Para obter mais informações sobre`BatchMeterUsage`, consulte [BatchMeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_BatchMeterUsage.html)na *Referência da API do AWS Marketplace Metering Service*.
### Exemplo de resposta
```
{
'Results': [
{
'UsageRecord': {
'Timestamp': datetime(2015, 1, 1),
'CustomerIdentifier': 'string',
'CustomerAWSAccountId': 'string',
'Dimension': 'string',
'Quantity': 123
},
'MeteringRecordId': 'string',
'Status': 'Success' | 'CustomerNotSubscribed' | 'DuplicateRecord'
},
],
'UnprocessedRecords': [
{
'Timestamp': datetime(2015, 1, 1),
'CustomerIdentifier': 'string',
'CustomerAWSAccountId': 'string',
'Dimension': 'string',
'Quantity': 123
}
]
}
```
## `BatchMeterUsage`exemplo de código: Com ARN de licença
O exemplo de código a seguir é relevante para produtos SaaS que oferecem suporte a contratos simultâneos. Os `LicenseArn` e `CustomerAWSAccountId` são retornados pela `ResolveCustomer` API quando um comprador se registra no seu produto.
```
# 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.
#
# LicenseArn and CustomerAWSAccountId are returned by the ResolveCustomer
# API when a buyer registers to your product
# Import AWS Python SDK
import boto3
from datetime import datetime
usageRecord = [{
'LicenseArn' : 'licenseArn',
'Timestamp': datetime(2015, 1, 1),
'CustomerAWSAccountId': 'awsAccountId',
'Dimension': 'string',
'Quantity': 123
}]
marketplaceClient = boto3.client('meteringmarketplace')
response = marketplaceClient.batch_meter_usage(
UsageRecords = usageRecord
)
```
### Exemplo de resposta
```
{
'Results': [
{
'UsageRecord': {
'Timestamp': datetime(2015, 1, 1),
'CustomerIdentifier': 'string',
'CustomerAWSAccountId': 'string',
'Dimension': 'string',
'Quantity': 123,
'LicenseArn': 'string'
},
'MeteringRecordId': 'string',
'Status': 'Success' | 'CustomerNotSubscribed' | 'DuplicateRecord'
},
],
'UnprocessedRecords': [
{
'Timestamp': datetime(2015, 1, 1),
'CustomerIdentifier': 'string',
'CustomerAWSAccountId': 'string',
'Dimension': 'string',
'Quantity': 123,
'LicenseArn': 'string'
}
]
}
```
## Exemplo de código `BatchMeterUsage` com marcação de alocação de uso (opcional)
O exemplo de código a seguir é relevante para assinatura de SaaS e contrato com modelos da definição de preço do consumo, mas não para produtos de contrato de SaaS sem uso. 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
#
# You can use either:
# - customerID from the ResolveCustomer response
# - AWS account ID of the buyer
# Import AWS Python SDK
import boto3
import time
# Option 1: Using CustomerIdentifier (for new or updated integrations, use the customer AWS account ID)
usageRecords = [
{
"Timestamp": int(time.time()),
"CustomerIdentifier": "customerID",
"Dimension": "Dimension1",
"Quantity": 3,
"UsageAllocations": [
{
"AllocatedUsageQuantity": 2,
"Tags": [
{ "Key": "BusinessUnit", "Value": "IT" },
{ "Key": "AccountId", "Value": "*********" },
]
},
{
"AllocatedUsageQuantity": 1,
"Tags": [
{ "Key": "BusinessUnit", "Value": "Finance" },
{ "Key": "AccountId", "Value": "*********" },
]
},
]
}
]
# Option 2: Using CustomerAWSAccountId (preferred)
# usageRecords = [
# {
# "Timestamp": int(time.time()),
# "CustomerAWSAccountId": "awsAccountId",
# "Dimension": "Dimension1",
# "Quantity": 3,
# "UsageAllocations": [
# {
# "AllocatedUsageQuantity": 2,
# "Tags": [
# { "Key": "BusinessUnit", "Value": "IT" },
# { "Key": "AccountId", "Value": "*********" },
# ]
# },
# {
# "AllocatedUsageQuantity": 1,
# "Tags": [
# { "Key": "BusinessUnit", "Value": "Finance" },
# { "Key": "AccountId", "Value": "*********" },
# ]
# },
# ]
# }
# ]
marketplaceClient = boto3.client('meteringmarketplace')
response = marketplaceClient.batch_meter_usage(
UsageRecords=usageRecords,
ProductCode="testProduct"
)
```
Para obter mais informações sobre`BatchMeterUsage`, consulte [BatchMeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_BatchMeterUsage.html)na *Referência AWS Marketplace Metering Service da API*.
### Exemplo de resposta
```
{
"Results": [
{
"Timestamp": "1634691015",
"CustomerIdentifier": "customerId",
"CustomerAWSAccountId": "awsAccountId",
"Dimension": "Dimension1",
"Quantity": 3,
"UsageAllocations": [
{
"AllocatedUsageQuantity": 2,
"Tags": [
{ "Key": "BusinessUnit", "Value": "IT" },
{ "Key": "AccountId", "Value": "*********" }
]
},
{
"AllocatedUsageQuantity": 1,
"Tags": [
{ "Key": "BusinessUnit", "Value": "Finance" },
{ "Key": "AccountId", "Value": "*********" }
]
}
],
"MeteringRecordId": "8fjef98ejf",
"Status": "Success"
}
],
"UnprocessedRecords": [
{
"Timestamp": "1634691015",
"CustomerIdentifier": "customerId",
"CustomerAWSAccountId": "awsAccountId",
"Dimension": "Dimension1",
"Quantity": 3,
"UsageAllocations": []
}
]
}
```
# Entregando seus produtos por meio de uma Amazon VPC usando AWS PrivateLink
AWS Marketplace suporta AWS PrivateLink, e AWS service (Serviço da AWS) isso permite que você use a rede Amazon para fornecer aos compradores acesso aos produtos por meio dos quais você vende AWS Marketplace. As seções a seguir descrevem o processo de configuração e entrega de seus produtos por meio de um endpoint Amazon Virtual Private Cloud (VPC) usando tecnologia. AWS PrivateLink
Este tópico pressupõe que você tenha conhecimento prático de vários AWS serviços e do AWS Marketplace ambiente.
**Topics**
+ [Introdução](#introduction)
+ [Configurar o produto](#configuring-your-product)
+ [Enviando seu produto para AWS Marketplace](#submitting-your-product-to-aws-marketplace)
+ [Acesso do comprador aos VPC endpoints](#customer-access-to-vpc-endpoints)
+ [Apêndice: Listas de verificação](#appendix-checklists)
## Introdução
Como AWS Marketplace vendedor, você pode fornecer aos compradores acesso ao seu serviço por meio de um endpoint Amazon VPC. Essa abordagem fornece aos compradores acesso ao seu serviço em toda a rede da Amazon usando a tecnologia [AWS PrivateLink](https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Introduction.html#what-is-privatelink). Se você costuma AWS Marketplace criar e entregar essa oferta, os compradores podem descobrir seu serviço em AWS Marketplace. Os compradores também encontram seu produto na lista de serviços disponíveis para a criação de um VPC endpoint.
![\[Diagram showing AWS PrivateLink connectivity between buyer and seller VPCs. The diagram illustrates how a buyer application in one VPC connects to seller services in another VPC through private endpoints, bypassing the public internet. Blue arrows show the connection flow through interface endpoints to multiple service instances.\]](http://docs.aws.amazon.com/pt_br/marketplace/latest/userguide/images/private-endpoint-diagram.png)
Um [VPC endpoint](https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-endpoints.html) é um dispositivo virtual que permite AWS aos clientes criar uma conexão privada entre sua VPC e outro AWS serviço sem exigir acesso pela Internet, por meio de um dispositivo NAT, uma conexão VPN ou. Direct Connect Você pode criar um serviço de endpoint AWS Marketplace que possibilite que os compradores usem essa tecnologia para se conectar ao seu serviço. Esse método de conexão é mais seguro para seus compradores porque eles acessam seu serviço pela rede privada da Amazon em vez de pela Internet.
Em cada região onde deseja oferecer seu serviço, você cria ou usa recursos existentes para configurar uma VPC, configurar suas instâncias de serviço, configurar um load balancer de rede e registrar seus serviços com o load balancer de rede criando um endpoint de serviço. Depois que concluir essas etapas e testar a oferta, forneça as informações de configuração à equipe de [operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/).
AWS recomenda que você forneça um nome DNS privado que seus compradores possam usar ao criar VPC endpoints.
Quando os compradores criam VPC endpoints, eles têm a opção de habilitar um nome DNS privado. Ao escolher essa opção, o serviço de VPC do comprador configura uma [zona hospedada privada](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-private.html). Se você fornecer o nome DNS privado, os compradores poderão usá-lo ao configurar VPC endpoints para se conectar ao seu serviço. Na zona hospedada privada do comprador, o nome DNS privado (api.example.com) apontará para os nomes DNS gerados aleatoriamente (vpce-11111111111111111-yyyyyyyy.api.vpce.example.com) criados para os serviços de endpoint. As EC2 instâncias do comprador chamam o mesmo nome DNS unificado (api.example.com) em diferentes. VPCs Além disso, se os nomes DNS públicos e privados forem iguais, o comprador poderá usar o mesmo nome público ao acessar seu serviço de dentro ou de fora da VPC.
Para obter ajuda para disponibilizar seu serviço AWS Marketplace, entre em contato com a equipe de [operações do AWS Marketplace vendedor](https://aws.amazon.com/marketplace/management/contact-us/). **Quando um AWS Marketplace comprador assina seu serviço e cria um VPC endpoint, seu serviço é exibido em Seus serviços. AWS Marketplace ** A equipe de operações do AWS Marketplace vendedor usa o nome DNS fácil de usar para facilitar a descoberta do seu serviço ao criar o VPC endpoint.
Seu produto é criado como um produto de software como serviço (SaaS). A medição e o faturamento são iguais aos de outros produtos SaaS AWS Marketplace .
## Configurar o produto
Para configurar seu produto para que seja disponibilizado por meio de um Amazon VPC endpoint:
1. Crie ou use uma [Amazon VPC](https://aws.amazon.com/documentation/vpc/) existente.
1. Crie (ou use) EC2 instâncias existentes da [Amazon](https://aws.amazon.com/documentation/ec2/) para seu produto.
1. Crie um [balanceador de carga de rede](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-getting-started.html) em cada uma das regiões em que você oferece seu produto. AWS recomenda que você inclua todas as [zonas de disponibilidade](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html) (AZs) de uma região.
1. Use o console Amazon VPC, a CLI ou suporte para SDKs criar um serviço de endpoint de VPC.
1. Verifique se você pode acessar o serviço por meio do load balancer de rede.
1. [Solicite um certificado do AWS Certificate Manager (ACM)](https://docs.aws.amazon.com/acm/latest/userguide/gs-acm-request.html) para seu nome DNS fácil de usar. Para que o ACM emita um certificado, ele valida se você possui ou controla os nomes de domínio em sua solicitação de certificado.
1. Delegue o subdomínio do seu nome DNS fácil de usar, como api.vpce.example.com, aos servidores de nomes fornecidos pela equipe de operações do vendedor. AWS Marketplace Em seu sistema DNS, você deve criar um registro de recurso de servidor de nomes (NS) para direcionar esse subdomínio para os servidores de nomes do Amazon Route 53 fornecidos pela equipe de operações do AWS Marketplace vendedor para que os nomes DNS (como vpce-0ac6c347a78c90f8.api.vpce.example.com) possam ser resolvidos publicamente.
1. Permita o acesso às AWS contas dos seus compradores.
**Observação**: você pode usar um SDK compatível ou esse comando da CLI para automatizar o acesso às contas: aws modify-vpc-endpoint-service vpcev2 -permissions --service-id vpce-svc-0123456789abcdef1 -- arn:aws:iam: :111111111111:root arn:aws:iam: :2222222222:root. add-allowed-principals
## Enviando seu produto para AWS Marketplace
Durante o processo de publicação do seu serviço no AWS Marketplace, você trabalha com a equipe de operações do AWS Marketplace vendedor. Para enviar seu produto PrivateLink habilitado:
1. Envie por e-mail as seguintes informações para a equipe de [operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/):
1. O endpoint e a AWS conta usados para criar o endpoint. O endpoint será semelhante a este: com.amazonaws.vpce.us-east-1.vpce-svc-0daa010345a21646
1. O nome DNS amigável de seu serviço. Esse é o nome DNS que AWS Marketplace os compradores usam para acessar seu produto.
1. A AWS conta que você usou para solicitar certificados e o nome DNS privado que os compradores usam para acessar o VPC endpoint.
A equipe de operações do AWS Marketplace vendedor verifica a identidade da sua empresa e o nome DNS a ser usado no serviço que você está registrando (como api.vpce.example.com). Após a verificação, o nome DNS substitui o nome DNS do endpoint base padrão.
## Acesso do comprador aos VPC endpoints
AWS Marketplace os compradores que estão criando um VPC endpoint podem descobrir seu serviço nas seguintes situações:
+ Você seguiu os processos do vendedor descritos anteriormente nesta página para criar ou usar um produto existente.
+ O comprador assina seu serviço.
+ Você adicionou a AWS conta do comprador à sua lista de contas permitidas.
Quando o comprador cria o VPC endpoint, ele tem a opção de associar uma zona hospedada privada com sua VPC. A zona hospedada contém um conjunto de registros para o nome do DNS privado padrão do serviço que resolve para o endereço IP privado das interfaces de rede do endpoint em sua VPC.
Qualquer endpoint hospedado pelo comprador, incluindo AWS Marketplace serviços, pode fornecer permissões para todas as contas (a permissão “\$1”). No entanto, quando você usa essa abordagem, os serviços não são incluídos em chamadas **Describe** ou no console, a menos que você pesquise pelo nome do serviço. Para exibir os serviços nas chamadas **descritas**, a AWS conta do comprador deve ser adicionada explicitamente à lista de permissões pelo serviço.
Para acessar seu serviço, os compradores fazem o seguinte:
1. Descubra e assine seu serviço em AWS Marketplace.
1. Use o AWS Command Line Interface (AWS CLI), a API ou o console Amazon VPC para descobrir seu serviço e, em seguida, estabelecer um VPC endpoint para se conectar ao seu serviço nas sub-redes e elas usam. AZs Os endpoints são exibidos como interfaces de rede elástica nas sub-redes. Endereços IP locais e nomes DNS de região e de zona são atribuídos aos endpoints.
| **Nome DNS do lado do cliente** | **Nome** |
| --- | --- |
| Regional | Vpce<0dc9a211a78c90f8>.api.vpce.example.com |
| IAD2 (1a) | **us-east-1a**-Vpce<0dc9a211a78c90f8>.api.vpce.example.com |
| IAD2 (1b) | **us-east-1b**-Vpce<0dc9a211a78c90f8>.api.vpce.example.com |
Se você tiver fornecido um nome DNS privado padrão e se o comprador escolher **Habilitar nome DNS privado** (associado uma zona hospedada privada) ao criar um endpoint da VPC, o comprador verá o nome DNS privado padrão regional para conectar-se a seu serviço.
| **Nome** | **Alias** | **ID da zona hospedada do alias** | **(Observações)** |
| --- | --- | --- | --- |
| api.example.com | vpce<0dc9a211a78c90f8>. api.vpce.example.com | Z00AABBCCDD | IAD1 IAD2 |
## Apêndice: Listas de verificação
Use as listas de verificação a seguir para garantir que você configure e teste seu produto antes de enviá-lo à equipe de operações do AWS Marketplace vendedor.
### Lista de verificação de criação do produto
+ Criar (ou usar uma existente) VPC e, em seguida, configurá-la.
+ Criar e configurar um load balancer de rede na VPC.
+ Registrar o serviço com seu load balancer de rede criando um serviço de VPC endpoint.
+ Forneça o ID da AWS conta que você usou para configurar o VPC endpoint para a equipe de operações do AWS Marketplace vendedor.
+ Forneça o nome padrão do serviço de endpoint (por exemplo, com.amazonaws.vpce.us-east-1.vpce-svc-0bbb070044a2164) para a equipe de operações do vendedor. AWS Marketplace
+ Fornecer um nome DNS amigável do serviço (obrigatório) para substituir o nome DNS do serviço gerado aleatoriamente. Solicitar certificados SSL do ACM para o subdomínio usado para seu nome DNS amigável do serviço. Forneça esses certificados e o ID da AWS conta que você usou para solicitá-los à equipe de operações do AWS Marketplace vendedor.
+ Recomendado: forneça um nome DNS privado.
+ Crie um processo para informar e permitir que seus AWS Marketplace compradores tenham a opção de se conectar ao seu serviço usando a AWS PrivateLink tecnologia. Adicione a AWS conta IDs de seus compradores à sua lista de contas permitidas.
### Teste do produto
+ Verifique se o serviço está configurado e pode ser detectado.
+ Verifique se o serviço pode ser detectado no load balancer de rede.
+ Verifique se um comprador pode criar um VPC endpoint e acessar seu serviço. Use uma AWS conta de sua propriedade que não seja a conta que você usou para configurar seu serviço.
# Solução de problemas de produtos de SaaS
Os tópicos a seguir explicam como resolver problemas comuns de produtos de SaaS e mensagens de erro no AWS Marketplace.
## Mensagens de erro de SaaS comuns
A tabela a seguir lista as mensagens de erro de SaaS mais comuns e as soluções.
| Mensagem de erro | Solução |
| --- | --- |
| Falha na criação do contrato por causa de problemas de conformidade do vendedor ou uma moeda de oferta não compatível na região. Entre em contato com o vendedor para garantir que a oferta correta seja estendida a você. | Por projeto, o AWS Marketplace impede que os vendedores comprem os próprios produtos. Use uma conta diferente e permita listar essa conta para fins de teste do produto. Para obter mais informações, consulte [Definindo as configurações do produto SaaS em AWS Marketplace](saas-product-settings.md). |
| O UsageBasedPricingTerm não poderá ser atualizado até xxx-xx-xxT00:00:00Z porque você solicitou um aumento de preço nos últimos 120 dias. | O produto pode ter assinaturas ativas. Por causa dessas assinaturas ativas, você precisa aguardar que a data de alteração efetiva passe antes de modificar o anúncio. Esse é um procedimento padrão para garantir a continuidade do serviço para os assinantes atuais. Em caso de dúvida ou se você precisar de mais assistência, entre em contato com a equipe de [operações do vendedor do AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/). |
| INVALID\$1FULFILLMENT\$1URL Forneça o formato correto para o URL de preenchimento. Começar por “https: //” | Verificar se o URL começa com `https://` ou `http://` Validar o formato e a acessibilidade do URL Testar o endpoint de preenchimento antes do envio Formato correto: [https://your-saas-app.com/fulfillment](https://your-saas-app.com/fulfillment) Para obter mais informações, consulte [Definindo as configurações do produto SaaS em AWS Marketplace](saas-product-settings.md). |
| Você não tem permissões suficientes para acessar esta página. | Se você encontrar um erro ao selecionar a guia **Ofertas** no Portal de gerenciamento do AWS Marketplace, verifique se você atende aos pré-requisitos em Para obter mais informações, consulte *Como um vendedor pode resolver erros ao acessar a guia Ofertas* em [Perguntas frequentes sobre oferta privada](private-offer-faq.md), anteriormente neste guia. |
| INVALID\$1MEDIA\$1LOCATION | Verificar se os URLs do Amazon S3 estão acessíveis e devidamente formatados https://s3.amazonaws.com/your-bucket/your-logo.png Requisitos do logotipo: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/marketplace/latest/userguide/troubleshoot-saas.html) |
| Remover caracteres incompatíveis | `¦`, `§`, `'`, `—`, `–`, `•` Usar caracteres ASCII padrão em descrições de produto Para obter mais informações, consulte [Fornecimento de metadados para produtos AWS Marketplace](categories-and-metadata.md) anteriormente neste guia. |
| DUPLICATE\$1SELLER\$1ENTITY Já existe uma entidade vendedora para a conta. | Verificar o status de registro do vendedor existente Usar `UpdateSeller`, em vez de `CreateSeller` para modificações Entre em contato com o suporte do AWS Marketplace se o registro duplicado persistir Para obter mais informações, consulte [Processo de registro](registration-process.md) anteriormente neste guia. |
| SELLER\$1ENTITLEMENT\$1EXISTS Esta entidade principal já tem o direito de ser vendedor no AWS Marketplace. | Verificar o status do vendedor atual no Portal de gerenciamento do AWS Marketplace Usar operações de atualização indicadas, em vez da criação Revisar permissões e perfis do IAM Para obter mais informações, consulte [Processo de registro](registration-process.md) anteriormente neste guia. |
| UNSUPPORTED\$1DELIVERY\$1OPTION Os produtos de SaaS com base em URL padrão existentes não podem ser atualizados para usar as opções de entrega da API. | Criar novo produto para entrega com base em API Você não pode converter entre produtos de SaaS com base em URL e API Planejar arquitetura do produto antes da criação inicial |
| INCOMPATIBLE\$1DELIVERY\$1OPTION\$1TYPES Você forneceu um `ApiDeliveryOption` para um produto que já contém `SaaSUrlDeliveryOptions`. | Criar produtos à parte para diferentes tipos de entrega Escolher a entrega com base em API ou URL na criação do produto Revisar requisitos de produto antes da configuração |