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.

Utilisation des informations relatives au dimensionnement des transactions

Qu'est-ce que Deal Sizing ?

Le dimensionnement des offres est une fonctionnalité de la section Opportunités d'engagement client APN (ACE) de AWS Partner Central qui utilise l'IA pour fournir des estimations automatisées du montant des transactions et des recommandations de AWS service lorsque les partenaires créent ou mettent à jour des opportunités.

Estimations MRR prévisionnelles de l'IA

Les informations relatives au dimensionnement des transactions fournissent la médiane des fourchettes de revenus récurrents mensuels (MRR) prévues en fonction des AWS opportunités historiques, des cas d'utilisation et des descriptions commerciales des partenaires. Les partenaires doivent revoir et mettre à jour le MRR total au fur et à mesure que les partenaires recueillent plus d'informations sur la transaction et l'évolution du cycle de vente.

AI-Recommended AWS Produits

AI-recommended les produits sont identifiés en fonction de la description des problèmes commerciaux des clients et des détails des opportunités. L'IA recommande des AWS produits pertinents conformes aux exigences techniques et aux cas d'utilisation. Les partenaires doivent examiner ces suggestions et personnaliser la sélection de produits en fonction des besoins spécifiques du client.

Informations améliorées grâce aux URL du calculateur de prix

Les partenaires peuvent également importer AWS les URL du calculateur de prix pour renseigner automatiquement les sélections de services et recevoir des informations améliorées, notamment des indicateurs d'éligibilité au Migration Acceleration Program (MAP), des recommandations d'optimisation et une analyse des économies potentielles.

Comprendre les Source-Separated données

Deal Sizing fournit des informations provenant de deux sources distinctes pour vous donner une visibilité complète sur la valeur des opportunités :

Gestion de la variation entre les sources

Lorsque les estimations fournies par les partenaires diffèrent considérablement des AWS recommandations, les partenaires doivent :

Accès aux informations sur le dimensionnement des transactions

Les partenaires accèdent aux données de dimensionnement des transactions par le biais de l'action GetAwsOpportunitySummary API, qui renvoie un AwsOpportunitySummary objet étendu contenant des prévisions relatives au dimensionnement des transactions, des recommandations de produits et des informations d'optimisation.

Quand les données de dimensionnement des transactions deviennent disponibles

Les informations sur le dimensionnement des transactions sont disponibles une fois qu'une opportunité est créée avec suffisamment de détails sur le client et le projet. Le système analyse les attributs de l'opportunité et génère :

Fournir des informations sur le dimensionnement des transactions

Les partenaires fournissent des informations pour le dimensionnement des transactions par le biais des actions CreateOpportunity et de UpdateOpportunity l'API. Le système utilise les attributs d'opportunité pour générer des recommandations.

Fournir la valeur totale du contrat (TCV)

Les partenaires qui estiment la valeur totale du contrat plutôt que le chiffre d'affaires récurrent mensuel peuvent indiquer directement la valeur de leur transaction. AWS convertit automatiquement le TCV en AWS MRR à l'aide de modèles de AI-powered conversion.

Pour le dimensionnement des offres dans TCV, indiquez ExpectedContractDuration as Months (les valeurs valides vont de 1 à 144 mois) et TargetCompany as Self et Frequency as. None

{
  "Project": {
    "ExpectedContractDuration": { "Term": "Months", "Value": "36" },
    "ExpectedCustomerSpend": [
      {
        "Amount": "1200000.00",
        "CurrencyCode": "USD",
        "Frequency": "None",
        "TargetCompany": "Self"
      }
    ]
  }
}

AWS calcule l'estimation du MRR d'AWS et renvoie les deux entrées sur GetOpportunity :

{
  "Project": {
    "ExpectedContractDuration": { "Term": "Months", "Value": "36" },
    "ExpectedCustomerSpend": [
      {
        "Amount": "5600.00",
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      },
      {
        "Amount": "1200000.00",
        "CurrencyCode": "USD",
        "Frequency": "None",
        "TargetCompany": "Self"
      }
    ]
  }
}

Dans l'exemple ci-dessus, le ExpectedCustomerSpend premier tableau contient l'estimation AWS MRR (TargetCompany: "AWS",Frequency: "Monthly") et le second tableau représente la valeur totale du contrat du partenaire (TargetCompany: "Self",Frequency: "None").

Règles de validation du TCV

Toutes les erreurs de validation TCV renvoient un code d'erreur INVALID_VALUE avecReason: "BUSINESS_VALIDATION_FAILED". Le facteur distinctif est le FieldName et Message :

Basculer entre le TCV et le MRR manuel

Pour passer du mode TCV au mode MRR manuel, configurez ExpectedContractDuration explicitement null et fournissez uniquement une AWS entrée :

{
  "Project": {
    "ExpectedContractDuration": null,
    "ExpectedCustomerSpend": [
      {
        "Amount": "8000.00",
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  }
}

URL du TCV et du calculateur de prix

Si un partenaire fournit à la fois une Self entrée (mode TCV) et unEstimationUrl, l'API renvoie une erreur de validation. Entrée automatique et EstimationUrl ne peut pas coexister dans la même demande.

Fournir des estimations MRR manuelles

Les partenaires peuvent saisir manuellement les estimations MRR à l'aide du Project.ExpectedCustomerSpend[].Amount champ :

{
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": "25000.00",
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  }
}

Ce champ est accessible à tous les partenaires et peut être utilisé pour accepter les prévisions de l'IA en définissant la même valeur ou pour remplacer les prévisions par des Partner-provided valeurs.

Fournir des URL de calculateur de prix

Les partenaires peuvent éventuellement fournir des URL de calculateur de AWS prix via le Project.ExpectedCustomerSpend[].EstimationUrl terrain pour importer automatiquement les configurations de service et recevoir des informations améliorées, notamment des indicateurs d'éligibilité au MAP, des recommandations d'optimisation et une analyse des économies de coûts.

{
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": null,
        "CurrencyCode": "USD",
        "EstimationUrl": "https://calculator.aws/#/estimate?id=abc123",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  }
}

Lorsqu'une URL valide du calculateur de prix est fournie, le système calcule automatiquement le montant du MRR à partir de la configuration du calculateur et remplit à la fois le champ Montant et les données de dépenses détaillées au niveau du produit dans la source partenaire de. AwsProductsSpendInsightsBySource Les partenaires doivent définir le paramètre Amount sur null lorsqu'ils fournissent un EstimationUrl . Le système le calculera automatiquement.

Les URL dont le format n'est pas valide et les URL qui ne peuvent pas être résolues seront rejetées avec un. ValidationException

Comment quantifier et EstimationUrl travailler ensemble

Vous disposez d'une certaine flexibilité dans la manière dont vous fournissez des estimations de revenus récurrents mensuels (MRR) pour les opportunités. L'API gère intelligemment différentes combinaisons de montants manuels et d'URL du calculateur de AWS prix afin de garantir que vos opportunités puissent toujours être créées avec succès.

Utiliser uniquement un montant manuel

Lorsque vous fournissez uniquement le champ Montant, l'API enregistre votre estimation manuelle et la définit EstimationUrl sur null. Cette approche est utile lorsque vous avez une estimation du MRR spécifique à partir de conversations avec les clients ou de vos propres calculs.

Exemple de demande :

{
    "Project": {
        "ExpectedCustomerSpend": [{
            "Amount": "25000.00",
            "CurrencyCode": "USD",
            "Frequency": "Monthly",
            "TargetCompany": "AWS"
        }]
    }
}

En utilisant uniquement un AWS URL du calculateur de prix

Lorsque vous ne fournissez que le EstimationUrl champ :

Exemple de demande :

{
    "Project": {
        "ExpectedCustomerSpend": [{
            "EstimationUrl": "https://calculator.aws/#/estimate?id=abc123",
            "CurrencyCode": "USD",
            "Frequency": "Monthly",
            "TargetCompany": "AWS"
        }]
    }
}

Exemple de réponse d'erreur (URL non valide) :

{
    "ErrorList": [{
        "Code": "INVALID_VALUE",
        "FieldName": "project.expectedCustomerSpend.estimationUrl",
        "Message": "Invalid Estimation URL: https://calculator.aws/#/estimate?id=invalid"
    }],
    "Message": "The provided Estimation URL is invalid",
    "Reason": "INVALID_VALUE"
}

Fournir à la fois le montant et EstimationUrl

Lorsque vous fournissez les deux champs, l'API veille à ce que votre opportunité soit créée avec succès :

Principal avantage : les URL non valides ne bloquent jamais la création d'opportunités

Cette approche garantit que les URL non valides ou inaccessibles du calculateur de AWS prix ne vous empêchent jamais de créer ou de mettre à jour des opportunités. Le montant que vous avez fourni manuellement a toujours la priorité en cas de conflit ou de problème de validation, ce qui vous permet de contrôler totalement les données relatives à vos opportunités.

Comprendre le modèle de AwsOpportunitySummary données étendu

Cette section décrit la structure de réponse renvoyée par l'action d'GetAwsOpportunitySummaryAPI.

L'action de l'GetAwsOpportunitySummaryAPI fournit des informations sur le dimensionnement des transactions via la nouvelle Insights.AwsProductsSpendInsightsBySource structure qui fournit une analyse complète des dépenses avec attribution de source.

Séparation des sources :AWS par rapport aux données des partenaires

Le dimensionnement des transactions sépare les informations par source afin de garantir la transparence et d'éviter le double comptage :

Cette séparation permet aux partenaires de :

Aperçu de la structure

{
  "Insights": {
    "AwsProductsSpendInsightsBySource": {
      "<AWS | Partner>": {
        "CurrencyCode": "string",
        "Frequency": "string",
        "TotalAmount": "string",
        "TotalOptimizedAmount": "string",
        "TotalPotentialSavingsAmount": "string",
        "TotalAmountByCategory": { },
        "AwsProducts": [ ]
      }
    }
  },
  "Project": {
    "ExpectedCustomerSpend": [ ]
  },
  "RelatedEntityIds": {
    "AwsProducts": [ ]
  }
}

Référence de champ

AwsProductsSpendInsightsBySource Carte

Source-separated des informations sur les dépenses qui fournissent une analyse indépendante pour les AWS recommandations et les estimations des partenaires.

Le Insights.AwsProductsSpendInsightsBySource champ est une carte contenant jusqu'à deux clés :

AwsProductInsights Objet

Analyse complète des dépenses pour une seule source (AWS ou partenaire), y compris les montants totaux, les économies d'optimisation, la ventilation par catégorie de programmes et des informations détaillées sur le niveau des produits.

Chaque objet source contient les champs suivants :

Limite de l'état actuel : pour la AWS source TotalAmount, TotalOptimizedAmount, et TotalPotentialSavingsAmount peut être omis lorsque les recommandations de dépenses par produit ne sont pas disponibles. Les partenaires doivent faire référence Project.ExpectedCustomerSpend[].Amount à l'estimation totale du AWS MRR dans ces cas.

TotalAmountByCategory Objet

Les cartes dépensent des montants pour AWS les programmes et les initiatives stratégiques :

AwsProducts Array

Liste des AWS services avec indicateurs d'éligibilité au programme (MAP, voies de modernisation), estimations de coûts et recommandations d'optimisation.

Chaque objet de produit contient :

Gestion nulle : pour les produits AWS d'origine, le montant et PotentialSavingsAmount les champs peuvent être nuls lorsque les recommandations de dépenses par produit ne sont pas disponibles. OptimizedAmount Le système fournit Project.ExpectedCustomerSpend[0].Amount plutôt un MRR total.

Objet d'optimisation

Chaque recommandation d'optimisation contient :

Exemples

Exemple 1 :AWS recommandations uniquement (état actuel)

Cet exemple montre la réponse typique lorsque seules les recommandations de l'IA sont disponibles et que les montants de dépenses par produit ne peuvent pas encore être recommandés.

{
  "Catalog": "AWS",
  "Insights": {
    "AwsProductsSpendInsightsBySource": {
      "AWS": {
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "AwsProducts": [
          {
            "ProductCode": "AmazonEC2",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "AWSLambda",
            "Categories": ["Cost Allocation Tagging", "Pathway - Move to Cloud Native"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "AmazonRDS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging", "Pathway - Move to Managed Services"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          }
        ]
      }
    }
  },
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": "28000.00",
        "CurrencyCode": "USD",
        "EstimationUrl": null,
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  },
  "RelatedEntityIds": {
    "AwsProducts": [
      "AmazonEC2",
      "AWSLambda",
      "AmazonRDS"
    ]
  }
}

Points clés : la AWS source indique les produits recommandés avec des catégories, mais aucune quantité par produit. Estimation totale du MRR disponible viaProject.ExpectedCustomerSpend[].Amount.

Exemple 2 : Importation du calculateur de prix pour les partenaires

Cet exemple montre des informations améliorées lorsqu'un partenaire a fourni une URL de calculateur de prix valide.

{
  "Catalog": "AWS",
  "Insights": {
    "AwsProductsSpendInsightsBySource": {
      "Partner": {
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TotalAmount": "32500.00",
        "TotalOptimizedAmount": "30000.00",
        "TotalPotentialSavingsAmount": "2500.00",
        "TotalAmountByCategory": {
          "MAP Eligible": "22500.00",
          "Cost Allocation Tagging": "32500.00",
          "Pathway - Move to Cloud Native": "5000.00",
          "Pathway - Move to Managed Services": "7500.00"
        },
        "AwsProducts": [
          {
            "ServiceCode": "ec2",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": "15000.00",
            "OptimizedAmount": "13500.00",
            "PotentialSavingsAmount": "1500.00",
            "Optimizations": [
              {
                "Description": "Convert to 3-year reserved instances",
                "SavingsAmount": "1000.00"
              },
              {
                "Description": "Migrate to Graviton-based instances",
                "SavingsAmount": "500.00"
              }
            ]
          },
          {
            "ServiceCode": "lambda",
            "Categories": ["Cost Allocation Tagging", "Pathway - Move to Cloud Native"],
            "Amount": "5000.00",
            "OptimizedAmount": "5000.00",
            "PotentialSavingsAmount": "0.00",
            "Optimizations": []
          },
          {
            "ServiceCode": "AmazonRDS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging", "Pathway - Move to Managed Services"],
            "Amount": "7500.00",
            "OptimizedAmount": "6500.00",
            "PotentialSavingsAmount": "1000.00",
            "Optimizations": [
              {
                "Description": "Optimize Multi-AZ for dev/test environments",
                "SavingsAmount": "1000.00"
              }
            ]
          },
          {
            "ServiceCode": "AmazonS3",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": "5000.00",
            "OptimizedAmount": "5000.00",
            "PotentialSavingsAmount": "0.00",
            "Optimizations": []
          }
        ]
      }
    }
  },
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": "32500.00",
        "CurrencyCode": "USD",
        "EstimationUrl": "https://calculator.aws/#/estimate?id=abc123",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  },
  "RelatedEntityIds": {
    "AwsProducts": []
  }
}

Points clés : La source du partenaire contient le détail complet des dépenses avec les montants par produit. Les recommandations d'optimisation fournissent des stratégies de réduction des coûts réalisables. La répartition par catégorie indique l'éligibilité au MAP (22 500$ sur un total de 32 500$). Les produits incluent ServiceCode un lien vers la configuration du calculateur de prix.

Exemple 3 : Présence des deux sources (scénario de comparaison)

Cet exemple montre comment les AWS recommandations et les estimations des partenaires apparaissent ensemble, ce qui permet de les comparer.

{
  "Catalog": "AWS",
  "Insights": {
    "AwsProductsSpendInsightsBySource": {
      "AWS": {
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "AwsProducts": [
          {
            "ProductCode": "AmazonEC2",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "AWSLambda",
            "Categories": ["Cost Allocation Tagging", "Pathway - Move to Cloud Native"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "EBS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          },
          {
            "ProductCode": "RDS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging", "Pathway - Move to Managed Services"],
            "Amount": null,
            "OptimizedAmount": null,
            "PotentialSavingsAmount": null,
            "Optimizations": []
          }
        ]
      },
      "Partner": {
        "CurrencyCode": "USD",
        "Frequency": "Monthly",
        "TotalAmount": "32500.00",
        "TotalOptimizedAmount": "30000.00",
        "TotalPotentialSavingsAmount": "2500.00",
        "TotalAmountByCategory": {
          "MAP Eligible": "22500.00",
          "Cost Allocation Tagging": "32500.00",
          "Pathway - Move to Cloud Native": "5000.00",
          "Pathway - Move to Managed Services": "7500.00"
        },
        "AwsProducts": [
          {
            "ServiceCode": "ec2",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": "15000.00",
            "OptimizedAmount": "13500.00",
            "PotentialSavingsAmount": "1500.00",
            "Optimizations": [
              {
                "Description": "Convert to 3-year reserved instances",
                "SavingsAmount": "1000.00"
              }
            ]
          },
          {
            "ServiceCode": "lambda",
            "Categories": ["Cost Allocation Tagging", "Pathway - Move to Cloud Native"],
            "Amount": "5000.00",
            "OptimizedAmount": "5000.00",
            "PotentialSavingsAmount": "0.00",
            "Optimizations": []
          },
          {
            "ServiceCode": "amazonRDS",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging", "Pathway - Move to Managed Services"],
            "Amount": "7500.00",
            "OptimizedAmount": "6500.00",
            "PotentialSavingsAmount": "1000.00",
            "Optimizations": [
              {
                "Description": "Optimize Multi-AZ for dev/test environments",
                "SavingsAmount": "1000.00"
              }
            ]
          },
          {
            "ServiceCode": "amazonS3",
            "Categories": ["MAP Eligible", "Cost Allocation Tagging"],
            "Amount": "5000.00",
            "OptimizedAmount": "5000.00",
            "PotentialSavingsAmount": "0.00",
            "Optimizations": []
          }
        ]
      }
    }
  },
  "Project": {
    "ExpectedCustomerSpend": [
      {
        "Amount": "28000.00",
        "CurrencyCode": "USD",
        "EstimationUrl": "https://calculator.aws/#/estimate?id=abc123",
        "Frequency": "Monthly",
        "TargetCompany": "AWS"
      }
    ]
  },
  "RelatedEntityIds": {
    "AwsProducts": [
      "AmazonEC2",
      "AWSLambda",
      "EBS",
      "RDS"
    ]
  }
}

Points clés : Les deux sources sont présentes :AWS recommandations (28 000$ au total) et calculateur pour les partenaires (32,5 000$ au total).AWS les recommandations indiquent 4 produits ; le calculateur des partenaires indique 4 produits (3 se chevauchant). Les partenaires peuvent comparer AWS les recommandations à leurs estimations détaillées.AWS total disponible viaProject.ExpectedCustomerSpend[].Amount.

Bonnes pratiques

Gestion des valeurs nulles

Recommandations d'optimisation

Surveillance des mises à jour

Modèles d'intégration des API

Qualité et précision des données