取消作業

注意

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

此 API 會取消供應專案目前正在進行中的作業。 使用擷 取作業 API 取得operationId 傳遞至此 API 的 。 取消通常是同步作業，但在某些複雜的案例中，可能需要新的作業來取消現有的作業。 在此情況下，HTTP 回應本文包含應該用來查詢狀態的作業位置。

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

URI 參數

名稱	說明	資料類型
publisherId	發行者標識碼，例如 contoso	String
offerId	供應項目標識碼	String
api-version	目前版本的 API	Date

頁首

名稱	值
內容-類型	application/json
授權	持有人您的令牌

本文範例

---

Request

{
   "metadata": {
     "notification-emails": "jondoe@contoso.com"
    }
}     

要求本文屬性

名稱	說明
notification-emails	要通知發佈作業進度的電子郵件標識碼逗號分隔清單。

回應

已移轉的供應專案

Location: /api/publishers/contoso/offers/contoso-offer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8?api-version=2017-10-31

未移轉的供應專案

Location: /api/operations/contoso$contoso-offer$2$preview?api-version=2017-10-31

回應標頭

名稱	值
Location	擷取此作業狀態的相對路徑。

回應狀態代碼

程式碼	說明
200	好。 已成功處理要求，且作業會同步取消。
202	接受。 已成功處理要求，且作業正在取消。 取消作業的位置會在響應標頭中傳回。
400	不正確的/格式要求。 錯誤回應本文可以提供詳細資訊。
403	禁止存取。 用戶端無法存取要求中指定的命名空間。
404	找不到。 指定的實體不存在。