L' AWS Partner Central API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Partner Central API Reference.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lavorare con informazioni sul dimensionamento delle trattative

Che cos'è Deal Sizing?

Deal Sizing è una funzionalità dell'APN Customer Engagements (ACE) Opportunities di AWS Partner Central che utilizza l'intelligenza artificiale per fornire stime automatiche delle dimensioni delle trattative e consigli sui AWS servizi quando i partner creano o aggiornano opportunità.

Stime MRR previste dall'IA

Le informazioni sul dimensionamento delle trattative forniscono la mediana degli intervalli di ricavi ricorrenti mensili (MRR) previsti in base alle opportunità storiche, ai casi d'uso e alle descrizioni delle attività dei partner.AWS I partner devono esaminare e aggiornare l'MRR totale man mano che raccolgono ulteriori informazioni sull'accordo e sui progressi del ciclo di vendita.

AI-Recommended AWS Prodotti

AI-recommended i prodotti vengono identificati in base alle descrizioni dei problemi aziendali dei clienti e ai dettagli delle opportunità. L'intelligenza artificiale consiglia AWS prodotti pertinenti in linea con i requisiti tecnici e i casi d'uso. I partner dovrebbero esaminare questi suggerimenti e personalizzare la selezione dei prodotti in base alle esigenze specifiche del cliente.

Informazioni avanzate con gli URL del calcolatore dei prezzi

I partner possono anche importare gli URL del AWS Pricing Calculator per compilare automaticamente le selezioni di servizi e ricevere informazioni avanzate, tra cui indicatori di idoneità del Migration Acceleration Program (MAP), consigli di ottimizzazione e analisi dei potenziali risparmi sui costi.

Comprensione dei dati Source-Separated

Deal Sizing fornisce informazioni da due fonti separate per darti una visibilità completa sul valore delle opportunità:

Gestione della varianza tra le fonti

Quando le stime fornite dai partner differiscono in modo significativo dalle AWS raccomandazioni, i partner devono:

Accesso a Deal Sizing Insights

I partner accedono ai dati Deal Sizing tramite l'azione GetAwsOpportunitySummary API, che restituisce un AwsOpportunitySummary oggetto esteso contenente previsioni sul dimensionamento delle trattative, consigli sui prodotti e approfondimenti sull'ottimizzazione.

Quando i dati sul dimensionamento delle trattative diventano disponibili

Le informazioni sul dimensionamento delle trattative diventano disponibili dopo la creazione di un'opportunità con sufficienti dettagli su clienti e progetti. Il sistema analizza gli attributi dell'opportunità e genera:

Fornire input per il dimensionamento delle trattative

I partner forniscono input per Deal Sizing tramite le CreateOpportunity azioni e API. UpdateOpportunity Il sistema utilizza gli attributi delle opportunità per generare raccomandazioni.

Fornire il valore totale del contratto (TCV)

I partner che stimano il valore totale del contratto anziché i ricavi ricorrenti mensili possono fornire direttamente il valore dell'accordo. AWS converte automaticamente TCV in AWS MRR utilizzando modelli di conversione. AI-powered

Per il dimensionamento delle trattative in TCV, fornisci ExpectedContractDuration as Months (i valori validi vanno da 1 a 144 mesi) e as and as. TargetCompany Self Frequency None

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

AWS ricava la stima AWS MRR e restituisce entrambe le voci su: 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"
      }
    ]
  }
}

Nell'esempio precedente, il ExpectedCustomerSpend primo array contiene la stima AWS MRR (TargetCompany: "AWS",Frequency: "Monthly") e il secondo array è il valore totale del contratto (TargetCompany: "Self",Frequency: "None") del partner.

Regole di convalida TCV

Tutti gli errori di convalida TCV restituiscono il codice di errore con. INVALID_VALUE Reason: "BUSINESS_VALIDATION_FAILED" Il fattore distintivo è la e: FieldName Message

Passaggio tra TCV e MRR manuale

Per passare dalla modalità TCV alla MRR manuale, ExpectedContractDuration impostala esplicitamente e fornisci solo una voce: null AWS

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

URL del TCV e del calcolatore dei prezzi

Se un partner fornisce sia un Self ingresso (modalità TCV) che unEstimationUrl, l'API restituisce un errore di convalida. Ingresso automatico e EstimationUrl non può coesistere nella stessa richiesta.

Fornitura di stime MRR manuali

I partner possono inserire manualmente le stime MRR utilizzando il Project.ExpectedCustomerSpend[].Amount campo:

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

Questo campo è disponibile per tutti i partner e può essere utilizzato per accettare previsioni di intelligenza artificiale impostando lo stesso valore o per sostituirlo con valori. Partner-provided

Fornire gli URL del calcolatore dei prezzi

I partner possono facoltativamente fornire gli URL del AWS Pricing Calculator tramite il Project.ExpectedCustomerSpend[].EstimationUrl campo per importare automaticamente le configurazioni dei servizi e ricevere informazioni avanzate, tra cui indicatori di idoneità MAP, consigli di ottimizzazione e analisi dei risparmi sui costi.

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

Quando viene fornito un URL valido del Pricing Calculator, il sistema calcola automaticamente l'importo MRR dalla configurazione della calcolatrice e compila sia il campo Amount che i dati dettagliati sulla spesa a livello di prodotto nella fonte Partner di. AwsProductsSpendInsightsBySource I partner devono impostare Amount su null quando forniscono un. Il sistema lo calcolerà automaticamente. EstimationUrl

Gli URL in formati non validi e gli URL che non possono essere risolti verranno rifiutati con un. ValidationException

Quanto ammontano e come funzionano insieme EstimationUrl

Avete flessibilità nel modo in cui fornite stime mensili delle entrate ricorrenti (MRR) per le opportunità. L'API gestisce in modo intelligente varie combinazioni di importi manuali e URL del AWS Pricing Calculator per garantire che le tue opportunità possano sempre essere create con successo.

Utilizzando solo un importo manuale

Quando fornisci solo il campo Importo, l'API salva la stima manuale e la imposta EstimationUrl su null. Questo approccio è utile quando si dispone di una stima MRR specifica derivante dalle conversazioni con i clienti o da calcoli personalizzati.

Richiesta di esempio:

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

Utilizzando solo un AWS URL del calcolatore dei prezzi

Quando fornisci solo il EstimationUrl campo:

Richiesta di esempio:

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

Esempio di risposta di errore (URL non valido):

{
    "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"
}

Fornendo sia l'importo che EstimationUrl

Quando fornisci entrambi i campi, l'API dà la priorità per garantire che l'opportunità venga creata correttamente:

Vantaggio principale: gli URL non validi non bloccano mai la creazione di opportunità

Questo approccio garantisce che gli URL del AWS Pricing Calculator non validi o inaccessibili non impediscano mai di creare o aggiornare opportunità. L'importo fornito manualmente ha sempre la precedenza in caso di conflitto o problema di convalida, dandoti il pieno controllo sui dati relativi alle opportunità.

Comprensione del modello di dati esteso AwsOpportunitySummary

Questa sezione descrive la struttura di risposta restituita dall'azione GetAwsOpportunitySummary API.

L'azione GetAwsOpportunitySummary API fornisce informazioni dettagliate sul dimensionamento delle trattative attraverso la nuova Insights.AwsProductsSpendInsightsBySource struttura che fornisce un'analisi completa della spesa con attribuzione della fonte.

Separazione delle fonti:AWS rispetto ai dati dei partner

Deal Sizing separa le informazioni in base alla fonte per garantire trasparenza ed evitare doppi conteggi:

Questa separazione consente ai partner di:

Panoramica della struttura

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

Riferimento sul campo

AwsProductsSpendInsightsBySource Mappa

Source-separated approfondimenti sulla spesa che forniscono analisi indipendenti per AWS raccomandazioni e stime dei partner.

Il Insights.AwsProductsSpendInsightsBySource campo è una mappa contenente fino a due chiavi:

AwsProductInsights Oggetto

Analisi completa della spesa per un'unica fonte (AWS o partner) che include importi totali, risparmi per l'ottimizzazione, suddivisioni per categorie di programma e approfondimenti dettagliati a livello di prodotto.

Ogni oggetto di origine contiene i seguenti campi:

Limitazione dello stato attuale: per l'AWS origine, TotalAmount TotalOptimizedAmount, e TotalPotentialSavingsAmount può essere omessa quando non sono disponibili consigli sulla spesa per prodotto. In questi casi, i partner devono fare riferimento Project.ExpectedCustomerSpend[].Amount alla stima dell'AWS MRR totale.

TotalAmountByCategory Oggetto

Mappa gli importi di spesa in AWS programmi e iniziative strategiche:

AwsProducts Array

Elenco di AWS servizi con indicatori di idoneità al programma (MAP, percorsi di modernizzazione), stime dei costi e consigli di ottimizzazione.

Ogni oggetto del prodotto contiene:

Gestione nulla: per i prodotti AWS di provenienza, l'importo e PotentialSavingsAmount i campi possono essere nulli quando i consigli di spesa per prodotto non sono disponibili. OptimizedAmount Il sistema fornisce invece una MRR totale via. Project.ExpectedCustomerSpend[0].Amount

Oggetto di ottimizzazione

Ogni raccomandazione di ottimizzazione contiene:

Esempi

Esempio 1:AWS Solo raccomandazioni (stato attuale)

Questo esempio mostra la risposta tipica quando sono disponibili solo i consigli di intelligenza artificiale e non è ancora possibile consigliare gli importi di spesa per prodotto.

{
  "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"
    ]
  }
}

Punti chiave: la AWS fonte mostra i prodotti consigliati con categorie ma senza importi per prodotto. Stima della MRR totale disponibile tramite. Project.ExpectedCustomerSpend[].Amount

Esempio 2: importazione di Partner Pricing Calculator

Questo esempio mostra approfondimenti migliorati quando un partner ha fornito un URL valido per il Pricing Calculator.

{
  "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": []
  }
}

Punti chiave: Partner Source contiene dettagli completi sulla spesa con importi per prodotto. I consigli di ottimizzazione forniscono strategie attuabili di riduzione dei costi. Le suddivisioni per categoria mostrano l'idoneità al MAP (22.500 USD su un totale di 32.500 USD). I prodotti includono il collegamento alla configurazione del Pricing Calculator. ServiceCode

Esempio 3: entrambe le fonti sono presenti (scenario di confronto)

Questo esempio dimostra come i AWS consigli e le stime dei partner appaiano insieme, permettendo il confronto.

{
  "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"
    ]
  }
}

Punti chiave: entrambe le fonti presentano:AWS raccomandazioni (28.000 USD in totale) e Partner Calculator (32,5 000$ in totale).AWS i consigli mostrano 4 prodotti; il calcolatore Partner mostra 4 prodotti (3 sovrapposti). I partner possono confrontare le AWS raccomandazioni con le loro stime dettagliate.AWS totale disponibile tramiteProject.ExpectedCustomerSpend[].Amount.

Best practice

Gestione dei valori nulli

Consigli per l'ottimizzazione

Monitoraggio degli aggiornamenti

Modelli di integrazione delle API

Qualità e precisione dei dati