擷取供應項目狀態

發行項
03/06/2025

注意

Cloud Partner 入口網站 API 已與整合，並將繼續在合作夥伴中心運作。轉換引進了小型變更。檢閱 Cloud Partner 入口網站 API 參考中列出的變更，以確保您的程式代碼在轉換至合作夥伴中心後繼續運作。 CPP API 應該只用於轉換至合作夥伴中心之前已整合的現有產品：新產品應使用合作夥伴中心提交 API。

擷取供應專案的目前狀態。

GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/status?api-version=2017-10-31

URI 參數

名稱	描述	數據類型
publisherId	發行者標識碼，例如 `Contoso`	字串
offerId	可唯一識別供應專案的 GUID	字串
api-version	最新版的 API	日期

名字	價值
Content-Type	`application/json`
授權	`Bearer YOUR_TOKEN`

本文範例

回應

  {
      "status": "succeeded",
      "messages": [],
      "steps": [
      {
          "estimatedTimeFrame": "< 15 min",
          "id": "displaydummycertify",
          "stepName": "Validate Pre-Requisites",
          "description": "Offer settings provided are validated.",
          "status": "complete",
          "messages": [
              {
                  "messageHtml": "Step completed.",
                  "level": "information",
                  "timestamp": "2018-03-16T17:50:45.7215661Z"
              }
          ],       
          "progressPercentage": 100
      },
      {
          "estimatedTimeFrame": "~2-3 days",
          "id": "displaycertify",
          "stepName": "Certification",
          "description": "Your offer is analyzed by our certification systems for issues.",
          "status": "notStarted",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "< 1 day",
          "id": "displayprovision",
          "stepName": "Provisioning",
          "description": "Your virtual machine is being replicated in our production systems.",
          "status": "notStarted",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "< 1 hour",
          "id": "displaypackage",
          "stepName": "Packaging and Lead Generation Registration",
          "description": "Your virtual machine is being packaged for customers. Additionally, lead systems are being configured and set up.",
          "status": "notStarted",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "< 1 hour",
          "id": "publisher-signoff",
          "stepName": "Publisher signoff",
          "description": "Offer is available to preview. Ensure that everything looks good before making your offer live.",
          "status": "complete",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "~2-5 days",
          "id": "live",
          "stepName": "Live",
          "description": "Offer is publicly visible and is available for purchase.",
          "status": "complete",
          "messages": [],
          "progressPercentage": 0
      }
      ],
      "previewLinks": [],
      liveLinks": [],
  }

回應本文屬性

名稱	描述
地位	供應項目的狀態。如需可能值的清單，請參閱下方供應項目狀態。
消息	與供應專案相關聯的訊息陣列
步驟	供應專案發佈期間所經歷的步驟數位
estimatedTimeFrame	以易記格式完成此步驟所需的時間估計
id	步驟的標識碼
stepName	步驟的名稱
描述	步驟的描述
地位	步驟的狀態。如需可能值的清單，請參閱下方步驟狀態。
消息	與步驟相關的訊息陣列
processPercentage	步驟完成百分比
previewLinks	目前未實作
liveLinks	目前未實作
notificationEmails	已淘汰已移轉至合作夥伴中心的供應專案。已移轉供應專案的通知電子郵件將會傳送至 [帳戶設定] 中賣方聯繫人資訊下指定的電子郵件。針對未移轉的供應專案，以逗號分隔的電子郵件地址清單，以通知作業進度

回應狀態代碼

程式代碼	描述
200	`OK` - 已成功處理要求，並傳回供應專案的目前狀態。
400	`Bad/Malformed request` - 錯誤回應本文可能包含詳細資訊。
404	`Not found` - 指定的實體不存在。

供應項目狀態

名稱	描述
NeverPublished	供應項目從未發佈過。
NotStarted	供應專案是新的，且未啟動。
WaitingForPublisherReview	供應專案正在等候發行者核准。
運行	正在處理供應專案提交。
成功	供應專案提交已完成處理。
取消	已取消供應專案提交。
失敗	供應專案提交失敗。

步驟狀態

名稱	描述
NotStarted	步驟尚未啟動。
InProgress	步驟正在執行。
WaitingForPublisherReview	步驟正在等候發行者核准。
WaitingForApproval	步驟正在等候程式核准。
封鎖	已封鎖步驟。
拒絕	步驟遭到拒絕。
完成	步驟已完成。
取消	步驟已取消。

共用方式為