擷取供應專案

發行項
06/14/2024

注意

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

擷取發行者命名空間下供應專案的摘要清單。

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

URI 參數

名稱	說明	資料類型
publisherId	發行者標識碼，例如 `contoso`	String
api-version	最新版的 API	Date

名稱	值
內容-類型	`application/json`
授權	`Bearer YOUR_TOKEN`

本文範例

回應

  200 OK 
  [ 
      {  
          "offerTypeId": "microsoft-azure-virtualmachines",
          "publisherId": "contoso",
          "status": "published",
          "id": "059afc24-07de-4126-b004-4e42a51816fe",
          "version": 1,
          "definition": {
              "displayText": "Contoso Virtual Machine"
          },
          "changedTime":"2017-05-23T23:33:47.8802283Z"
      }
  ]

回應本文屬性

名稱	說明
offerTypeId	識別供應項目類型
publisherId	可唯一識別發行者的標識碼
status	供應項目的狀態。如需可能值的清單，請參閱下方的供應項目狀態。
id	可唯一識別發行者命名空間中供應專案的 GUID。
version	目前版本的供應專案。客戶端無法修改 version 屬性。它會在每個發佈之後遞增。
定義	包含工作負載實際定義的摘要檢視。若要取得詳細的定義，請使用擷取特定供應專案 API。
changedTime	上次修改供應專案的 UTC 時間

回應狀態代碼

程式碼	說明
200	`OK` - 已成功處理要求，且發行者下的所有供應項目都會傳回給用戶端。
400	`Bad/Malformed request` - 錯誤回應本文可能包含詳細資訊。
403	`Forbidden` - 客戶端無法存取指定的命名空間。
404	`Not found` - 指定的實體不存在。

供應項目狀態

名稱	說明
NeverPublished	供應項目從未發佈過。
未開始	供應專案是新的，但尚未啟動。
WaitingForPublisherReview	供應專案正在等候發行者核准。
執行中	正在處理供應專案提交。
已成功	供應專案提交已完成處理。
已取消	已取消供應專案提交。
失敗	供應專案提交失敗。

共用方式為