非同期操作と同期操作
同期操作では、REST API操作の完了後に応答が返されます。
アプライアンスのバックアップなどの非同期操作では、タスクのURIがLocationレスポンスヘッダーに返されます。タスクのURIを使用して、操作の現在のステータスを取得したり、タスクが完了した後で、関連付けられたリソースを取得したりすることができます。
-
これはすべての非同期APIに共通の動作です。
-
動作はAPIによって異なるため、操作の現在のステータスを取得するのに他の動作に依存しないでください(返されたレスポンスボディの内容など)。特定の各APIの動作については、APIリファレンスを参照してください。
-
同じAPIバージョンであっても、将来変更される可能性があるため、その他の動作の実行には依存しないでください。
アプライアンスのバックアップの非同期RESTコールから返されるレスポンスヘッダーの例
HTTP/1.1 202 Accepted
Date: Tue, 26 Jan 2016 23:19:14 GMT
Server: Apache
Location: https://<hostname>/rest/tasks/39CE80C4-EF2C-4717-90EA-EF166E83B49F
Content-Length: 0
cache-control: no-cache