匯出 (0) 列印
全部展開

排程器 REST API 參考

更新日期: 2013年10月

本主題描述如何在 Azure 排程器中,使用排程器管理 REST API 執行一般工作。

  • 需要有效的 Azure 帳戶和使用中的 Azure 訂用帳戶。本文件假設您已有使用中的訂用帳戶及相關聯的訂用帳戶識別碼。

  • Azure 訂用帳戶的管理憑證。需要管理憑證,才能在訂用帳戶中驗證資源的用戶端存取權。您必須使用包含公開金鑰且副檔名為 .cer 的 X-509 v3 憑證。如需如何建立管理憑證的詳細資訊,請參閱在 Azure 中管理憑證

排程器應用程式開發介面提供與 Azure 排程器服務互動的一組 RESTful 作業,以管理您的排程工作和工作集合。

排程器管理應用程式開發介面可執行一組核心網站管理案例:

  1. 以程式設計的方式建立、更新及刪除「工作集合」

  2. 以程式設計的方式建立、更新及刪除排程工作

  3. 以程式設計的方式檢視工作集合和工作清單

  4. 以程式設計的方式檢視工作狀態和記錄

Azure 排程器 REST API 公開下列資源階層,以管理您的工作和工作集合:

/cloudservices

   /jobcollections

      /jobs

         /history

若要判斷服務是否已完成處理要求,請呼叫取得操作狀態,特別是您必須在後續呼叫中使用該資源,或必須確保修改或刪除作業確實發生時。如需非同步作業的詳細資訊,請參閱追蹤非同步服務管理要求

您可以使用 HTTP POST 或 PUT 動詞命令建立新資源。如果成功建立資源,則會傳回 HTTP 200 (確定)、201 (已建立) 或 202 (已接受) 狀態碼,並在回應主體中包含序列化資源物件。如果用戶端嘗試建立已存在的資源,則會傳回 HTTP 400 (不正確的要求) 或 409 (衝突) 狀態碼。

若要讀取現有資源的目前狀態,請使用 HTTP GET 動詞命令。如果資源存在,則回應狀態碼為 200 或 202,且回應主體會包含序列化物件。如果資源不存在,則回應狀態碼為 400 (不正確的要求) 或 404 (找不到)。

您可以使用 HTTP PUT 或 PATCH 動詞命令更新現有的資源。此物件的名稱會在 URL 字串中傳遞,且物件的新狀態會在要求主體中傳遞。如果成功更新資源,則會傳回 HTTP 200 或 202 狀態碼。如果要更新的資源不存在,則會傳回 HTTP 400 (不正確的要求) 或 404 (找不到) 狀態碼。

您可以使用 HTTP DELETE 動詞命令刪除現有的資源。物件的名稱會在 URL 字串中傳遞。如果成功刪除資源,則會傳回 HTTP 200 或 202 狀態碼。如果物件已遭到刪除或不存在,則會傳回 HTTP 400 或 404。

若要順利呼叫 Azure 排程器應用程式開發介面,您需要與訂用帳戶相關聯的管理憑證。如需詳細資訊,請參閱驗證服務管理要求。排程器服務端點只會透過 HTTPS 公開,如此將有助於減少資訊洩漏的威脅。

顯示:
© 2014 Microsoft