6.203. Steps
ステップを管理するサービスです。
名前 | Summary |
---|---|
| 外部ステップを既存のジョブまたは既存のステップに追加します。 |
| ステップの表現を取得します。 |
6.203.1. add POST
外部ステップを既存のジョブまたは既存のステップに追加します。
たとえば、識別子が 123
の job
にステップを追加するには、以下のリクエストを送信します。
POST /ovirt-engine/api/jobs/123/steps
リクエスト本文は、以下のようになります。
<step> <description>Validating</description> <start_time>2016-12-12T23:07:26.605+02:00</start_time> <status>started</status> <type>validating</type> </step>
応答は以下のようになります。
<step href="/ovirt-engine/api/jobs/123/steps/456" id="456"> <actions> <link href="/ovirt-engine/api/jobs/123/steps/456/end" rel="end"/> </actions> <description>Validating</description> <link href="/ovirt-engine/api/jobs/123/steps/456/statistics" rel="statistics"/> <external>true</external> <number>2</number> <start_time>2016-12-13T01:06:15.380+02:00</start_time> <status>started</status> <type>validating</type> <job href="/ovirt-engine/api/jobs/123" id="123"/> </step>
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In/Out | 追加されるステップ。 |
6.203.2. list GET
ステップの表現を取得します。
GET /ovirt-engine/api/job/123/steps
以下のような XML で応答を受け取ります。
<steps> <step href="/ovirt-engine/api/jobs/123/steps/456" id="456"> <actions> <link href="/ovirt-engine/api/jobs/123/steps/456/end" rel="end"/> </actions> <description>Validating</description> <link href="/ovirt-engine/api/jobs/123/steps/456/statistics" rel="statistics"/> <external>true</external> <number>2</number> <start_time>2016-12-13T01:06:15.380+02:00</start_time> <status>started</status> <type>validating</type> <job href="/ovirt-engine/api/jobs/123" id="123"/> </step> ... </steps>
返されるステップリストの順序は保証されません。
名前 | 型 | 方向 | Summary |
---|---|---|---|
| In | たどる 必要のある内部リンクを指定します。 | |
| In | 返すステップの最大数を設定します。 | |
| Out | ステップの表現。 |
6.203.2.1. follow
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.203.2.2. max
返すステップの最大数を設定します。指定されていない場合は、すべてのステップが返されます。