Die AWS Partner Central API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Partner Central API-Referenz.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten mit Erkenntnissen zum Geschäftsumfang

Was ist Deal Sizing?

Deal Sizing ist eine Funktion innerhalb der APN Customer Engagements (ACE) Opportunities in AWS Partner Central, die KI nutzt, um automatisierte Schätzungen der Geschäftsgröße und AWS Serviceempfehlungen bereitzustellen, wenn Partner Opportunities erstellen oder aktualisieren.

KI prognostizierte MRR-Schätzungen

Einblicke in die Geschäftsgröße liefern den Median der prognostizierten Bandbreite der prognostizierten monatlichen wiederkehrenden Umsätze (MRR) auf der Grundlage der bisherigen AWS Geschäftschancen, Anwendungsfälle und Geschäftsbeschreibungen der Partner. Partner sollten die gesamte MRR überprüfen und aktualisieren, sobald die Partner mehr Informationen über das Geschäft und den Verlauf des Verkaufszyklus sammeln.

AI-Recommended AWS Produkte

AI-recommended Produkte werden auf der Grundlage von Problembeschreibungen des Kunden und Einzelheiten zu Geschäftschancen identifiziert. Die KI empfiehlt relevante AWS Produkte, die auf die technischen Anforderungen und Anwendungsfälle abgestimmt sind. Partner sollten diese Vorschläge überprüfen und die Produktauswahl an die spezifischen Bedürfnisse des Kunden anpassen.

Verbesserte Einblicke mit Preisrechner-URLs

Partner können auch AWS Preisrechner-URLs importieren, um Serviceauswahlen automatisch auszufüllen und erweiterte Einblicke zu erhalten, darunter Zulassungsindikatoren des Migration Acceleration Program (MAP), Optimierungsempfehlungen und Analysen potenzieller Kosteneinsparungen.

Daten verstehen Source-Separated

Deal Sizing bietet Einblicke aus zwei verschiedenen Quellen, um Ihnen einen umfassenden Einblick in den Wert von Geschäftschancen zu geben:

Umgang mit Abweichungen zwischen Quellen

Wenn die vom Partner bereitgestellten Schätzungen erheblich von den AWS Empfehlungen abweichen, sollten die Partner:

Zugriff auf Einblicke in die Geschäftsgröße

Partner greifen über die GetAwsOpportunitySummary API-Aktion auf Deal-Sizing-Daten zu. Dabei wird ein erweitertes AwsOpportunitySummary Objekt zurückgegeben, das Prognosen zur Geschäftsgröße, Produktempfehlungen und Optimierungsinformationen enthält.

Wenn Daten zur Angebotsgröße verfügbar werden

Erkenntnisse zur Geschäftsgröße werden verfügbar, sobald eine Verkaufschance mit ausreichenden Kunden- und Projektdetails erstellt wurde. Das System analysiert die Chancenattribute und generiert:

Bereitstellung von Eingaben zur Geschäftsgröße

Partner stellen über die CreateOpportunity und UpdateOpportunity API-Aktionen Eingaben für Deal Sizing bereit. Das System verwendet Opportunity-Attribute, um Empfehlungen zu generieren.

Bereitstellung des Gesamtauftragswerts (TCV)

Partner, die den Gesamtvertragswert und nicht den monatlichen wiederkehrenden Umsatz schätzen, können ihren Geschäftswert direkt angeben. AWS konvertiert TCV mithilfe von AI-powered Konvertierungsmodellen automatisch in AWS MRR.

Für die Größe von Deals in TCV geben Sie ExpectedContractDuration as Months (gültige Werte liegen zwischen 1 und 144 Monaten) und TargetCompany as und as Self an. Frequency None

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

AWS leitet die AWS-MRR-Schätzung ab und gibt beide Einträge zurück auf: 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"
      }
    ]
  }
}

Im obigen Beispiel enthält das ExpectedCustomerSpend erste Array die AWS-MRR-Schätzung (TargetCompany: "AWS",Frequency: "Monthly") und das zweite Array ist der Gesamtvertragswert des Partners (TargetCompany: "Self",Frequency: "None").

TCV-Validierungsregeln

Alle TCV-Validierungsfehler geben den Fehlercode INVALID_VALUE mit zurück. Reason: "BUSINESS_VALIDATION_FAILED" Der Unterscheidungsfaktor ist das FieldName und: Message

Umschalten zwischen TCV und manueller MRR

Um vom TCV-Modus zurück zum manuellen MRR zu wechseln, setzen Sie die Einstellung explizit ExpectedContractDuration auf null und geben Sie nur einen Eintrag ein: AWS

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

URLs für TCV und Preisrechner

Wenn ein Partner sowohl einen Self Eintrag (TCV-Modus) als auch einen angibtEstimationUrl, gibt die API einen Validierungsfehler zurück. Selbsteingabe und EstimationUrl kann nicht gleichzeitig in derselben Anfrage existieren.

Bereitstellung manueller MRR-Schätzungen

Partner können MRR-Schätzungen mithilfe des Project.ExpectedCustomerSpend[].Amount folgenden Felds manuell eingeben:

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

Dieses Feld steht allen Partnern zur Verfügung und kann verwendet werden, um KI-Prognosen zu akzeptieren, indem derselbe Wert festgelegt wird, oder um es mit Partner-provided Werten zu überschreiben.

Bereitstellung von URLs für Preisrechner

Partner können optional AWS Preisrechner-URLs über das Project.ExpectedCustomerSpend[].EstimationUrl Feld angeben, um Servicekonfigurationen automatisch zu importieren und erweiterte Einblicke zu erhalten, darunter MAP-Eignungsindikatoren, Optimierungsempfehlungen und Kosteneinsparungsanalysen.

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

Wenn eine gültige URL für den Preisrechner angegeben wird, berechnet das System automatisch den MRR-Betrag aus der Rechnerkonfiguration und füllt sowohl das Feld Betrag als auch detaillierte Ausgabendaten auf Produktebene in der Partnerquelle von aus. AwsProductsSpendInsightsBySource Partner sollten bei der Angabe eines Betrags den Wert „Betrag“ auf Null setzen EstimationUrl — das System berechnet ihn automatisch.

URLs in ungültigen Formaten und URLs, die nicht aufgelöst werden können, werden mit einem zurückgewiesenValidationException.

Wie viel und wie EstimationUrl funktionieren

Sie sind flexibel, wenn es darum geht, Schätzungen der monatlichen wiederkehrenden Umsätze (MRR) für Opportunities abzugeben. Die API verarbeitet auf intelligente Weise verschiedene Kombinationen aus manuellen Beträgen und AWS Preisrechner-URLs, um sicherzustellen, dass Ihre Geschäftschancen immer erfolgreich erstellt werden können.

Verwenden Sie nur einen manuellen Betrag

Wenn Sie nur das Feld Betrag angeben, speichert die API Ihre manuelle Schätzung und setzt EstimationUrl sie auf Null. Dieser Ansatz ist nützlich, wenn Sie aufgrund von Kundengesprächen oder Ihren eigenen Berechnungen eine bestimmte MRR-Schätzung haben.

Beispielanforderung:

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

Verwenden Sie nur ein AWS URL für den Preisrechner

Wenn Sie nur das EstimationUrl Feld angeben:

Beispielanforderung:

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

Beispiel für eine Fehlerantwort (ungültige URL):

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

Angabe von Betrag und EstimationUrl

Wenn Sie beide Felder angeben, legt die API Wert darauf, dass Ihre Opportunity erfolgreich erstellt wird:

Wichtiger Vorteil: Ungültige URLs blockieren niemals die Erstellung von Opportunities

Dieser Ansatz stellt sicher, dass ungültige oder unzugängliche URLs für den AWS Preisrechner Sie niemals daran hindern, Opportunities zu erstellen oder zu aktualisieren. Ihr manuell eingegebener Betrag hat immer Vorrang, wenn ein Konflikt oder ein Validierungsproblem auftritt, sodass Sie die volle Kontrolle über Ihre Opportunity-Daten haben.

Das erweiterte AwsOpportunitySummary Datenmodell verstehen

In diesem Abschnitt wird die von der GetAwsOpportunitySummary API-Aktion zurückgegebene Antwortstruktur beschrieben.

Die GetAwsOpportunitySummary API-Aktion liefert dank der neuen Insights.AwsProductsSpendInsightsBySource Struktur, die eine umfassende Ausgabenanalyse mit Quellenzuweisung bietet, Einblicke in die Geschäftsgröße.

Trennung der Quellen:AWS im Vergleich zu Partnerdaten

Um Transparenz zu schaffen und Doppelzählungen zu vermeiden, werden die Erkenntnisse bei der Transaktionsgröße nach Quellen getrennt:

Diese Trennung ermöglicht Partnern:

Überblick über die Struktur

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

Feldreferenz

AwsProductsSpendInsightsBySource Landkarte

Source-separated Ausgabeninformationen, die unabhängige Analysen für AWS Empfehlungen und Schätzungen der Partner ermöglichen.

Das Insights.AwsProductsSpendInsightsBySource Feld ist eine Map mit bis zu zwei Schlüsseln:

AwsProductInsights Objekt

Umfassende Ausgabenanalyse für eine einzige Quelle (AWS oder einen Partner), einschließlich Gesamtbeträgen, Optimierungseinsparungen, Aufschlüsselung der Programmkategorien und detaillierter Einblicke auf Produktebene.

Jedes Quellobjekt enthält die folgenden Felder:

Beschränkung für den aktuellen Status: Für die AWS Quelle TotalPotentialSavingsAmount können TotalAmount, TotalOptimizedAmount, und weggelassen werden, wenn keine Ausgabenempfehlungen pro Produkt verfügbar sind. Partner sollten in diesen Project.ExpectedCustomerSpend[].Amount Fällen die gesamte AWS MRR-Schätzung als Referenz angeben.

TotalAmountByCategory Objekt

Maps gibt Beträge für AWS Programme und strategische Initiativen aus:

AwsProducts Reihe

Liste der AWS Dienstleistungen mit Indikatoren für die Eignung des Programms (MAP, Modernisierungspfade), Kostenschätzungen und Optimierungsempfehlungen.

Jedes Produktobjekt enthält:

Behandlung mit Nullwerten: Bei Produkten AWS mit Herkunft können Betrag und PotentialSavingsAmount Felder den Wert Null haben OptimizedAmount, wenn keine Ausgabenempfehlungen pro Produkt verfügbar sind. Das System stellt stattdessen die gesamte MRR bereit. Project.ExpectedCustomerSpend[0].Amount

Optimierungsobjekt

Jede Optimierungsempfehlung enthält:

Beispiele

Beispiel 1:AWS Nur Empfehlungen (aktueller Stand)

Dieses Beispiel zeigt die typische Reaktion, wenn nur KI-Empfehlungen verfügbar sind und Ausgabenbeträge pro Produkt noch nicht empfohlen werden können.

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

Wichtige Punkte: Die AWS Quelle zeigt empfohlene Produkte mit Kategorien, aber ohne Beträge pro Produkt. Die gesamte MRR-Schätzung ist verfügbar unter. Project.ExpectedCustomerSpend[].Amount

Beispiel 2: Import des Partner-Preisrechners

Dieses Beispiel zeigt verbesserte Einblicke, wenn ein Partner eine gültige Preisrechner-URL angegeben hat.

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

Wichtige Punkte: Die Partnerquelle enthält vollständige Ausgabendetails mit Beträgen pro Produkt. Optimierungsempfehlungen bieten umsetzbare Strategien zur Kostensenkung. Aufschlüsselungen nach Kategorien belegen die MAP-Eignung (22.500$ von insgesamt 32.500$). Zu den Produkten gehört ein ServiceCode Link zurück zur Konfiguration des Preisrechners.

Beispiel 3: Beide Quellen sind vorhanden (Vergleichsszenario)

Dieses Beispiel zeigt, wie sowohl AWS Empfehlungen als auch Schätzungen der Partner zusammen erscheinen, was einen Vergleich ermöglicht.

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

Wichtigste Punkte: Beide Quellen enthalten:AWS Empfehlungen (insgesamt 28.000$) und Partnerrechner (insgesamt 32.5.000$).AWS Empfehlungen zeigen 4 Produkte; Partnerrechner zeigt 4 Produkte (3 überlappen sich). Partner können AWS Empfehlungen mit ihren detaillierten Schätzungen vergleichen.AWS insgesamt verfügbar überProject.ExpectedCustomerSpend[].Amount.

Bewährte Methoden

Umgang mit Nullwerten

Empfehlungen zur Optimierung

Überwachung auf Aktualisierungen

API-Integrationsmuster

Datenqualität und Genauigkeit