附录 A. API 响应代码

Red Hat Satellite 6 API 为 API 调用提供 HTTP 响应代码。以下代码对于 Satellite API 中所有资源是常见的。

表 A.1. API 响应代码

响应解释

200 OK

对于成功的请求操作: show、index、update 或 delete (GET、PUT、DELETE 请求)。

201 created

用于成功创建操作(POST 请求)。

301 永久移动

当 Satellite 被限制为使用 HTTPS 和 HTTP 时进行重定向。

400 错误请求

缺少所需的参数,或者搜索查询具有无效语法。

401 未授权

授权用户失败(例如,不正确的凭证)。

403 Forbidden

用户没有执行操作或读取资源的权限不足,或者操作一般不受支持。

404 not Found

具有给定 ID 的记录不存在。当请求的记录不存在时,它可能会出现在显示和删除操作中;或者,当其中一个关联的记录不存在时,它可能会在显示和删除操作中。

409 冲突

由于现有依赖项而无法删除记录(例如,带有主机的主机组)。

415 不支持的介质类型

HTTP 请求的内容类型是 JSON。

422 Unprocessable Entity

由于某些验证错误,创建实体失败。只适用于创建或更新操作。

500 内部服务器错误

意外的内部服务器错误。

503 服务不可用

服务器没有运行。