View a markdown version of this page

Notas da versão - AWS Central de Parceiros

A referência AWS Partner Central da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a Referência AWS Partner Central da API.

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á.

Notas da versão

Esta página contém um resumo das mudanças significativas na documentação da API do AWS Partner Central, começando com a atualização mais recente.

Histórico de revisões
Alteração Descrição Data
ARCO 6.0

  • O AWS Partner Central adicionou novas APIs de medição de receita de parceiros.

 2026-06-30
ARCO 5.3

  • Atualizações do ACE Resonate: GetAwsOpportunitySummary resposta atualizada.

 2026-06-16
ARCO 5.2

  • Suporte monetário EUR: CreateOpportunityUpdateOpportunity,, e CreateEngagementInvitation agora aceita, EUR além do código USD de moeda MRR. Quando a partição da AWS é aws-eusc (AWS European Sovereign Cloud), o código da moeda deve serEUR.

  • EUR em operações de leitura: GetOpportunityListOpportunities,, e GetAwsOpportunitySummary agora retorne EUR ao CurrencyCode campo para oportunidades na aws-eusc partição.

 2026-03-30
ARCO 5.1

  • Suporte monetário EUR: CreateOpportunityUpdateOpportunity,, e CreateEngagementInvitation agora aceita, EUR além do código USD de moeda MRR. Quando a partição da AWS é aws-eusc (AWS European Sovereign Cloud), o código da moeda deve serEUR.

  • EUR em operações de leitura: GetOpportunityListOpportunities,, e GetAwsOpportunitySummary agora retorne EUR ao CurrencyCode campo para oportunidades na aws-eusc partição.

 2026-03-30
ARCO 5

  • API de conta introduzida: foi adicionada uma nova API de conta ao AWS Partner Central, permitindo que os parceiros gerenciem as informações da conta, o registro, os perfis, o gerenciamento de domínio e as conexões de parceiros.

  • Documentação de referência da API da conta: foi adicionada uma documentação abrangente de referência da API para a API da conta, incluindo registro de parceiros, gerenciamento de perfil, verificação de domínio e fluxos de trabalho de conexão de conta.

  • Registro da API da conta: foi adicionado suporte de registro e documentação para a API da conta para ajudar a auditar e monitorar o uso da API.

  • Notificações da API da conta: foi adicionado suporte à notificação de eventos para a API da conta, permitindo que os parceiros recebam atualizações em tempo real sobre as atividades relacionadas à conta, incluindo conexões da conta do parceiro.

  • Cotas da API da conta: foi adicionada a documentação de cotas de serviço para a API da conta.

  • Teste de sandbox para a API de contas: foram adicionados recursos de teste de sandbox para a API de contas, permitindo que os parceiros testem fluxos de trabalho de gerenciamento de contas em um ambiente que não seja de produção.

  • API de benefícios introduzida: foi adicionada uma nova API de benefícios ao AWS Partner Central, permitindo que os parceiros descubram, se inscrevam e gerenciem benefícios em todos os programas de AWS parceiros por meio de uma interface centralizada.

  • Documentação de referência da API de benefícios: foi adicionada uma documentação de referência abrangente da API de benefícios para a API de benefícios, alocações e processos de atendimento.

  • Registro da API de benefícios: foi adicionado suporte de registro e documentação para a API de benefícios para ajudar a auditar e monitorar o uso da API.

  • Notificações da API de benefícios: foi adicionado suporte à notificação de eventos para a API de benefícios, permitindo que os parceiros recebam atualizações em tempo real sobre solicitações e alocações de benefícios.

  • Cotas da API de benefícios: foi adicionada a documentação de cotas de serviço para a API de benefícios.

  • Teste de sandbox para API de benefícios: foram adicionados recursos de teste de sandbox para a API de benefícios, permitindo que os parceiros testem fluxos de trabalho de gerenciamento de benefícios em um ambiente não produtivo.

  • API de vendas atualizada: ações aprimoradas de engajamento da API de vendas para apoiar o fluxo de trabalho de gerenciamento de leads.

  • Atualizações da documentação da API de venda: documentação aprimorada da API de vendas com estrutura aprimorada e fluxos de trabalho atualizados para gerenciamento de leads.

  • Venda de atualizações de notificações da API: documentação aprimorada de notificação de eventos para eventos de engajamento e convite de engajamento.

  • Expansão da estrutura da API: estrutura de documentação expandida para oferecer suporte a quatro APIs distintas (conta, benefícios, vendas e canal) com seções dedicadas para as permissões, registros, notificações, cotas e testes de sandbox de cada API.

  • Documentação aprimorada de uso da API: foram adicionados guias de uso abrangentes para APIs de contas e benefícios com fluxos de trabalho detalhados e padrões de integração.

  • Documentação das regiões suportadas: foi adicionada documentação para AWS as regiões compatíveis com as APIs de contas e benefícios.

  • Novo filtro paraListOpportunities: TargetCloseDate filtro adicionado para permitir filtrar oportunidades de acordo com a data de fechamento esperada, uso AfterTargetCloseDate e BeforeTargetCloseDate campos em YYYY-MM-DD formato.

 2025-11-30
ARCO 4

  • API de canal introduzida: foi adicionada uma nova API de canal ao AWS Partner Central, permitindo que os parceiros gerenciem relacionamentos entre canais e colaborações entre parceiros.

  • Documentação de referência da API do canal: foi adicionada uma documentação de referência abrangente da API do canal, incluindo todas as ações e modelos de dados disponíveis.

  • Permissões da API do canal: foram adicionadas políticas de permissão do IAM e documentação de controle de acesso específicas à API do canal.

  • Registro da API do canal: foi adicionado suporte de registro e documentação para a API do canal para ajudar a auditar e monitorar o uso da API.

  • Notificações da API do canal: foi adicionado suporte à notificação de eventos para a API do canal, permitindo que os parceiros recebam atualizações em tempo real sobre as atividades relacionadas ao canal.

  • Cotas da API do canal: foi adicionada a documentação de cotas de serviço para a API do canal.

  • Teste de sandbox para a API do canal: foram adicionados recursos de teste de sandbox para a API do canal, permitindo que os parceiros testem os fluxos de trabalho do canal em um ambiente não produtivo.

  • Reorganização da estrutura da API: documentação reorganizada para distinguir entre a API de venda e a API de canal, com seções dedicadas para as permissões, registros, notificações e cotas de cada API.

  • Documentação das regiões suportadas: foi adicionada documentação para AWS regiões compatíveis com as APIs de vendas e de canal.

 2025-11-19
ARCO 3

  • Políticas de permissão de API atualizadas: as políticas foram atualizadas para refletir as novas ações introduzidas nesta versão. Certifique-se de que suas funções e permissões do IAM sejam ajustadas adequadamente.

  • Detalhes de uso do cabeçalho personalizado: foram adicionados detalhes sobre como usar o cabeçalho personalizado X-Amzn-User-Agent para ajudar a auditar e medir o uso da API.

  • Ações substituídas por ações assíncronas: AcceptOpportunityEngagementInvitation Substituído pela ação assíncrona StartEngagementByAcceptingInvitationTask e o formato da carga foi alterado em relação ao RC2.

  • Renomeação de entidades e ações: Alterado OpportunityEngagementInvitation paraEngagementInvitation. Os atributos dessas ações também foram alterados para se alinharem à nova entidade. As seguintes ações foram substituídas:

    • GetOpportunityEngagementInvitationé agoraGetEngagementInvitation. Vários atributos no convite foram alterados, adicionados ou removidos.

    • ListOpportunityEngagementInvitationsé agoraListEngagementInvitations.

    • RejectOpportunityEngagementInvitationé agoraRejectEngagementInvitation.

  • AssignOpportunityatualização de parâmetros: AssignOpportunity agora leva Assignee em vez deAssigneeEmail. Atualize suas implementações adequadamente.

  • SubmitOpportunityalteração de funcionalidade: agora SubmitOpportunity é executada pela ação assíncrona. StartEngagementFromOpportunityTask SubmitOpportunityagora aceita InvolvementType Visibility e.

  • Renomeação e expansão de atributos: EstimatedAwsMonthlyRevenue alterado paraExpectedCustomerSpend. ExpectedCustomerSpendagora inclui novos atributos, como Frequency TargetCompany e.

  • Resumo da nova ação para AWS oportunidade: a visibilidade da oportunidade agora é fornecida por meio de uma ação separada chamadaGetAwsOpportunitySummary.

  • Atualizações do fluxo de trabalho para trabalhar com oportunidades: O fluxo de trabalho para trabalhar com suas oportunidades foi atualizado para usar as novas ações introduzidas nesta versão.

  • Atualizações de fluxo de trabalho para trabalhar com oportunidades: o fluxo de trabalho para trabalhar com oportunidades foi atualizado para usoEngagementInvitations, o que melhora as oportunidades de tratamento oferecidas pela AWS.

  • Atualizações do fluxo de trabalho para rastrear atualizações: O fluxo de trabalho para rastrear atualizações agora está trabalhando com atualizações de oportunidades, aumentando a clareza e a eficiência no monitoramento do status da oportunidade.

  • Novos filtros para listar ações: novos filtros estão disponíveis para ListOpportunities ações ListSolutions e.

    • PoisListSolutions, os novos filtros são FilterCategoryFilterIdentifier, FilterStatus e.

    • PoisListOpportunities, os novos filtros são FilterCustomerCompanyNameFilterIdentifier, FilterLastModifiedDateFilterLifeCycleApprovalStatus,FilterLifeCycleStage,, FilterOrigin e.

  • Remoção do AccessControl subobjeto: O AccessControl subobjeto no modelo de oportunidade foi removido. NationalSecurityagora é um atributo de nível superior.

  • Atributos realocados paraGetAwsOpportunitySummary: Atributos como AWSOpportunityTeam insights (EngagementScore,NextBestAction), origem e agora InvolvementType estão disponíveis por meio de, GetAwsOpportunitySummary em vez deGetOpportunity.

  • Introdução do InvolvementType campo: introduziu o InvolvementType campo para diferenciar entre oportunidades de venda conjunta e oportunidades somente de visibilidade.

  • Atualizações do nome do evento: os eventos foram atualizados para refletir as mudanças. Por exemplo, o convite de engajamento de oportunidade criado agora é um convite de engajamento criado.

  • Atualizações da carga útil de resposta: todas as cargas de resposta agora incluem um ARN and/or de ID.

  • Solicitar atualizações de carga útil: todas as cargas de solicitação agora usam identificadores como entrada, que aceitam um ID ou ARN.

  • Atualização da entidade de engajamento: o atributo de título na entidade de engajamento foi renomeadoEngagementTitle.

  • Remoção do prefixo do filtro: todos os filtros não incluem mais o prefixo do filtro, simplificando o mecanismo de filtragem.

  • StartEngagementFromOpportunityatualização da ação: o atributo AwsInvolvement foi alterado paraAwsSubmission.

  • Atualização dos detalhes do projeto de convite: Invitation.ProjectDetails.TargetCompletionDate foi renomeadoInvitation.ProjectDetails.EstimatedCompletionDate.

  • Atualização da estimativa de receita: Invitation.PartnerRevenueEstimate é agoraExpectedCustomerSpend. O tipo de dados mudou de um objeto para uma matriz contendo um objeto.

  • Atualização da conta do destinatário: o campo ReceiverAccount foi renomeadoAccountReceiver.

  • Novo atributo do convite de engajamento: o SenderContact atributo foi introduzido para convites de engajamento.

  • Customer.Contactagora é uma matriz em vez de um objeto. OpportunityOwner, PartnerAccountManager são valores suportados comoBusinessTitle.

  • PartnerOpportunityTeam agora é denominado OpportunityTeam.

  • APNPrograms é agora ApnPrograms

  • Os status dos convites de engajamento foram atualizados.

  • ListEngagementInvitationsagora requer ParticipantType comoRECEIVER.

 2024-10-17
ARCO 2

  • Introduziu uma nova entidade chamada OpportunityEngagementInvitation.

  • Introduziu uma nova ação: ListOpportunityEngagementInvitations.

  • Introduziu uma nova ação: GetOpportunityEngagementInvitation.

  • Apresentou um novo evento: “Foi criado um convite de engajamento de oportunidade”.

  • AcceptOpportunity Substituído por AcceptOpportunityEngagementInvitation.

  • RejectOpportunity Substituído por RejectOpportunityEngagementInvitation.

  • Substituiu “Oportunidade aceita” por “Convite de engajamento de oportunidade aceito”.

  • Substituiu “Oportunidade rejeitada” por “Convite de engajamento de oportunidade rejeitado”.

  • PrimaryNeedsFromAWSalterado para PrimaryNeedsFromAws.

  • AWSOpportunityTeamalterado paraAwsOpportunityTeam.

  • AWSSalesLifeCyclealterado paraAwsSalesLifeCycle.

  • PrimaryNeedsFromAWSChangeReasonalterado paraPrimaryNeedsFromAwsChangeReason.

  • AWSAccountIdalterado paraAwsAccountId.

  • ExpectedMonthlyAWSRevenuealterado paraExpectedMonthlyAwsRevenue.

  • AWSFundingUsedalterado paraAwsFundingUsed.

  • AWSMarketplaceOffersalterado paraAwsMarketplaceOffers.

  • Countryalterado paraCountryCode.

  • PartnerOpportunityContactalterado paraPartnerOpportunityTeam.

  • Campo atualizado Contact.Title paraContact.BusinessTitle.

  • Campo atualizado ContactInfo paraOwnerInfo.

  • Mudou a AWS equipe de um mapa para uma lista.

  • Detalhes adicionados sobre a lista de aceitos RejectionReasons.

  • Forneceu informações sobre como usar o Token do Cliente.

  • Detalhes incluídos sobre como usar UpdateOpportunity.

  • Orientações adicionais sobre o uso de AWS produtos e soluções de parceiros.

  • Forneceu detalhes sobre a OpportunityEngagementInvitation entidade.

  • Atualizado StateOrRegion para incluir uma lista revisada de valores aceitos.

  • Implementou várias correções de bugs para melhorar o desempenho e as mensagens de erro.

 2024-08-07
ARCO 1

  • [Interrupção] Renomeação de ApprovalStatus para ReviewStatus: Renomeamos o ApprovalStatus campo ReviewStatus para melhor refletir sua finalidade. Além disso, estamos introduzindo um novo status, Envio pendente, para indicar uma oportunidade preliminar. Agora, ReviewStatus aceitará os seguintes valores: Envio pendente, Enviado, Em análise, Aprovado, Rejeitado e Ação necessária. O status anterior de Rascunho será substituído pelo Envio pendente.

  • [Interrupção] Introdução da SubmitOpportunity Ação: Uma nova ação SubmitOpportunity,, foi introduzida. Ao contrário do comportamento atual em que CreateOpportunity também envia a oportunidade, agora você pode criar uma oportunidade no estado Envio pendente sem vincular imediatamente uma Solução ou AWS Produto. Para concluir o envio, use a AssociateOpportunity ação para vincular uma solução ou produto, seguida por SubmitOpportunity. Essa separação fornece melhor desempenho de resposta da API e uma fase de preparação flexível antes do envio.

  • [Quebra] Requisito de um parâmetro de catálogo e descontinuação do Sandbox Endpoint: O endpoint 'gamma' (partnercentral-selling-gamma.us-east-1.amazonaws.com) ficará indisponível após /2024. 7/30 Todas as ações da API agora exigem um parâmetro Catalog para especificar se a operação é executada no Sandbox ou no AWS catálogo. As regras de notificação agora serão filtradas pelo catálogo em vez do EnvironmentName.

  • [Quebra] Renomear OpportunityIdentifier para Identifier: Actions AssignOpportunity, AcceptOpportunity, e RejectOpportunity agora use Identifier em vez de OpportunityIdentifier para manter a consistência com UpdateOpportunity.

  • Mudanças do tipo Enum para String for APNProgram e UseCase: Estaremos convertendo CustomerUseCase, Project.APNPrograms Marketing.ActivityUseCases, e Project.CustomerUseCase do tipo de enumeração para o tipo de string para reduzir os riscos associados à alteração de valores. Esses campos aceitarão valores somente de listas predefinidas, mas não estão disponíveis de forma nativa nos SDKs.

  • Tratamento aprimorado de erros: o tratamento de erros nas APIs foi significativamente aprimorado para facilitar a depuração e a resolução mais rápida de problemas. O novo tratamento de erros estrutura os erros em dois estágios: 1. Falha na validação da solicitação: verifica os tipos e o formato dos dados, ou 2. Falha na validação comercial: todos os problemas em uma carga serão listados em uma resposta, especificando o campo que contém erros. Esse feedback consolidado permite que você solucione e corrija erros com mais eficiência. Códigos e formatos de erros foram padronizados.

  • Identificador de origem do cliente: capacidade dos parceiros incluírem o X-Amzn-User-Agent cabeçalho em suas solicitações, o que ajuda a identificar a origem do tráfego. Use o formato [Nome da solução, incluindo provedor da solução] | [Versão] Por exemplo:AWS Partner CRM Connector | v2.0.1

  • Correção de bug, já implantada, sem alteração no SDK] Criação da oportunidade e ID AWS da conta: os parceiros agora podem iniciar uma oportunidade enquanto alteram a ID da AWS conta de nula para um valor válido sem encontrar erros. Anteriormente, um bug impedia que os parceiros realizassem essas ações separadamente.

  • Correção de bug, já implantada, sem alteração no SDK] Associação de soluções com novas oportunidades: os parceiros podem associar uma solução a uma oportunidade recém-criada. Antes, quando os parceiros criavam uma nova oportunidade e associavam simultaneamente uma solução, as informações da solução estavam sendo perdidas. Esse problema foi resolvido.

  • Correção de bug, já implantada, sem alteração no SDK] Exibição dos detalhes do proprietário da oportunidade: o problema em que algumas oportunidades exibiam os detalhes do proprietário em um campo combinado LastName "" em vez dos campos esperados de “E-mail”, "FirstName“e" LastName "foi corrigido.

  • Correção de bug, já implantada, sem alteração no SDK] Customer.Account.WebsiteUrl Campo opcional: o Customer.Account.WebsiteUrl campo se tornou opcional quando o AccessControls.NationalSecurity campo é “Sim”, alinhando assim o comportamento da API com o comportamento da interface de usuário existente. Se o AccessControls.NationalSecurity campo for “Não” ou nulo, o WebsiteUrl campo será obrigatório como uma validação comercial.

  • Correção de bug, já implantada, sem alteração no SDK] Requisito de ID de AWS conta para parceiros de consultoria: a inconsistência na interface do usuário que mostrava o campo ID da AWS conta como opcional para parceiros de consultoria foi resolvida. Agora é um campo obrigatório condicional, conforme a documentação.

  • Correção de bug. Para ser implantado 6/19, nenhuma alteração no SDK] Estágio de uma Co-sell oportunidade para fechada e perdida: os parceiros agora podem atualizar com sucesso o estágio de uma Co-sell oportunidade para encerrada e perdida, desde que um motivo fechado seja fornecido. Isso resolve o erro anterior dizendo “Campo obrigatório ausente: o motivo da perda é obrigatório ao fechar a oportunidade”.

  • Documentação] Melhorias na documentação: Fiz várias melhorias na documentação para refletir as mudanças.

  • Problemas conhecidos com uma correção pendente e uma lista dos próximos recursos:

    • Ao executar AssociateOpportunity ações com soluções ou produtos, as mensagens de erro das Ofertas são mostradas incorretamente.

    • Capacidade de criar oportunidades remotamente e simular o processo de AWS validação no Sandbox

    • O código postal retorna nulo quando está no formato XXXXX-XXXX dos EUA.

    • As próximas etapas e o histórico da próxima etapa não estão disponíveis para oportunidades marcadas como “Não preciso de suporte de”AWS.

    • Não é possível obter oportunidades históricas com descrições de problemas comerciais do cliente com mais de 255 caracteres.

    • Capacidade de excluir oportunidades que estão pendentes de envio.

    • LeadSource não está disponível no modelo de dados.

 2024-06-21
Versão beta 5

  • Alterado LifeCycle.ApprovalStatus para LifeCycle.ReviewStatus

  • Alterado Insights.ReviewComments para LifeCycle.ReviewComments

  • Adicionado LifeCycle.ReviewStatusReason (novo atributo)

  • Novo valor adicionado “Pendente” a PartnerAcceptance.Status

  • SDKs lançados para dotnet, java, javascript, python, ruby.

  • Guia de referência da API atualizado para refletir as alterações acima.

 2024-04-19
Versão beta 4

  • Teste de sandbox adicionado: capacidade de testar a notificação de evento de oportunidade no sandbox.

  • Documentação adicionada: introduziu exemplos de regras de notificação de eventos de oportunidade.

  • Lançamentos de SDK adicionados: SDKs lançados para Java (V2), Javascript (V2), (V3) e Python DotNet (V3).

  • Formato de data atualizado: atualizado para seguir os padrões ISO.

 2024-03-04
Versão beta 3

  • Arquivo de registro de alterações adicionado: introduziu um arquivo de registro de alterações para melhor rastreamento de atualizações e alterações.

  • Guia de referência de API atualizado (PDF): lançou uma nova versão do Guia de referência de API em formato PDF.

  • Guia de referência de API atualizado (versão da Web): a versão web do Guia de referência de API foi atualizada.

  • DotNet SDK adicionado: Lançamos o DotNet SDK, expandindo nosso suporte para diferentes ambientes de programação.

  • SDK do Python Boto 3 atualizado (V2): Lançada a versão 2 do SDK do Python Boto 3, introduzindo novos recursos e melhorias.

 2024-01-24
Versão beta 2

  • Guia de referência de API adicionado (versão Web): Lançou uma nova versão do Guia de referência de API (versão Web). Nota: Esta versão requer que um servidor web local seja executado após a extração para uma funcionalidade adequada.

 2024-01-07
Versão beta 1

  • Boto3 adicionado (versão inicial): lançou a versão inicial do Boto3, um SDK Python para nossos serviços.

  • Guia do programa beta adicionado: introduzimos um guia para os participantes do nosso programa de testes beta.

  • Guia de referência de API adicionado (PDF): Carregamos a primeira versão do nosso Guia de referência de API em formato PDF, fornecendo documentação abrangente para nossa API.

 2023-12-15
Versão beta 0 Essa versão inicial fornece um conjunto de funcionalidades para gerenciar e otimizar engajamentos e oportunidades de parceiros no AWS Partner Central. 2023-11-15