View a markdown version of this page

Notes de mise à jour - AWS Partner Central

La référence AWS Partner Central d'API a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez la référence des AWS Partner Central API.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Notes de mise à jour

Cette page contient un résumé des modifications importantes apportées à la documentation de l'API AWS Partner Central, en commençant par la dernière mise à jour.

Historique des révisions
Modifier Description Date
RC 6.0

  • AWS Partner Central a ajouté de nouvelles API de mesure des revenus des partenaires.

 30/06/2026/
RC 5.3

  • Mises à jour d'ACE Resonate : GetAwsOpportunitySummary réponse mise à jour.

 16/06/2026/
RC 5.2

  • Support de devise en EUR : CreateOpportunityUpdateOpportunity,, et CreateEngagementInvitation maintenant j'accepte EUR en plus du code USD de devise MRR. Lorsque la partition AWS est aws-eusc (AWS European Sovereign Cloud), le code de devise doit êtreEUR.

  • EUR dans les opérations de lecture : GetOpportunityListOpportunities,, et revenez GetAwsOpportunitySummary EUR maintenant CurrencyCode sur le terrain pour des opportunités dans la aws-eusc partition.

 30/03/2026/
RC 5.1

  • Support de devise en EUR : CreateOpportunityUpdateOpportunity,, et CreateEngagementInvitation maintenant j'accepte EUR en plus du code USD de devise MRR. Lorsque la partition AWS est aws-eusc (AWS European Sovereign Cloud), le code de devise doit êtreEUR.

  • EUR dans les opérations de lecture : GetOpportunityListOpportunities,, et revenez GetAwsOpportunitySummary EUR maintenant CurrencyCode sur le terrain pour des opportunités dans la aws-eusc partition.

 30/03/2026/
RC 5

  • API de compte introduite : ajout d'une nouvelle API de compte àAWS Partner Central, permettant aux partenaires de gérer les informations de leur compte, leur enregistrement, leurs profils, leur gestion de domaine et leurs connexions avec les partenaires.

  • Documentation de référence de l'API du compte : ajout d'une documentation de référence complète pour l'API du compte, y compris l'enregistrement des partenaires, la gestion des profils, la vérification du domaine et les flux de travail de connexion aux comptes.

  • Enregistrement de l'API du compte : ajout d'un support de journalisation et d'une documentation pour l'API de compte afin de faciliter l'audit et le suivi de l'utilisation de l'API.

  • Notifications de l'API du compte : ajout de la prise en charge des notifications d'événements pour l'API du compte, permettant aux partenaires de recevoir des mises à jour en temps réel sur les activités liées au compte, y compris les connexions aux comptes partenaires.

  • Quotas d'API de compte : ajout de la documentation sur les quotas de service pour l'API de compte.

  • Tests en sandbox pour l'API des comptes : ajout de fonctionnalités de test en sandbox pour l'API des comptes, permettant aux partenaires de tester les flux de travail de gestion des comptes dans un environnement hors production.

  • API d'avantages ajoutée : ajout d'une nouvelle API d'avantages àAWS Partner Central, permettant aux partenaires de découvrir, de demander et de gérer les avantages dans l'ensemble des programmes de AWS partenariat via une interface centralisée.

  • Documentation de référence de l'API Benefits : Ajout d'une documentation de référence complète pour l'API Benefits, couvrant les demandes d'avantages, les allocations et les processus d'exécution.

  • Journalisation de l'API Benefits : ajout d'un support de journalisation et d'une documentation pour l'API Benefits afin de faciliter l'audit et le suivi de l'utilisation de l'API.

  • Notifications de l'API Benefits : Ajout de la prise en charge des notifications d'événements pour l'API Benefits, permettant aux partenaires de recevoir des mises à jour en temps réel sur les demandes d'avantages et les allocations.

  • Quotas de l'API Benefits : ajout de la documentation sur les quotas de service pour l'API Benefits.

  • Tests en sandbox pour l'API Benefits : ajout de fonctionnalités de test en sandbox pour l'API Benefits, permettant aux partenaires de tester les flux de travail de gestion des avantages dans un environnement hors production.

  • API de vente mise à jour : actions d'engagement de l'API de vente améliorées pour soutenir le flux de travail de gestion des prospects.

  • Mises à jour de la documentation de l'API de vente : documentation de l'API de vente améliorée avec une structure améliorée et des flux de travail actualisés pour la gestion des prospects.

  • Mises à jour des notifications de l'API de vente : documentation améliorée sur les notifications d'événements pour les événements d'engagement et d'invitation à l'engagement.

  • Extension de la structure des API : structure de documentation étendue pour prendre en charge quatre API distinctes (compte, avantages, vente et canal) avec des sections dédiées pour les autorisations, la journalisation, les notifications, les quotas et les tests en sandbox de chaque API.

  • Documentation améliorée sur l'utilisation des API : ajout de guides d'utilisation complets pour les API Account and Benefits avec des flux de travail détaillés et des modèles d'intégration.

  • Documentation sur les régions prises en charge : ajout de la documentation pour les AWS régions prises en charge pour les API Account and Benefits.

  • Nouveau filtre pour ListOpportunities : Ajout d'un TargetCloseDate filtre pour permettre de filtrer les opportunités en fonction de leur date de clôture prévue à AfterTargetCloseDate l'aide de BeforeTargetCloseDate champs YYYY-MM-DD formatés.

 30/11/2025
RC 4

  • API de canal introduite : ajout d'une nouvelle API de canal àAWS Partner Central, permettant aux partenaires de gérer les relations entre les canaux et les collaborations entre partenaires.

  • Documentation de référence de l'API Channel : ajout d'une documentation de référence complète pour l'API Channel, y compris toutes les actions et tous les modèles de données disponibles.

  • Autorisations de l'API du canal : ajout de politiques d'autorisation IAM et de documentation de contrôle d'accès spécifiques à l'API du canal.

  • Journalisation de l'API du canal : ajout du support de journalisation et de la documentation pour l'API du canal afin de faciliter l'audit et le suivi de l'utilisation de l'API.

  • Notifications de l'API du canal : ajout de la prise en charge des notifications d'événements pour l'API du canal, permettant aux partenaires de recevoir des mises à jour en temps réel sur les activités liées au canal.

  • Quotas d'API de canal : ajout de la documentation sur les quotas de service pour l'API de canal.

  • Tests en sandbox pour l'API Channel : ajout de fonctionnalités de test en sandbox pour l'API Channel, permettant aux partenaires de tester les flux de travail des canaux dans un environnement hors production.

  • Réorganisation de la structure de l'API : documentation réorganisée pour faire la distinction entre l'API Selling et l'API Channel, avec des sections dédiées aux autorisations, à la journalisation, aux notifications et aux quotas de chaque API.

  • Documentation sur les régions prises en charge : ajout de la documentation pour AWS les régions prises en charge pour les API de vente et de distribution.

 19/11/2025
RC 3

  • Politiques d'autorisation d'API mises à jour : les politiques ont été mises à jour pour refléter les nouvelles actions introduites dans cette version. Assurez-vous que vos rôles et autorisations IAM sont ajustés en conséquence.

  • Détails d'utilisation de l'en-tête personnalisé : ajout de détails sur la façon d'utiliser l'en-tête personnalisé X-Amzn-User-Agent pour aider à auditer et à mesurer l'utilisation de l'API.

  • Actions remplacées par des actions asynchrones : Remplacé par AcceptOpportunityEngagementInvitation l'action asynchrone StartEngagementByAcceptingInvitationTask et le format de charge utile a changé par rapport à RC2.

  • Changement de nom de l'entité et de l'action : remplacé parOpportunityEngagementInvitation. EngagementInvitation Les attributs de ces actions ont également été modifiés pour s'aligner sur la nouvelle entité. Les actions suivantes ont été remplacées :

    • GetOpportunityEngagementInvitationc'est maintenantGetEngagementInvitation. Plusieurs attributs de l'invitation ont été modifiés, ajoutés ou supprimés.

    • ListOpportunityEngagementInvitationsc'est maintenantListEngagementInvitations.

    • RejectOpportunityEngagementInvitationc'est maintenantRejectEngagementInvitation.

  • AssignOpportunitymise à jour des paramètres : prend AssignOpportunity désormais la Assignee place deAssigneeEmail. Mettez à jour vos implémentations en conséquence.

  • SubmitOpportunitychangement de fonctionnalité : SubmitOpportunity est désormais effectué par l'action asynchrone. StartEngagementFromOpportunityTask SubmitOpportunityaccepte désormais InvolvementType etVisibility.

  • Renommage et extension des attributs : EstimatedAwsMonthlyRevenue remplacé par. ExpectedCustomerSpend ExpectedCustomerSpendinclut désormais de nouveaux attributs, tels que Frequency etTargetCompany.

  • Résumé des nouvelles actions pour les AWS opportunités : la visibilité des opportunités est désormais assurée par le biais d'une action distincte appeléeGetAwsOpportunitySummary.

  • Mises à jour du flux de travail pour travailler avec les opportunités : le flux de travail pour travailler avec vos opportunités a été mis à jour pour utiliser les nouvelles actions introduites dans cette version.

  • Mises à jour du flux de travail pour l'utilisation des opportunités : le flux de travail relatif à l'utilisation des opportunités a été mis à jour pour être utiliséEngagementInvitations, ce qui améliore la gestion des opportunités proposées par AWS.

  • Mises à jour du flux de travail pour le suivi des mises à jour : le flux de travail de suivi des mises à jour fonctionne désormais avec les mises à jour des opportunités, ce qui améliore la clarté et l'efficacité du suivi de l'état des opportunités.

  • Nouveaux filtres pour répertorier les actions : de nouveaux filtres sont disponibles pour ListSolutions et pour ListOpportunities les actions.

    • En ListSolutions effet, les nouveaux filtres sont FilterCategoryFilterIdentifier, etFilterStatus.

    • En ListOpportunities effet, les nouveaux filtres sont FilterCustomerCompanyName FilterIdentifierFilterLastModifiedDate,FilterLifeCycleApprovalStatus,FilterLifeCycleStage, etFilterOrigin.

  • Suppression du AccessControl sous-objet : le AccessControl sous-objet du modèle d'opportunité a été supprimé. NationalSecurityest désormais un attribut de premier niveau.

  • Attributs déplacés vers GetAwsOpportunitySummary : Attributs tels que AWSOpportunityTeam insights (EngagementScore,NextBestAction), origin, et InvolvementType sont désormais disponibles via GetAwsOpportunitySummary au lieu deGetOpportunity.

  • Présentation du InvolvementType champ : introduction du champ pour différencier les InvolvementType opportunités de cosell et celles axées uniquement sur la visibilité.

  • Mises à jour du nom des événements : les événements ont été mis à jour pour refléter les modifications. Par exemple, l'invitation d'engagement d'opportunité créée est désormais une invitation d'engagement créée.

  • Mises à jour de la charge utile de réponse : toutes les charges utiles de réponse incluent désormais un identifiant ARN and/or .

  • Mises à jour de la charge utile des demandes : toutes les charges utiles des demandes utilisent désormais des identifiants en entrée, qui acceptent soit un ID, soit un ARN.

  • Mise à jour de l'entité d'engagement : l'attribut title de l'entité d'engagement a été renomméEngagementTitle.

  • Suppression du préfixe de filtre : tous les filtres n'incluent plus le préfixe de filtre, ce qui simplifie le mécanisme de filtrage.

  • StartEngagementFromOpportunitymise à jour de l'action : l'attribut AwsInvolvement a été remplacé parAwsSubmission.

  • Mise à jour des détails du projet d'invitation : Invitation.ProjectDetails.TargetCompletionDate a été renomméeInvitation.ProjectDetails.EstimatedCompletionDate.

  • Mise à jour de l'estimation des recettes : Invitation.PartnerRevenueEstimate c'est maintenantExpectedCustomerSpend. Le type de données est passé d'un objet à un tableau contenant un seul objet.

  • Mise à jour du compte du destinataire : le champ ReceiverAccount a été renomméAccountReceiver.

  • Nouvel attribut d'invitation à un engagement : SenderContact un attribut a été introduit pour les invitations à un engagement.

  • Customer.Contactest désormais un tableau au lieu d'un objet. OpportunityOwner, PartnerAccountManager sont des valeurs prises en charge sous la formeBusinessTitle.

  • PartnerOpportunityTeam est désormais appelé OpportunityTeam.

  • APNPrograms est maintenant ApnPrograms

  • Les statuts des invitations à un engagement ont été mis à jour.

  • ListEngagementInvitationsnécessite désormais ParticipantType asRECEIVER.

 17/10/2024
RC 2

  • A introduit une nouvelle entité appelée OpportunityEngagementInvitation.

  • A introduit une nouvelle action : ListOpportunityEngagementInvitations.

  • A introduit une nouvelle action : GetOpportunityEngagementInvitation.

  • A introduit un nouvel événement : « Opportunity Engagement Invitation Created ».

  • Remplacé AcceptOpportunity par AcceptOpportunityEngagementInvitation.

  • Remplacé RejectOpportunity par RejectOpportunityEngagementInvitation.

  • « Opportunité acceptée » a été remplacé par « Invitation d'engagement d'opportunité acceptée ».

  • « Opportunité rejetée » par « Invitation d'engagement d'opportunité rejetée ».

  • PrimaryNeedsFromAWSchangé en PrimaryNeedsFromAws.

  • AWSOpportunityTeamchangé enAwsOpportunityTeam.

  • AWSSalesLifeCyclechangé enAwsSalesLifeCycle.

  • PrimaryNeedsFromAWSChangeReasonchangé enPrimaryNeedsFromAwsChangeReason.

  • AWSAccountIdchangé enAwsAccountId.

  • ExpectedMonthlyAWSRevenuechangé enExpectedMonthlyAwsRevenue.

  • AWSFundingUsedchangé enAwsFundingUsed.

  • AWSMarketplaceOfferschangé enAwsMarketplaceOffers.

  • Countrychangé enCountryCode.

  • PartnerOpportunityContactchangé enPartnerOpportunityTeam.

  • Champ mis à jour Contact.Title pourContact.BusinessTitle.

  • Champ mis à jour ContactInfo pourOwnerInfo.

  • AWS L'équipe est passée d'une carte à une liste.

  • Ajout de détails sur la liste des personnes acceptées RejectionReasons.

  • Informations fournies sur la façon d'utiliser le jeton client.

  • Détails d'utilisation inclus UpdateOpportunity.

  • Ajout de conseils sur l'utilisation AWS des produits et des solutions partenaires.

  • Informations détaillées sur l' OpportunityEngagementInvitationentité fournies.

  • Mis StateOrRegion à jour pour inclure une liste révisée des valeurs acceptées.

  • Plusieurs corrections de bogues ont été mises en œuvre pour améliorer les performances et les messages d'erreur.

 2024-08-07
RC 1

  • [Rupture] Renommer ApprovalStatus le champ en ReviewStatus : nous avons renommé le ApprovalStatus champ ReviewStatus afin de mieux refléter son objectif. En outre, nous introduisons un nouveau statut, En attente de soumission, pour indiquer une opportunité de brouillon. Les valeurs suivantes ReviewStatus seront désormais acceptées : En attente de soumission, Soumis, En cours de révision, Approuvé, Rejeté et Action requise. L'ancien statut de brouillon sera remplacé par le statut En attente de soumission.

  • [Rupture] Introduction de SubmitOpportunity l'action : Une nouvelle action a été introduite. SubmitOpportunity Contrairement au comportement actuel où l'opportunité est CreateOpportunity également soumise, vous pouvez désormais créer une opportunité à l'état En attente de soumission sans lier immédiatement une solution ou un AWS produit. Pour terminer la soumission, utilisez l' AssociateOpportunity action pour lier une solution ou un produit, puis SubmitOpportunity. Cette séparation permet de meilleures performances de réponse aux API et une phase de préparation flexible avant la soumission.

  • [Cause] Exigence d'un paramètre de catalogue et dépréciation du point de terminaison Sandbox : le point de terminaison « gamma » (partnercentral-selling-gamma.us-east-1.amazonaws.com) ne sera plus disponible après /2024. 7/30 Toutes les actions d'API nécessitent désormais un paramètre Catalog pour spécifier si l'opération est effectuée sur le Sandbox ou sur le AWS catalogue. Les règles de notification filtreront désormais sur le catalogue plutôt que sur EnvironmentName.

  • [Cause] Renommer OpportunityIdentifier en identifiant : actions AssignOpportunity AcceptOpportunity, et RejectOpportunity maintenant prenez un identifiant au lieu de OpportunityIdentifier pour rester cohérent avec UpdateOpportunity.

  • Passage du type Enum à String pour APNProgram CustomerUseCase, et UseCase : Nous allons convertir Project.APNPrograms Marketing.ActivityUseCases, et Project.CustomerUseCase du type d'énumération au type de chaîne afin de réduire les risques associés à la modification des valeurs. Ces champs n'accepteront que les valeurs issues de listes prédéfinies, mais qui ne sont pas disponibles de manière native dans les SDK.

  • Gestion améliorée des erreurs : La gestion des erreurs au sein des API a été considérablement améliorée pour faciliter le débogage et accélérer la résolution des problèmes. Le nouveau système de gestion des erreurs structure les erreurs en deux étapes : 1. Échec de la validation de la demande : vérification des types et du format des données, ou 2. Échec de la validation commerciale : tous les problèmes liés à une charge utile seront répertoriés dans une seule réponse, en spécifiant le champ contenant des erreurs. Ces commentaires consolidés vous permettent de résoudre et de corriger les erreurs de manière plus efficace. Les codes d'erreur et les formats ont été normalisés.

  • Identifiant de la source du client : possibilité pour les partenaires d'inclure l' X-Amzn-User-Agent en-tête dans leurs demandes, ce qui permet d'identifier la source du trafic. Utilisez le format [Nom de la solution, fournisseur de solution inclus] | [Version] Par exemple :AWS Partner CRM Connector | v2.0.1

  • Correction d'un bogue, déjà déployée, aucune modification du SDK] Création d'opportunité et ID de AWS compte : les partenaires peuvent désormais lancer une opportunité en changeant l'ID de AWS compte de zéro à une valeur valide sans rencontrer d'erreur. Auparavant, un bogue empêchait les partenaires d'effectuer ces actions séparément.

  • Correction d'un bogue, déjà déployée, aucune modification apportée au SDK] Solution associée à de nouvelles opportunités : les partenaires peuvent associer une solution à une opportunité nouvellement créée. Auparavant, lorsque les partenaires créaient une nouvelle opportunité et associaient simultanément une solution, les informations relatives à la solution étaient perdues. Ce problème a été résolu.

  • Correction d'un bogue, déjà déployée, aucune modification apportée au SDK] Affichage des détails du propriétaire de l'opportunité : le problème selon lequel certaines opportunités affichaient les informations du propriétaire dans un champ combiné LastName « » au lieu des champs « E-mail », FirstName « » et « » LastName attendus a été corrigé.

  • Correction de bogue, déjà déployée, aucune modification du SDK] Customer.Account.WebsiteUrl Champ facultatif : le Customer.Account.WebsiteUrl champ est devenu facultatif lorsque le AccessControls.NationalSecurity champ est « Oui », alignant ainsi le comportement de l'API sur le comportement de l'interface utilisateur existant. Si le AccessControls.NationalSecurity champ est « Non » ou nul, le WebsiteUrl champ sera requis pour la validation commerciale.

  • Correction d'un bogue, déjà déployée, aucune modification de l'exigence d'identifiant de AWS compte [SDK] pour les partenaires consultants : l'incohérence dans l'interface utilisateur qui indiquait que le champ ID de AWS compte était facultatif pour les partenaires consultants a été corrigée. Il s'agit désormais d'un champ obligatoire conditionnel, conformément à la documentation.

  • Correction d'un bogue, à déployer 6/19, aucune modification du SDK] Étape d'une Co-sell opportunité à Fermée Perdue : Les partenaires peuvent désormais passer avec succès de l'étape d'une Co-sell opportunité à Fermée perdue, à condition qu'une raison de fermeture perdue soit fournie. Cela corrige l'erreur précédente indiquant « Champ obligatoire manquant : fermé La raison perdue est requise lors de la fermeture de l'opportunité ».

  • Documentation] Améliorations apportées à la documentation : plusieurs améliorations ont été apportées à la documentation pour refléter les modifications.

  • Problèmes connus avec un correctif en attente et liste des fonctionnalités à venir :

    • Lorsque vous effectuez une AssociateOpportunity action avec des solutions ou des produits, les messages d'erreur des offres ne s'affichent pas correctement.

    • Possibilité de créer des opportunités à distance et de simuler le processus AWS de validation dans Sandbox

    • Le code postal renvoie la valeur null lorsqu'il est XXXXX-XXXX au format américain.

    • Next Steps et Next Step History ne sont pas disponibles pour les opportunités marquées comme « Pas besoin d'assistance de »AWS.

    • Impossible d'obtenir l'historique des opportunités avec des descriptions de problèmes commerciaux de plus de 255 caractères pour les clients.

    • Possibilité de supprimer les opportunités en attente de soumission.

    • LeadSource n'est pas disponible dans le modèle de données.

 21/06/2021
Bêta 5

  • Changé LifeCycle.ApprovalStatus en LifeCycle.ReviewStatus

  • Changé Insights.ReviewComments en LifeCycle.ReviewComments

  • Ajouté LifeCycle.ReviewStatusReason (nouvel attribut)

  • Nouvelle valeur ajoutée « En attente » pour PartnerAcceptance.Status

  • SDK publiés pour dotnet, java, javascript, python, ruby.

  • Guide de référence des API mis à jour pour refléter les modifications ci-dessus.

 19/04/2024
Bêta 4

  • Test Sandbox ajouté : possibilité de tester la notification des événements d'opportunité dans Sandbox.

  • Documentation ajoutée : introduction d'exemples de règles de notification d'événements d'opportunité.

  • Versions de SDK ajoutées : SDK publiés pour Java (V2), Javascript (V2), DotNet (V3) et Python (V3).

  • Format de date mis à jour : mis à jour pour suivre les normes ISO.

 04/03/2024
Bêta 3

  • Ajout d'un fichier journal des modifications : introduction d'un fichier journal des modifications pour un meilleur suivi des mises à jour et des modifications.

  • Guide de référence des API mis à jour (PDF) : publication d'une nouvelle version du guide de référence des API au format PDF.

  • Guide de référence des API mis à jour (version Web) : mise à jour de la version Web du guide de référence des API.

  • DotNet SDK ajouté : lancement du DotNet SDK, étendant notre support à différents environnements de programmation.

  • Mise à jour du SDK Python Boto 3 (V2) : sortie de la version 2 du SDK Python Boto 3, introduisant de nouvelles fonctionnalités et améliorations.

 24-01-2024
Bêta 2

  • Ajout du guide de référence des API (version Web) : publication d'une nouvelle version du guide de référence des API (version Web). Remarque : Cette version nécessite l'exécution d'un serveur Web local après l'extraction pour un fonctionnement correct.

 07-01-2024
Bêta 1

  • Ajout de Boto3 (version initiale) : lancement de la version initiale de Boto3, un SDK Python pour nos services.

  • Ajout du guide du programme bêta : introduction d'un guide pour les participants à notre programme de test bêta.

  • Ajout du guide de référence des API (PDF) : nous avons téléchargé la première version de notre guide de référence des API au format PDF, fournissant une documentation complète pour notre API.

 15/12/2023
Bêta 0 Cette version initiale fournit une suite de fonctionnalités permettant de gérer et d'optimiser les engagements et les opportunités des AWS partenaires dans Partner Central. 15/11/2023