View a markdown version of this page

发行说明 - AWS 合作伙伴中心

AWS Partner Central API 参考已重新构建。有关支持的 API 操作的更多信息,请参阅 AWS Partner Central API 参考

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

发行说明

本页概述了AWS合作伙伴中心 API 文档的重大更改,首先是最新更新。

修订历史记录
更改 描述 日期
RC 6.0
  • AWS 合作伙伴中心添加了新的合作伙伴收入衡量 API。

2026-06-30
RC 5.3
  • ACE 共鸣更新:GetAwsOpportunitySummary响应已更新。

2026-06-16
RC 5.2
  • 欧元货币支持:CreateOpportunityUpdateOpportunity、,CreateEngagementInvitation现在除了 MRR 货币代码外,还接受EURUSD当 AWS 分区为aws-eusc(AWS 欧洲主权云)时,货币代码必须为EUR

  • 读取操作中的 EUR: GetOpportunity ListOpportunities、,GetAwsOpportunitySummary现在返回EURCurrencyCode字段以寻找aws-eusc分区中的机会。

2026-03-30
RC 5.1
  • 欧元货币支持:CreateOpportunityUpdateOpportunity、,CreateEngagementInvitation现在除了 MRR 货币代码外,还接受EURUSD当 AWS 分区为aws-eusc(AWS 欧洲主权云)时,货币代码必须为EUR

  • 读取操作中的 EUR: GetOpportunity ListOpportunities、,GetAwsOpportunitySummary现在返回EURCurrencyCode字段以寻找aws-eusc分区中的机会。

2026-03-30
RC 5
  • 引入账户 API:向AWS合作伙伴中心添加了新的账户 API,使合作伙伴能够管理其账户信息、注册、个人资料、域名管理和合作伙伴连接。

  • 账户 API 参考文档:为账户 API 添加了全面的 API 参考文档,包括合作伙伴注册、个人资料管理、域名验证和账户连接工作流程。

  • 账户 API 日志:为账户 API 添加了日志记录支持和文档,以帮助审计和跟踪 API 的使用情况。

  • 账户 API 通知:为账户 API 添加了事件通知支持,使合作伙伴能够接收账户相关活动的实时更新,包括合作伙伴账户关联。

  • 账户 API 配额:为账户 API 添加了服务配额文档。

  • 账户 API 的沙盒测试:为账户 API 增加了沙盒测试功能,允许合作伙伴在非生产环境中测试账户管理工作流程。

  • 引入福利 API:向AWS合作伙伴中心添加了新的福利 API,使合作伙伴能够通过集中式界面发现、申请和管理AWS合作伙伴计划中的福利。

  • 福利 API 参考文档:为福利 API 添加了全面的 API 参考文档,涵盖福利申请、分配和配送流程。

  • 好处 API 日志:为福利 API 添加了日志记录支持和文档,以帮助审计和跟踪 API 的使用情况。

  • 福利 API 通知:增加了对 Benefits API 的事件通知支持,使合作伙伴能够接收福利申请和分配的实时更新。

  • 福利 API 配额:添加了福利 API 的服务配额文档。

  • Benefits API 的沙盒测试:为 Benefits API 增加了沙盒测试功能,允许合作伙伴在非生产环境中测试福利管理工作流程。

  • 更新了销售 API:增强了销售 API 互动操作以支持销售线索管理工作流程。

  • 销售 API 文档更新:增强的销售 API 文档,改进了销售线索管理的结构和更新的工作流程。

  • 销售 API 通知更新:针对参与和参与邀请活动的增强版事件通知文档。

  • API 结构扩展:扩展了文档结构,支持四个不同的 API(账户、福利、销售和渠道),每个 API 的权限、日志、通知、配额和沙盒测试都有专门的章节。

  • 增强的 API 使用文档:为账户和福利 API 添加了全面的使用指南,其中包含详细的工作流程和集成模式。

  • 支持的地区文档:为账户和福利 API 的支持AWS区域添加了文档。

  • 新的筛选条件ListOpportunities:添加了TargetCloseDate筛选条件,允许使用AfterTargetCloseDate和 YYYY-MM-DD 格式BeforeTargetCloseDate字段按预期的截止日期筛选机会。

2025-11-30
RC 4
  • 引入渠道 API:向AWS合作伙伴中心添加了新的渠道 API,使合作伙伴能够管理渠道关系和合作伙伴之间的协作。

  • 频道 API 参考文档:为频道 API 添加了全面的 API 参考文档,包括所有可用的操作和数据模型。

  • 频道 API 权限:添加了特定于频道 API 的 IAM 权限策略和访问控制文档。

  • 频道 API 日志:为频道 API 添加了日志记录支持和文档,以帮助审计和跟踪 API 的使用情况。

  • 渠道 API 通知:增加了对频道 API 的事件通知支持,使合作伙伴能够接收有关频道相关活动的实时更新。

  • 频道 API 配额:为频道 API 添加了服务配额文档。

  • Channel API 的沙盒测试:为频道 API 增加了沙盒测试功能,允许合作伙伴在非生产环境中测试频道工作流程。

  • API 结构重组:重新组织了文档,以区分销售 API 和渠道 API,每个 API 的权限、日志、通知和配额都有专门的章节。

  • 支持的地区文档:为销售和渠道 API 的支持AWS区域添加了文档。

2025-11-19
RC 3
  • 更新了 API 权限策略:政策已更新,以反映此版本中引入的新操作。确保相应调整您的 IAM 角色和权限。

  • 自定义标题使用详情:添加了有关如何使用自定义标头X-Amzn-User-Agent来帮助审计和衡量 API 使用情况的详细信息。

  • 将操作替换为异步操作:已替换AcceptOpportunityEngagementInvitation为异步操作,StartEngagementByAcceptingInvitationTask并且与 RC2 相比,有效负载格式已更改。

  • 实体和动作重命名:已更改OpportunityEngagementInvitation为。EngagementInvitation这些操作的属性也已更改,以与新实体保持一致。以下操作已被替换:

    • GetOpportunityEngagementInvitation现在是GetEngagementInvitation。邀请中的多个属性已被更改、添加或删除。

    • ListOpportunityEngagementInvitations现在是ListEngagementInvitations

    • RejectOpportunityEngagementInvitation现在是RejectEngagementInvitation

  • AssignOpportunity参数更新:AssignOpportunity现在取Assignee代了AssigneeEmail。相应地更新您的实现。

  • SubmitOpportunity功能更改:SubmitOpportunity现在由异步操作执行StartEngagementFromOpportunityTaskSubmitOpportunity现在接受InvolvementTypeVisibility

  • 属性重命名和扩展:EstimatedAwsMonthlyRevenue已更改为。ExpectedCustomerSpend ExpectedCustomerSpend现在包括新属性,例如FrequencyTargetCompany

  • AWS机会摘要的新操作:机会可见性现在通过一个名为的单独操作提供GetAwsOpportunitySummary

  • 处理机会的工作流程更新:使用此版本中引入的新操作更新了处理您的机会的工作流程。

  • 处理机会的工作流程更新:“处理机会” 的工作流程已更新为使用EngagementInvitations,这改进了 AWS 提供的处理机会。

  • 跟踪更新的工作流程更新:跟踪更新的工作流程现在是处理机会更新,从而提高了监控机会状态的清晰度和效率。

  • 用于列出操作的新过滤器:为ListSolutionsListOpportunities操作提供了新的过滤器。

    • 对于ListSolutions,新的过滤器是FilterCategoryFilterIdentifier、和FilterStatus

    • 对于ListOpportunities,新的过滤器是FilterCustomerCompanyNameFilterIdentifierFilterLastModifiedDateFilterLifeCycleApprovalStatusFilterLifeCycleStage、和FilterOrigin

  • 移除AccessControl子对象:机会模型中的AccessControl子对象已删除。 NationalSecurity现在是顶级属性。

  • 属性已重新定位到GetAwsOpportunitySummary:诸如AWSOpportunityTeam见解 (EngagementScoreNextBestAction)、来源和InvolvementType之类的属性现在可通过GetAwsOpportunitySummary而不是GetOpportunity

  • InvolvementType领域简介:引入该InvolvementType字段以区分 cosell 和仅限可见性的机会。

  • 活动名称更新:事件已更新为以反映更改。例如,创建的机会参与邀请现在已创建参与邀请

  • 响应负载更新:所有响应负载现在都包含 ID AR and/or N。

  • 请求有效载荷更新:所有请求负载现在都使用标识符作为输入,这些标识符接受 ID 或 ARN。

  • 互动实体更新:互动实体中的标题属性已重命名EngagementTitle

  • 删除过滤器前缀:所有过滤器都不再包含过滤器前缀,从而简化了筛选机制。

  • StartEngagementFromOpportunity操作更新:属性AwsInvolvement已更改为AwsSubmission

  • 邀请项目详情更新:Invitation.ProjectDetails.TargetCompletionDate已重命名Invitation.ProjectDetails.EstimatedCompletionDate

  • 收入估算更新:现在Invitation.PartnerRevenueEstimateExpectedCustomerSpend。数据类型从一个对象更改为包含一个对象的数组。

  • 收款人账户更新:该字段ReceiverAccount已重命名AccountReceiver

  • 参与邀请新SenderContact属性:为参与邀请引入了属性。

  • Customer.Contact现在是一个数组而不是一个对象。 OpportunityOwnerPartnerAccountManager支持的值为BusinessTitle

  • PartnerOpportunityTeam 现在称为 OpportunityTeam

  • APNPrograms 现在是 ApnPrograms

  • 参与邀请状态已更新。

  • ListEngagementInvitations现在需要 ParticipantType as RECEIVER

2024-10-17
RC 2
  • 引入了一个名为的新实体 OpportunityEngagementInvitation。

  • 引入了一个新动作: ListOpportunityEngagementInvitations.

  • 引入了一个新动作: GetOpportunityEngagementInvitation.

  • 推出了一项新活动:“已创建机会参与邀请”。

  • 替换 AcceptOpportunity 为 AcceptOpportunityEngagementInvitation。

  • 替换 RejectOpportunity 为 RejectOpportunityEngagementInvitation。

  • 将 “机会已接受” 替换为 “已接受机会参与邀请”。

  • 将 “机会被拒绝” 替换为 “机会参与邀请被拒绝”。

  • PrimaryNeedsFromAWS改为 PrimaryNeedsFromAws。

  • AWSOpportunityTeam改为AwsOpportunityTeam

  • AWSSalesLifeCycle改为AwsSalesLifeCycle

  • PrimaryNeedsFromAWSChangeReason改为PrimaryNeedsFromAwsChangeReason

  • AWSAccountId改为AwsAccountId

  • ExpectedMonthlyAWSRevenue改为ExpectedMonthlyAwsRevenue

  • AWSFundingUsed改为AwsFundingUsed

  • AWSMarketplaceOffers改为AwsMarketplaceOffers

  • Country改为CountryCode

  • PartnerOpportunityContact改为PartnerOpportunityTeam

  • Contact.Title将字段更新为Contact.BusinessTitle

  • ContactInfo将字段更新为OwnerInfo

  • 将AWS队伍从地图更改为列表。

  • 添加了有关已接受名单的详细信息 RejectionReasons。

  • 提供了有关如何使用客户令牌的信息。

  • 包括有关如何使用的详细信息 UpdateOpportunity。

  • 添加了有关使用AWS产品和合作伙伴解决方案的指南。

  • 提供了有关该 OpportunityEngagementInvitation实体的详细信息。

  • 已更新 StateOrRegion ,包括修订后的可接受值列表。

  • 修复了多个错误,以改善性能和错误消息。

2024-08-07
RC 1
  • [Breaking] 重命名为 ReviewStatus: ApprovalStatus 为了更好地反映其用途,我们已 ReviewStatus 将该 ApprovalStatus 字段重命名为。此外,我们还引入了一种新状态,即 “待提交”,以表示有机会参加选秀。现在 ReviewStatus 将接受以下值:“待提交”、“已提交”、“审核中”、“已批准”、“已拒绝” 和 “需要采取行动”。以前的草稿状态将替换为 “待提交”。

  • [Breaking SubmitOpportunity ] Action 简介:引入了新的动作。 SubmitOpportunity与当前 CreateOpportunity 同时提交机会的行为不同,您现在可以创建处于 “待提交” 状态的商机,而无需立即关联解决方案或AWS产品。要完成提交,请使用 AssociateOpportunity 操作链接解决方案或产品,然后使用 SubmitOpportunity。这种分离提供了更好的 API 响应性能,并在提交之前提供了灵活的准备阶段。

  • [Breaking] 对目录参数的要求和沙盒端点的弃用:“gamma” 端点 (partnercentral-selling-gamma.us-east-1.amazonaws.com) 将在 2024 年之后不可用。 7/30现在,所有 API 操作都需要一个 Catalog 参数来指定该操作是在沙盒还是AWS目录上执行。通知规则现在将根据目录而不是环境名称进行筛选。

  • [Breaking] 重命名 OpportunityIdentifier 为 Identifi AssignOpportunity er:Actions AcceptOpportunity, RejectOpportunity 现在使用标识符而不是与 UpdateOpportunity之 OpportunityIdentifier 保持一致。

  • 对于 ApnProgram CustomerUseCase,从 Enum 类型更改为 String,以及 UseCase:我们将将 Project.APNPrograms Marketing.ActivityUseCases、、以及 Project.CustomerUseCase 从枚举类型转换为字符串类型,以降低与更改值相关的风险。这些字段将仅接受来自预定义列表的值,但不接受软件开发工具包中原生可用的值。

  • 增强的错误处理:API 中的错误处理已得到显著改进,便于更轻松地调试和更快地解决问题。新的错误处理将错误分为两个阶段:1. 请求验证失败:检查数据类型和格式,或 2. 业务验证失败:有效负载中的所有问题都将在一个响应中列出,并指定有错误的字段。此综合反馈使您能够更有效地进行故障排除和更正错误。错误代码和格式已经标准化。

  • 客户来源标识符:合作伙伴能够在其请求中包含 X-Amzn-User-Agent 标头,这有助于识别流量来源。使用 [解决方案名称(包括解决方案提供商)] | [版本] 格式,例如:Partn AWS er CRM 连接器 | v2.0.1

  • 错误修复,已部署,SDK] 机会创建和AWS账户 ID 没有变化:合作伙伴现在可以启动机会,同时将AWS账户 ID 从 null 更改为有效值,而不会遇到错误。以前,一个错误使合作伙伴无法单独执行这些操作。

  • 错误修复,已部署,未更改 SDK] 解决方案与新机会的关联:合作伙伴可以将解决方案与新创建的机会关联起来。以前,当合作伙伴创造新的机会并同时关联解决方案时,解决方案信息就会丢失。此问题已得到解决。

  • 错误修复,已部署,SDK 未更改] 机会所有者的详细信息显示:已更正某些机会在组合的 “LastName” 字段中而不是预期的 “电子邮件”、“” 和 FirstName “LastName” 字段中显示所有者的详细信息的问题。

  • 错误修复,已部署,SDK 未更改] Customer.Account.WebsiteUrl 字段可选:当 Customer.Account.WebsiteUrl 字段为 “是” 时,该 AccessControls.NationalSecurity 字段已变为可选,从而使 API 行为与现有 UI 行为保持一致。如果该 AccessControls.NationalSecurity 字段为 “否” 或为空,则需要该 WebsiteUrl 字段作为业务验证。

  • 错误修复,已部署,SDK] 咨询合作伙伴的AWS账户 ID 要求没有变化:用户界面中显示咨询合作伙伴的AWS账户 ID 字段为可选字段的不一致问题已得到解决。根据文档,它现在是一个有条件的必填字段。

  • 错误修复,待部署 6/19,SDK] Co-sell 机会阶段改为 “已关闭丢失”:只要提供已关闭的丢失原因,合作伙伴现在就可以成功地将 Co-sell 机会阶段更新为 “已关闭丢失”。这解决了之前的错误,上面写着 “缺少必填字段:关闭机会时必须填写已关闭的丢失原因”。

  • 文档] 对文档的改进:对文档进行了多项改进以反映这些更改。

  • 待修复的已知问题和即将推出的功能列表:

    • 在对解决方案或产品执行 AssociateOpportunity 操作时,“选件” 中的错误消息显示不正确。

    • 能够在沙盒中远程创造机会并模拟AWS验证过程

    • 如果邮政编码的格式 XXXXX-XXXX 为美国,则返回 null。

    • “后续步骤” 和 “下一步历史记录” 不适用于标记为 “不需要来自的支持” 的机会AWS。

    • 无法获取客户业务问题描述超过 255 个字符的历史机会。

    • 能够删除待提交的商机。

    • LeadSource 在数据模型中不可用。

2024-06-21
测试版 5
  • 已更改 LifeCycle.ApprovalStatus 为 LifeCycle.ReviewStatus

  • 已更改 Insights.ReviewComments 为 LifeCycle.ReviewComments

  • 已添加 LifeCycle.ReviewStatusReason (新属性)

  • 在 “待定” 中添加了新值 PartnerAcceptance.Status

  • 发布了 dotnet、java、javascript、python、ruby 的开发工具包

  • 更新了 API 参考指南以反映上述更改。

2024-04-19
测试版 4
  • 添加了沙盒测试:能够在沙盒中测试机会事件通知。

  • 新增文档:引入了机会事件通知示例规则。

  • 添加了 SDK 版本:已发布适用于 Java (V2)、Javascript (V2)、(V3) 和 Python DotNet (V3) 的软件开发工具包。

  • 更新日期格式:已更新以符合 ISO 标准。

2024-03-04
测试版 3
  • 添加了更改日志文件:引入了更改日志文件,以便更好地跟踪更新和更改。

  • 更新了 API 参考指南 (PDF):发布了 PDF 格式的 API 参考指南的新版本。

  • 更新了 API 参考指南(网络版):更新了 API 参考指南的网页版。

  • 新增 DotNet SDK:发布了 DotNet SDK,扩展了我们对不同编程环境的支持。

  • 更新了 Python Boto 3 SDK (V2):发布了 Python Boto 3 SDK 的第 2 版,引入了新功能和改进。

2024-01-24
测试版 2
  • 新增 API 参考指南(网页版):发布了新版本的 API 参考指南(网页版)。注意:此版本需要在解压后运行本地 Web 服务器才能正常运行。

2024-01-07
测试版 1
  • 新增 Boto3(初始版本):推出了 Boto3 的初始版本,这是一款用于我们服务的 Python SDK。

  • 添加了 Beta 版计划指南:为我们的 Beta 版测试计划的参与者引入了指南。

  • 添加了 API 参考指南 (PDF):上传了 PDF 格式的 API 参考指南的第一个版本,为我们的 API 提供了全面的文档。

2023-12-15
测试版 0 此初始版本提供了一套功能,用于管理和优化合作伙伴中心中的AWS合作伙伴互动和机会。 2023-11-15