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>