View a markdown version of this page

处理交易规模见解 - AWS 合作伙伴中心

AWS 合作伙伴中心 API 参考已重新构建。有关支持的 API 操作的更多信息,请参阅 AWS 合作伙伴中心 API 参考

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

处理交易规模见解

什么是交易规模?

交易规模调整是 P AWS artner Central 中的 APN 客户互动 (ACE) 机会中的一项功能,它使用 AI 在合作伙伴创建或更新机会时自动提供交易规模估算和AWS服务建议。

AI 预测的 MRR 估计值

根据合作伙伴的历史AWS机会、用例和业务描述,交易规模洞察提供了预测的每月经常性收入 (MRR) 范围的中位数。当合作伙伴收集有关交易和整个销售周期进展的更多信息时,合作伙伴应审查和更新总的MRR。

AI-recommended 产品是根据客户业务问题描述和机会详情来识别的。AI 推荐符合技术要求和用例的相关AWS产品。合作伙伴应查看这些建议,并根据客户的特定需求定制产品选择。

使用定价计算器网址增强见解

合作伙伴还可以导入AWS定价计算器网址以自动填充服务选择,并获得增强的见解,包括Migration Acceleration Program (MAP) 资格指标、优化建议和潜在的成本节省分析。

了解 Source-Separated 数据

交易规模提供来自两个不同来源的见解,让您全面了解机会价值:

  • AWS来源:基于类似历史机会模式的 AI-recommended 产品

  • 合作伙伴来源:从AWS定价计算器导入的您自己的估算值

处理源之间的差异

当合作伙伴提供的估算值与AWS建议存在很大差异时,合作伙伴应:

  1. 查看机会详情,确保捕捉到所有相关信息

  2. 验证定价计算器 URL 配置是否符合实际需求

  3. 将AWS建议视为以类似历史机会为依据的数据点

  4. 根据特定的客户环境和要求做出明智的决策

访问交易规模见解

合作伙伴通过 API 操作访问交易规模数据,GetAwsOpportunitySummaryAPI 操作会返回一个包含交易规模预测、产品推荐和优化见解的扩展AwsOpportunitySummary对象。

当交易规模数据可用时

在创建了包含足够客户和项目详细信息的机会后,即可获得交易规模见解。系统分析机会属性并生成:

  1. AI 预测 MRR:根据机会特征自动计算

  2. AWS产品推荐:与客户的业务问题和技术要求相关的服务

  3. 增强见解(提供定价计算器网址时):MAP 资格、优化建议和成本节约分析

注意

并非所有机会都可获得交易规模见解。资格取决于合作伙伴历史记录和所提供机会详情的完整性等因素。

提供交易规模输入

合作伙伴通过CreateOpportunityUpdateOpportunity API 操作为交易规模提供输入。系统使用机会属性来生成推荐。

提供合同总价值 (TCV)

以合同总价值而不是每月经常性收入进行估算的合作伙伴可以直接提供其交易价值。AWS 使用转换模型自动将 TCV AI-powered 转换为 AWS MRR。

对于 TCV 中的交易规模,请提供 a ExpectedContractDuration sMonths(有效值范围为 1 到 144 个月)和 a TargetCompany s Self 和 a Frequency s None

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

AWS 得出 AWS MRR 估算值,并返回以下两个条目: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" } ] } }

在上面的示例中,ExpectedCustomerSpend第一个数组包含 AWS MRR 估计值 (TargetCompany: "AWS",Frequency: "Monthly"),第二个数组是合作伙伴的合同总价值 (TargetCompany: "Self",Frequency: "None")。

TCV 验证规则

所有 TCV 验证错误都会返回INVALID_VALUE带有的错误代码。Reason: "BUSINESS_VALIDATION_FAILED"区别因素是FieldNameMessage

条件字段Message
无需自行进入 ExpectedContractDurationproject.expectedContractDurationExpectedContractDuration 当有自助参赛者时是必填的
ExpectedContractDuration不带自行输入(仅限创建)project.expectedCustomerSpend在场时 ExpectedContractDuration 需要自行进入
多个 Self 条目project.expectedCustomerSpend只允许一次自行进入
存在持续时间 TargetCompany 时无效project.expectedCustomerSpend.targetCompanyTargetCompany 必须是 “AWS” 或 “Self”
AWS 和 Self 之间的货币不匹配project.expectedCustomerSpend.currencyCodeCurrencyCode 条目之间必须匹配
自助进入 + EstimationUrl 一起进入project.expectedCustomerSpend.estimationUrl自行进入且 EstimationUrl 不能共存
注意

开启UpdateOpportunityExpectedContractDuration如果没有自我条目,但存储中存在合作伙伴交易值,则系统会自动重构自我条目——不会引发任何错误。

在 TCV 和手动 MRR 之间切换

要从 TCV 模式切换回手动 MRR,请明确设置ExpectedContractDurationnull并仅提供一个AWS条目:

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

ExpectedContractDuration从有效载荷中省略(不发送字段)意味着 “没有变化” ——保留现有的 TCV 数据。明确发送null意味着 “清除 TCV 模式”。

TCV 和定价计算器网址

如果合作伙伴同时提供了Self条目(TCV 模式)和EstimationUrl,则 API 会返回验证错误。自行输入, EstimationUrl 不能在同一个请求中共存。

提供手动的 MRR 估算

合作伙伴可以使用以下Project.ExpectedCustomerSpend[].Amount字段手动输入 MRR 估算值:

注意

CurrencyCode字段接受USDEUR。如果 AWS 分区为aws-eusc(AWS 欧洲主权云),则货币代码必须为EUR

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

此字段可供所有合作伙伴使用,可用于通过设置相同值来接受 AI 预测,也可以使用 Partner-provided 值进行覆盖。

提供定价计算器网址

合作伙伴可以选择通过该Project.ExpectedCustomerSpend[].EstimationUrl字段提供AWS定价计算器网址,以自动导入服务配置并获得增强的见解,包括 MAP 资格指标、优化建议和成本节约分析。

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

提供有效的定价计算器 URL 后,系统会自动根据计算器配置计算 MRR 金额,并在合作伙伴来源中填充 “金额” 字段和详细的产品级支出数据。AwsProductsSpendInsightsBySource合作伙伴在提供金额时应将金额设置为空 EstimationUrl ——系统将自动计算金额。

格式无效的 URL 和无法解析的 URL 将被拒绝ValidationException

金额和 EstimationUrl 运作方式如何

您可以灵活地为机会提供每月经常性收入 (MRR) 估算值。API 可以智能地处理手动金额和AWS定价计算器网址的各种组合,以确保您的机会始终可以成功创建。

仅使用手动金额

当您仅提供金额字段时,API 会保存您的手动估算值并将其设置 EstimationUrl 为空。当您通过客户对话或自己的计算得出具体的 MRR 估算值时,这种方法非常有用。

请求示例:

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

仅使用一个AWS定价计算器网址

当你只提供 EstimationUrl 字段时:

  • 有效网址-API 根据您的计算器配置计算 MRR 金额,并保存网址和计算出的金额。

  • 网址无效 — API 会返回一个 ValidationException ,其中包含有关网址无效原因的详细信息。

请求示例:

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

错误响应示例(网址无效):

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

同时提供金额和 EstimationUrl

当您同时提供这两个字段时,API 会优先确保您的机会成功创建:

  1. 如果两个值均未更改,则不会对这些字段执行任何更新

  2. 网址无效 — API 会保存您提供的金额并设置 EstimationUrl 为空,这样您就可以继续创建机会。

  3. URL 有效,计算出的金额与您提供的金额相符 — 两个值均已保存。

  4. 网址有效,但计算出的金额与您提供的金额不符 — API 会保存您提供的金额并设置 EstimationUrl 为 null 而不会返回错误。

注意

当两个值都与现有值不匹配时,API 会首先尝试根据网址计算金额。当出现不匹配或验证问题时,您手动提供的金额始终优先。

主要优点:无效 URL 永远不会阻止机会创建

这种方法可确保无效或无法访问的AWS定价计算器网址永远不会阻止您创建或更新机会。当出现冲突或验证问题时,您手动提供的金额始终优先,这样您就可以完全控制机会数据。

了解扩展 AwsOpportunitySummary 数据模型

本节介绍了 GetAwsOpportunitySummary API 操作返回的响应结构。

注意

AI-forecasted MRR 返回于 Project.ExpectedCustomerSpend[].Amount

GetAwsOpportunitySummaryAPI 操作通过新的Insights.AwsProductsSpendInsightsBySource结构返回交易规模见解,该结构提供带有来源归因的全面支出分析。

源分离:AWS vs 合作伙伴数据

交易规模按来源区分见解,以提供透明度并防止重复计算:

  • AWS来源:来自 AI 产品推荐AWS

  • 合作伙伴来源:从合作伙伴提供的定价计算器网址导入的支出数据和产品详情

这种分离使合作伙伴能够:

  1. 将他们的估计值与AWS建议进行比较

  2. 验证他们的尺寸假设

  3. 避免不小心合并两个来源,从而夸大总数

  4. 保持对数据来源的可见性

结构概述

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

字段参考

AwsProductsSpendInsightsBySource 地图

Source-separated 花费为AWS推荐和合作伙伴估算提供独立分析的见解。

Insights.AwsProductsSpendInsightsBySource字段是一个包含最多两个键的地图:

Key Type 说明
AWS AwsProductsSpendInsights AI-generated 见解,包括来自的推荐产品AWS
Partner AwsProductsSpendInsights Partner-sourced 从定价计算器网址中获得的见解,包括详细的服务成本和优化
注意

只有具有可用数据的来源才会包含在响应中。新的机会通常只从填充AWS来源开始。

AwsProductInsights 对象

针对单一来源(AWS或合作伙伴)的全面支出分析,包括总金额、优化节省、计划类别明细以及详细的产品层面见解。

每个源对象都包含以下字段:

字段 Type 说明
CurrencyCode 字符串 ISO 4217 货币代码。支持的值为 “美元” 和 “欧元”。
频率 字符串 指明客户预计花费预计金额的频率。“频率” 字段只允许使用 “每月” 值,表示每月经常性支出。
TotalAmount 字符串 优化前此来源的预计支出总额
TotalOptimizedAmount 字符串 应用建议的优化后的预计支出总额
TotalPotentialSavingsAmount 字符串 通过实施优化可以实现量化的节约
TotalAmountByCategory object 与AWS计划和现代化路径对应的支出金额
AwsProducts array Product-level 包括成本和优化建议在内的详细信息

当前状态限制:对于AWS来源, TotalAmount TotalOptimizedAmount、和,如果没有按产品划分的支出建议,则 TotalPotentialSavingsAmount 可以省略。在这些情况下,合作伙伴应参考Project.ExpectedCustomerSpend[].Amount总的AWS MRR估算值。

TotalAmountByCategory 对象

地图支出相当于AWS计划和战略计划:

类别密钥 说明
MAP 符合条件 在有资格获得 Migration Acceleration Program 资助
符合CAT资格 支持成本分配和跟踪的服务
途径-迁移到云原生 与云原生现代化保持一致的服务
途径——转向 Managed Services 支持采用托管服务的服务
途径-转向开源 开源服务替代方案
途径-转移到容器 Container-based 服务选项
途径-迁移到无服务器 无服务器计算服务
途径-移至数据库 数据库现代化服务
途径-转向分析 分析和数据处理服务
注意

TotalAmount 由于单个商品可能属于多个类别,因此类别总金额可能会超过。

AwsProducts 阵列

包含计划资格指标(MAP、现代化路径)、成本估算和优化建议的AWS服务清单。

每个产品对象都包含:

字段 类型 必需 描述
ProductCode 字符串 AWS用于机会关联的合作伙伴中心产品标识符
ServiceCode 字符串 定价计算器服务代码(指向原始计算器网址的链接)
类别 array 本产品有资格进入的计划和途径类别清单
使用额 字符串 优化前的基准服务成本(对于AWS源自的建议,可能为空)
OptimizedAmount 字符串 应用优化后的服务成本(对于AWS源自的建议,可能为空)
PotentialSavingsAmount 字符串 Service-specific 通过优化降低成本(对于AWS源自的建议,可能为空)
优化 array 此产品的具体优化建议清单

Null 处理:对于AWS来源的产品,如果没有按产品分类的支出建议 OptimizedAmount,则 “金额” 和 “ PotentialSavingsAmount 字段” 可能为空。Project.ExpectedCustomerSpend[0].Amount相反,系统通过提供总的MRR。

优化对象

每项优化建议都包含:

字段 Type 说明
Description 字符串 Human-readable 优化策略的解释
SavingsAmount 字符串 通过实施这种优化可以实现量化的成本节约

示例

示例 1:AWS仅限建议(当前状态)

此示例显示了当只有 AI 推荐可用且尚无法推荐每款产品的支出金额时的典型响应。

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

要点:AWS来源显示了推荐的产品,其中包含类别,但不包含每件商品的金额。总的MRR估算值可通过以下方式Project.ExpectedCustomerSpend[].Amount获得.

示例 2:合作伙伴定价计算器导入

此示例显示了当合作伙伴提供有效的定价计算器网址时,可以增强洞察力。

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

要点:合作伙伴来源包含完整的支出明细以及每件产品的金额。优化建议提供了切实可行的成本降低策略。类别细分显示了 MAP 资格(总计 32,500 美元中的 22,500 美元)。产品包括 ServiceCode 链接回定价计算器配置。

示例 3:两个来源都存在(比较方案)

此示例演示了AWS推荐和合作伙伴估算值如何合并在一起,从而便于进行比较。

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

要点:两个来源都有:AWS推荐(总计 2.8 万美元)和合作伙伴计算器(总计 32.5 万美元)。AWS推荐显示 4 种产品;合作伙伴计算器显示 4 种产品(3 种重叠)。合作伙伴可以将AWS建议与其详细估算值进行比较。AWS可通过以下方式获得的总数Project.ExpectedCustomerSpend[].Amount

最佳实践

处理空值

  1. EstimationUrl 字段:对于大多数合作伙伴,预计 EstimationUrl 为空。这是标准行为,不应被视为错误。将手动 MRR 输入选项显示为主路径。

  2. 缺少类别:如果 TotalAmountByCategory AWS来源中没有,则表示不提供按产品分类的推荐。如果提供了定价计算器网址,则可以对 Partner-sourced 数据进行类别细分。

优化建议

  1. 显示切实可行的见解:突出显示优化说明和节省金额,以帮助合作伙伴了解降低成本的机会。

  2. 总节省额:对 PotentialSavingsAmount 所有产品进行汇总以显示总体优化潜力。

  3. 按影响排序:对优化进行排序 SavingsAmount ,以帮助合作伙伴专注于影响力最高的建议。

监控更新

  1. 定期轮询:在商机创建工作流程中GetAwsOpportunitySummary定期进行轮询(建议:每 5 分钟一次)。

  2. 处理异步生成:在创造机会后,可能无法立即获得交易规模见解。实现适当的加载状态和重试逻辑。

API 集成模式

  1. 利用现有集成:已经致电的合作伙伴GetAwsOpportunitySummary只需要在响应中使用其他字段,无需调用新的 API。

  2. 优雅降级:设计用户界面以处理交易规模数据尚不可用或不完整的场景。

数据质量和准确性

  1. 验证定价计算器网址:在提交之前确保 URL 有效,以避免 EstimationUrl 回复为空。

  2. 提供丰富的机会详情:更完整的机会信息(客户详细信息、项目描述、技术要求)可以提供更准确的人工智能建议。

  3. 审查差异:当合作伙伴的估计值与AWS建议存在显著差异时,请查看机会详细信息以确保捕捉到所有相关的背景。