非同期操作と同期操作

同期操作では、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