7.3.11. 非同期リクエスト
ユーザー
が Expect: 201 で作成された ヘッダーで上書きしない限り、API は非同期 POST 要求を実行します。
たとえば、仮想マシン、ディスク、スナップショット、テンプレートなどの特定のリソースは非同期で作成されます。非同期リソースの作成リクエストにより、
202 Accepted ステータスになります。202 Accepted リソースの初期ドキュメント構造には、create _status 要素と作成ステータス 更新用のリンクも含まれています。以下に例を示します。
POST /ovirt-engine/api/collection HTTP/1.1
Accept: application/xml
Content-Type: application/xml
<resource>
<name>Resource-Name</name>
</resource>
HTTP/1.1 202 Accepted
Content-Type: application/xml
<resource id="resource_id" href="/ovirt-engine/api/collection/resource_id">
<name>Resource-Name</name>
<creation_status>
<state>pending</state>
</creation status>
<link rel="creation_status"
href="/ovirt-engine/api/collection/resource_id/creation_status/creation_status_id"/>
...
</resource>
creation_status リンクへの GET リクエストは、作成ステータスの更新を提供します。
GET /ovirt-engine/api/collection/resource_id/creation_status/creation_status_id HTTP/1.1
Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
<creation id="creation_status_id"
href="/ovirt-engine/api/collection/resource_id/creation_status/creation_status_id">
<status>
<state>complete</state>
</status>
</creation>
非同期リソースの作成を上書きするには、
Expect: 201-created ヘッダーが必要です。
POST /ovirt-engine/api/collection HTTP/1.1
Accept: application/xml
Content-Type: application/xml
Expect: 201-created
<resource>
<name>Resource-Name</name>
</resource>