附录 A. API 响应代码

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

表 A.1. API 响应代码

响应解释

200 OK

对于成功请求操作:显示、索引、更新或删除(GET、PUT、DELETE 请求)。

201 已创建

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

301 移动 permanently

当 Satellite 限制为使用 HTTPS 但尝试使用 HTTP 时,会进行重定向。

400 错误请求

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

401 未授权

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

403 Forbidden

用户没有足够的权限来执行该操作或读取资源,否则不支持该操作。

404 not Found

给定 ID 的记录不存在。它可能会出现在 show 中,并在请求的记录不存在时删除操作;或者,当相关记录不存在时,会创建和删除操作。

409 冲突

因为缺少依赖项(例如,带有主机的主机组)无法删除记录。

415 不支持的介质类型

HTTP 请求的内容类型是 JSON。

422 Unprocessable Entity

由于某些验证错误,无法创建实体。仅适用于创建或更新操作。

500 内部服务器错误

意外的内部服务器错误。

503 服务不可用

服务器没有运行。