附录 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 服务不可用 | 服务器没有运行。 |