6.136. ジョブ
ジョブを管理するサービス
名前 | Summary |
---|---|
| システムによってクリアされる外部ジョブの実行を設定します。 |
| 外部ジョブの実行を終了としてマークします。 |
| ジョブを取得します。 |
6.136.1. clear POST
システムによってクリアされる外部ジョブの実行を設定します。
たとえば、識別子 123
でジョブを設定するには、次の要求を送信します。
POST /ovirt-engine/api/jobs/clear
リクエスト本文は、以下のようになります。
<action/>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | アクションを非同期で実行する必要があるかどうかを示します。 |
6.136.2. end POST
外部ジョブの実行を終了としてマークします。
たとえば、識別子 123
でジョブを終了するには、次の要求を送信します。
POST /ovirt-engine/api/jobs/end
リクエスト本文は、以下のようになります。
<action> <force>true</force> <status>finished</status> </action>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | アクションを非同期で実行する必要があるかどうかを示します。 | |
| In | ジョブを強制終了する必要があるかどうかを示します。 | |
| In | ジョブを正常終了または失敗としてマークする必要があるかどうかを示します。 |
6.136.2.1. succeeded
ジョブを正常終了または失敗としてマークする必要があるかどうかを示します。
このパラメーターはオプションであり、デフォルト値は true
です。
6.136.3. get GET
ジョブを取得します。
GET /ovirt-engine/api/jobs/123
以下のような XML で応答を受け取ります。
<job href="/ovirt-engine/api/jobs/123" id="123"> <actions> <link href="/ovirt-engine/api/jobs/123/clear" rel="clear"/> <link href="/ovirt-engine/api/jobs/123/end" rel="end"/> </actions> <description>Adding Disk</description> <link href="/ovirt-engine/api/jobs/123/steps" rel="steps"/> <auto_cleared>true</auto_cleared> <end_time>2016-12-12T23:07:29.758+02:00</end_time> <external>false</external> <last_updated>2016-12-12T23:07:29.758+02:00</last_updated> <start_time>2016-12-12T23:07:26.593+02:00</start_time> <status>failed</status> <owner href="/ovirt-engine/api/users/456" id="456"/> </job>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | たどる 必要のある内部リンクを指定します。 | |
| Out | ジョブの表現を取得します。 |
6.136.3.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。