7.4.9. エラーの処理
エラーによっては、標準的な HTTP ステータスコード以外の詳しい説明が必要です。たとえば、API は応答エンティティーボディーで
障害 表現で失敗したリソース状態の更新またはアクションを報告します。障害には、理由 および 詳細 の文字列が含まれます。クライアントは、応答ステータスコードに応じて 障害 または 予想されるリソース表現を抽出して失敗した要求に対応する必要があります。このような場合は、個別のリソースドキュメントで明確に示されます。
PUT /ovirt-engine/api/collection/resource_id HTTP/1.1
Accept: application/xml
Content-Type: application/xml
<resource>
<id>id-update-test</id>
</resource>
HTTP/1.1 409 Conflict
Content-Type: application/xml
<fault>
<reason>Broken immutability constraint</reason>
<detail>Attempt to set immutable field: id</detail>
</fault>