附录 A. API 响应代码

Red Hat Satellite 6 API 为 API 调用提供 HTTP 响应状态代码。以下代码适用于 Satellite API 中所有资源:

表 A.1. API 响应代码

响应解释

200 OK

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

201 已创建

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

301 永久移动

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

400 错误请求

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

401 未授权

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

403 Forbidden

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

404 not Found

带有给定 ID 的记录不存在。当请求的记录不存在时,它可能出现在显示和删除操作中;或者,当其中一个关联的记录不存在时,可以对其进行创建、更新和删除操作。

409 冲突

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

415 不支持的 Media 类型

HTTP 请求的内容类型不是 JSON。

422 不可处理实体

因验证错误而创建实体失败。仅适用于创建或更新操作。

500 内部服务器错误

意外的内部服务器错误。

503 服务 Unavailable

服务器没有运行。