Documentation

3. 约定

Tower 使用基于服务器上 /api/ 的标准 REST API。出于兼容性原因,API 进行了版本化控制,目前 api/v2/ 是最新的可用版本。您可以通过查询 /api/ 来查看有关哪些 API 版本可用的信息。

从 Ansible Tower 版本 3.6 开始已停用 /api/v1/。如需了解 v1 的详细信息,请参阅先前版本的 api。

您可能需要在 POST 或**PUT** 请求中相应指定内容/类型。

  • PUT:更新特定资源(按标识符)或资源集合。如果事先知道资源标识符,PUT 也可以用于创建特定资源。

  • POST:创建新资源。也用作操作的捕获全部动词,不适合于其他类别。

没有以 "/" 结尾的所有 URI 都接收 301 重定向。

注解

Ansible Tower v3.8.0 API 更改:保留附加到作业模板记录的 extra_vars 的格式。之前,YAML 将转换为 JSON 并返回为 JSON。在 2.2.0 和更新版本中,YAML 返回保留格式和注释的 YAML,JSON 将返回为 JSON。