6.136. Job
ジョブを管理するサービス
| 名前 | 概要 |
|---|---|
|
| システムによってクリアされる外部ジョブの実行を設定します。 |
|
| 外部ジョブの実行を終了としてマークします。 |
|
| ジョブを取得します。 |
6.136.1. clear POST
システムによってクリアされる外部ジョブの実行を設定します。
たとえば、識別子 123 でジョブを設定するには、次の要求を送信します。
POST /ovirt-engine/api/jobs/clear
リクエスト本文は、以下のようになります。
<action/>
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In | アクションを非同期で実行する必要があるかどうかを示します。 |
6.136.2. end POST
外部ジョブの実行を終了としてマークします。
たとえば、識別子 123 でジョブを終了するには、次の要求を送信します。
POST /ovirt-engine/api/jobs/end
リクエスト本文は、以下のようになります。
<action> <force>true</force> <status>finished</status> </action>
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| 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>| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| Out | ジョブの表現を取得します。 |
6.136.3.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
