6.137. ジョブ
ジョブを管理するサービス。
| 名前 | 概要 |
|---|---|
|
| 外部ジョブを追加します。 |
|
| ジョブの表現を取得します。 |
6.137.1. add POST
外部ジョブを追加します。
たとえば、次のリクエストでジョブを追加する場合で、
POST /ovirt-engine/api/jobs
リクエスト本文は、以下のようになります。
<job> <description>Doing some work</description> <auto_cleared>true</auto_cleared> </job>
応答は以下のようになります。
<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>Doing some work</description>
<link href="/ovirt-engine/api/jobs/123/steps" rel="steps"/>
<auto_cleared>true</auto_cleared>
<external>true</external>
<last_updated>2016-12-13T02:15:42.130+02:00</last_updated>
<start_time>2016-12-13T02:15:42.130+02:00</start_time>
<status>started</status>
<owner href="/ovirt-engine/api/users/456" id="456"/>
</job>| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In/Out | 追加されるジョブ。 |
6.137.2. list GET
ジョブの表現を取得します。
GET /ovirt-engine/api/jobs
以下のような XML で応答を受け取ります。
<jobs>
<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>
...
</jobs>返されるジョブ一覧の順序は保証されません。
| 名前 | タイプ | 方向 | 概要 |
|---|---|---|---|
|
| In |
| |
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| Job[] | Out | ジョブの表現。 |
|
| In | 返すジョブの最大数を設定します。 | |
|
| In | 返されたホストを制限するために使用されるクエリー文字列。 |
6.137.2.1. case_sensitive
search パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。デフォルト値は true です。つまり、大文字と小文字の区別が考慮されます。ケースを無視する場合は、false に設定します。
6.137.2.2. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.137.2.3. max
返すジョブの最大数を設定します。指定されていない場合は、すべてのジョブが返されます。
