View a markdown version of this page

版本備註 - AWS Partner Central

AWS 合作夥伴中心 API 參考已重組。如需支援的 API 操作的詳細資訊,請參閱 AWS 合作夥伴中心 API 參考

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

版本備註

此頁面包含AWS Partner Central API 文件的重大變更摘要,從最新的更新開始。

修訂歷史記錄
變更 描述 日期
RC 6.0
  • AWS Partner Central 新增了新的合作夥伴收入測量 APIs。

2026-06-30
RC 5.3
  • ACE Resonate 更新:GetAwsOpportunitySummary回應已更新。

2026-06-16
RC 5.2
  • 歐元貨幣支援: CreateOpportunity除了 USD MRR 貨幣代碼之外, UpdateOpportunity、 和 CreateEngagementInvitation 現在接受 EUR 。當 AWS 分割區為 aws-eusc(AWS 歐洲主權雲端) 時,貨幣代碼必須為 EUR

  • 讀取操作中的 EUR:ListOpportunitiesGetOpportunityGetAwsOpportunitySummary 現在EUR會在 CurrencyCode 欄位中傳回aws-eusc分割區中的機會。

2026-03-30
RC 5.1
  • 歐元貨幣支援: CreateOpportunity除了 USD MRR 貨幣代碼之外, UpdateOpportunity、 和 CreateEngagementInvitation 現在接受 EUR 。當 AWS 分割區為 aws-eusc(AWS 歐洲主權雲端) 時,貨幣代碼必須為 EUR

  • 讀取操作中的 EUR:ListOpportunitiesGetOpportunityGetAwsOpportunitySummary 現在EUR會在 CurrencyCode 欄位中傳回aws-eusc分割區中的機會。

2026-03-30
RC 5
  • 引進的帳戶 API:將新的帳戶 API 新增至AWS Partner Central,讓合作夥伴能夠管理其帳戶資訊、註冊、設定檔、網域管理和合作夥伴連線。

  • 帳戶 API 參考文件:新增帳戶 API 的完整 API 參考文件,包括合作夥伴註冊、設定檔管理、網域驗證和帳戶連線工作流程。

  • 帳戶 API 記錄:新增帳戶 API 的記錄支援和文件,以協助稽核和追蹤 API 用量。

  • 帳戶 API 通知:新增了帳戶 API 的事件通知支援,可讓合作夥伴接收帳戶相關活動的即時更新,包括合作夥伴帳戶連線。

  • 帳戶 API 配額:新增帳戶 API 的服務配額文件。

  • 帳戶 API 的沙盒測試:新增帳戶 API 的沙盒測試功能,允許合作夥伴在非生產環境中測試帳戶管理工作流程。

  • 引進的優勢 API:將新的優勢 API 新增至AWS Partner Central,讓合作夥伴能夠透過集中式界面探索、申請和管理跨AWS合作夥伴計劃的優勢。

  • 利益 API 參考文件:新增利益 API 的完整 API 參考文件,涵蓋利益應用程式、配置和履行程序。

  • 效益 API 記錄:新增效益 API 的記錄支援和文件,以協助稽核和追蹤 API 使用情況。

  • 效益 API 通知:新增了效益 API 的事件通知支援,可讓合作夥伴接收效益應用程式和配置的即時更新。

  • Benefits API 配額:新增 Benefits API 的服務配額文件。

  • 效益 API 的沙盒測試:新增效益 API 的沙盒測試功能,允許合作夥伴在非生產環境中測試效益管理工作流程。

  • 已更新銷售 API:增強銷售 API 參與動作,以支援潛在客戶管理工作流程。

  • 銷售 API 文件更新:增強型銷售 API 文件,具有改善的結構和更新的潛在客戶管理工作流程。

  • 銷售 API 通知更新:增強參與和參與邀請事件的事件通知文件。

  • API 結構擴展:擴展文件結構,以支援四個不同的 APIs(帳戶、優勢、銷售和管道),每個 API 的許可、記錄、通知、配額和沙盒測試都有專用區段。

  • 增強型 API 用量文件:新增了帳戶和利益 APIs,其中包含詳細的工作流程和整合模式。

  • 支援的區域文件:新增帳戶和利益 APIs 支援AWS區域的文件。

  • 的新篩選條件ListOpportunities:新增TargetCloseDate篩選條件,以使用 YYYY-MM-DD 格式的 AfterTargetCloseDateBeforeTargetCloseDate 欄位,依其預期的結束日期啟用篩選機會。

2025-11-30
RC 4
  • 引進的頻道 API:將新的頻道 API 新增至AWS Partner Central,讓合作夥伴能夠管理頻道關係和partner-to-partner協同合作。

  • 頻道 API 參考文件:新增頻道 API 的完整 API 參考文件,包括所有可用的動作和資料模型。

  • 頻道 API 許可:新增了頻道 API 特定的 IAM 許可政策和存取控制文件。

  • 通道 API 記錄:新增通道 API 的記錄支援和文件,以協助稽核和追蹤 API 用量。

  • 頻道 API 通知:新增了頻道 API 的事件通知支援,可讓合作夥伴接收頻道相關活動的即時更新。

  • 頻道 API 配額:已新增頻道 API 的服務配額文件。

  • 頻道 API 的沙盒測試:新增頻道 API 的沙盒測試功能,允許合作夥伴在非生產環境中測試頻道工作流程。

  • API 結構重組:重組文件,以區分銷售 API 和頻道 API,以及每個 API 許可、記錄、通知和配額的專用區段。

  • 支援的區域文件:新增銷售和頻道 APIs 支援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變更為 ExpectedCustomerSpendExpectedCustomerSpend 現在包含新的屬性,例如 FrequencyTargetCompany

  • AWS機會摘要的新動作:現在透過名為 的單獨動作提供機會可見性GetAwsOpportunitySummary

  • 使用機會的工作流程更新:使用機會的工作流程已更新,以使用此版本中引入的新動作。

  • 使用機會的工作流程更新:使用機會的工作流程已更新為使用 EngagementInvitations,這改善了 AWS 提供的處理機會。

  • 追蹤更新的工作流程更新:追蹤更新的工作流程現在使用機會更新,提高監控機會狀態的清晰度和效率。

  • 列出動作的新篩選條件:新的篩選條件可用於 ListSolutionsListOpportunities動作。

    • 對於 ListSolutions,新的篩選條件為 FilterCategoryFilterIdentifierFilterStatus

    • 對於 ListOpportunities,新的篩選條件為 FilterCustomerCompanyNameFilterIdentifierFilterLastModifiedDateFilterLifeCycleStageFilterLifeCycleApprovalStatusFilterOrigin

  • 移除AccessControl子物件:已移除機會模型中的AccessControl子物件。 現在NationalSecurity是頂層屬性。

  • 屬性已重新定位至 GetAwsOpportunitySummaryAWSOpportunityTeam、洞見 (EngagementScoreNextBestAction)、原始伺服器 和 等屬性InvolvementType現在可透過 GetAwsOpportunitySummary 而非 取得GetOpportunity

  • InvolvementType 欄位簡介:引進 InvolvementType 欄位,以區分 Cosell 和僅限可見性的機會。

  • 事件名稱更新:事件已更新為 以反映變更。例如,建立的機會參與邀請現在是建立的參與邀請

  • 回應承載更新:所有回應承載現在都包含 ID 和/或 ARN。

  • 請求承載更新:所有請求承載現在都使用識別符作為輸入,接受 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做為 RECEIVER

2024-10-17
RC 2
  • 引進名為 OpportunityEngagementInvitation 的新實體。

  • 引進了新的動作:ListOpportunityEngagementInvitations。

  • 引進新的動作:GetOpportunityEngagementInvitation。

  • 引進新事件:「已建立機會參與邀請」。

  • 將 AcceptOpportunity 取代為 AcceptOpportunityEngagementInvitation。

  • 將 RejectOpportunity 取代為 RejectOpportunityEngagementInvitation。

  • 將 "Opportunity Accepted" 取代為 "Opportunity Engagement Invitation Accepted"。

  • 將「機會遭拒」取代為「機會參與邀請遭拒」。

  • PrimaryNeedsFromAWS 已變更為 PrimaryNeedsFromAws。

  • AWSOpportunityTeam 已變更為 AwsOpportunityTeam

  • AWSSalesLifeCycle 已變更為 AwsSalesLifeCycle

  • PrimaryNeedsFromAWSChangeReason 已變更為 PrimaryNeedsFromAwsChangeReason

  • AWSAccountId 已變更為 AwsAccountId

  • ExpectedMonthlyAWSRevenue 已變更為 ExpectedMonthlyAwsRevenue

  • AWSFundingUsed 已變更為 AwsFundingUsed

  • AWSMarketplaceOffers 已變更為 AwsMarketplaceOffers

  • Country 已變更為 CountryCode

  • PartnerOpportunityContact 已變更為 PartnerOpportunityTeam

  • 將 欄位更新Contact.TitleContact.BusinessTitle

  • 將 欄位更新ContactInfoOwnerInfo

  • 將AWS團隊從映射變更為清單。

  • 新增有關接受的 RejectionReasons 清單的詳細資訊。

  • 提供如何使用用戶端字符的資訊。

  • 包含如何使用 UpdateOpportunity 的詳細資訊。

  • 新增使用AWS產品和合作夥伴解決方案的指引。

  • 提供 OpportunityEngagementInvitation 實體的詳細資訊。

  • 更新 StateOrRegion 以包含已修訂的可接受值清單。

  • 實作多個錯誤修正,以改善效能和錯誤訊息。

2024-08-07
RC 1
  • 【中斷】 將 ApprovalStatus 重新命名為 ReviewStatus:我們已將 ApprovalStatus 欄位重新命名為 ReviewStatus,以更好地反映其用途。此外,我們推出了新的狀態,待提交,以指出草稿的機會。ReviewStatus 現在將接受下列值:待提交、已提交、審核中、已核准、已拒絕和必要動作。之前的草稿狀態將由待提交取代。

  • 【突破性】 SubmitOpportunity 動作簡介:已推出 SubmitOpportunity 新動作。與 CreateOpportunity 也提交機會的目前行為不同,您現在可以在等待提交狀態下建立機會,而無需立即連結解決方案或AWS產品。若要完成提交,請使用 AssociateOpportunity 動作來連結解決方案或產品,後面接著 SubmitOpportunity。此區隔在提交之前提供更好的 API 回應效能和靈活的準備階段。

  • 【中斷】 目錄參數的需求和沙盒端點的棄用:「gamma」端點 (partnercentral-selling-gamma.us-east-1.amazonaws.com://) 在 7/30/2024 之後將無法使用。所有 API 動作現在都需要 Catalog 參數來指定操作是在沙盒或AWS目錄上執行。通知規則現在會根據目錄而非 environmentName 進行篩選。

  • 【突破性】 將 OpportunityIdentifier 重新命名為識別符:ACTION AssignOpportunity、AcceptOpportunity 和 RejectOpportunity 現在採用識別符,而不是 OpportunityIdentifier,以與 UpdateOpportunity 保持一致。

  • 從列舉類型變更為 APNProgram CustomerUseCase 和 UseCase:我們將轉換 Project.APNPrograms、 Marketing.ActivityUseCases 和 Project.CustomerUseCase 從列舉類型變更為字串類型,以減少與變更值相關的風險。這些欄位只會接受預先定義清單中的值,但無法在 SDKs 中原生使用。

  • 增強型錯誤處理:已大幅改善 APIs中的錯誤處理,以簡化偵錯並更快速解決問題。新的錯誤處理結構錯誤分為兩個階段:1。請求驗證失敗:檢查資料類型和格式,或 2。業務驗證失敗:承載中的所有問題都會列在一個回應中,指定發生錯誤的欄位。此合併意見回饋可讓您更有效率地疑難排解和修正錯誤。錯誤代碼和格式已標準化。

  • 用戶端來源識別符:合作夥伴的能力在其請求中包含 X-Amzn-User-Agent 標頭,這有助於識別流量的來源。使用 格式 【Solution Name including solution provider】 | 【Version】 例如:AWS Partner CRM Connector | v2.0.1

  • 錯誤修正,已部署,未變更 SDK】 機會建立和AWS帳戶 ID:合作夥伴現在可以啟動機會,同時將AWS帳戶 ID 從 null 變更為有效值,而不會遇到錯誤。先前,錯誤會阻止合作夥伴分別執行這些動作。

  • 錯誤修正,已部署,無需變更軟體開發套件】 解決方案與新機會的關聯: 合作夥伴可以將解決方案與新建立的機會建立關聯。之前,當合作夥伴建立新的機會並同時與解決方案建立關聯時,解決方案資訊會遺失。此問題已解決。

  • 錯誤修正,已部署,未變更 SDK】 機會擁有者的詳細資訊顯示:已修正某些機會在合併的 "LastName" 欄位中顯示擁有者詳細資訊的問題,而非預期的 "Email"、"FirstName" 和 "LastName" 欄位。

  • 錯誤修正,已部署,未變更 SDK】 Customer.Account.WebsiteUrl 欄位選用:當 AccessControls.NationalSecurity 欄位為「是」時,Customer.Account.WebsiteUrl 欄位已設為選用,因此使 API 行為與現有的 UI 行為相符。如果 AccessControls.NationalSecurity 欄位為「否」或 null,則會需要 WebsiteUrl 欄位作為業務驗證。

  • 錯誤修正,已部署,未變更 SDK】諮詢合作夥伴AWS的帳戶 ID 需求:UI 中顯示AWS帳戶 ID 欄位為諮詢合作夥伴選用的不一致已解決。它現在是條件式必要欄位,如 文件所示。

  • 錯誤修正,若要在 6 月 19 日部署,SDK 沒有變更】 聯合銷售機會的階段關閉遺失:只要提供關閉遺失原因,合作夥伴現在可以成功將聯合銷售機會的階段更新為關閉遺失。這會解決先前指出「遺漏必要欄位:關閉機會時需要關閉遺失原因」的錯誤。

  • 文件】 文件的改進:對文件進行了幾項改進,以反映變更。

  • 待定修復的已知問題和即將推出的功能清單:

    • 使用解決方案或產品執行 AssociateOpportunity 動作時,來自優惠的錯誤訊息顯示不正確。

    • 能夠在沙盒中遠端建立機會和模擬AWS驗證程序

    • 當美國格式為 XXXXX-XXXX 時,郵遞區號會傳回 null。

    • 後續步驟和下一步歷史記錄不適用於標記為「不需要支援」的機會AWS。

    • 無法取得客戶業務問題描述超過 255 個字元的歷史機會。

    • 能夠刪除待提交的機會。

    • 資料模型中無法使用 LeadSource。

2024-06-21
Beta 5
  • 將 LifeCycle.ApprovalStatus 變更為 LifeCycle.ReviewStatus

  • 將 Insights.ReviewComments 變更為 LifeCycle.ReviewComments

  • 新增 LifeCycle.ReviewStatusReason (新屬性)

  • 已將新值「待定」新增至 PartnerAcceptance.Status

  • 已發行適用於 dotnet、java、javascript、python、 ruby SDKs。

  • 已更新 API 參考指南,以反映上述變更。

2024-04-19
Beta 4
  • 新增沙盒測試:能夠在沙盒中測試機會事件通知。

  • 新增文件:引入機會事件通知範例規則。

  • 已新增開發套件版本:已發行適用於 Java (V2)、Javascript (V2)、DotNet (V3) 和 Python (V3) SDKs。

  • 更新日期格式:更新以遵循 ISO 標準。

2024-03-04
Beta 3
  • 新增變更日誌檔案:引進變更日誌檔案,以更好地追蹤更新和變更。

  • 更新 API 參考指南 (PDF):發行 PDF 格式的 API 參考指南新版本。

  • 更新 API 參考指南 (Web 版本):更新 API 參考指南的 Web 版本。

  • 新增了 DotNet 開發套件:發佈了 DotNet 開發套件,擴展了我們對不同程式設計環境的支援。

  • 更新 Python Boto 3 開發套件 (V2):發行 Python Boto 3 開發套件的第 2 版,引入新功能和改進。

2024-01-24
Beta 2
  • 新增 API 參考指南 (Web 版本):發行 API 參考指南 (Web 版本) 的新版本。注意:此版本要求在擷取後執行本機 Web 伺服器,才能正常運作。

2024-01-07
Beta 1
  • 新增 Boto3 (初始版本):啟動 Boto3 的初始版本,Boto3 是我們服務的 Python 開發套件。

  • 已新增 Beta 版計畫指南:已為 Beta 版測試計畫的參與者推出指南。

  • 新增 API 參考指南 (PDF):以 PDF 格式上傳第一版的 API 參考指南,提供 API 的完整文件。

2023-12-15
Beta 0 此初始版本提供一套功能,可管理和最佳化AWS Partner Central 中的合作夥伴參與和機會。 2023-11-15