Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 2 章 API 参考

完整 API 参考位于您的卫星服务器上，位于 https://satellite.example.com/apidoc/v2.html。请注意，即使 Satellite 6 API 的版本 1 和 2 可用，但红帽仅支持版本 2。

2.1. 了解 API 语法
复制链接

内置 API 参考显示 API 路由或路径，前面带有 HTTP 动词： 

HTTP_VERB API_ROUTE
Copy to Clipboard Toggle word wrap

要使用 API，请使用 curl 命令语法和参考文档中的 API 路由构建命令： 

$ curl --request HTTP_VERB \
1 

--insecure \
2 

--user sat_username:sat_password \
3 

--data @file.json \
4 

--header "Accept:application/json" \
5 

--header "Content-Type:application/json" \
6 

--output file
7 

API_ROUTE \
8 

| python -m json.tool
9
Copy to Clipboard Toggle word wrap
1
要将 curl 用于 API 调用，请使用 --request 选项指定 HTTP 动词。例如，-- request POST。
2
添加 --insecure 选项以跳过 SSL peer 证书验证检查。
3
使用 --user 选项提供用户凭据。
4
对于 POST 和 PUT 请求，请使用 --data 选项传递 JSON 格式的数据。更多信息请参阅 第 4.1.1 节 “将 JSON 数据传递给 API 请求”。
5 6
使用 --data 选项传递 JSON 数据时，您必须使用 --header 选项指定以下标头。更多信息请参阅 第 4.1.1 节 “将 JSON 数据传递给 API 请求”。
7
从卫星服务器下载内容时，请使用 --output 选项指定输出文件。
8
使用以下格式的 API 路由： https://satellite.example.com/katello/api/activation_keys。在卫星 6 中，API 的版本 2 是默认值。因此，不需要在 API 调用的 URL 中使用 v2。
9
将输出重定向到 Python json.tool 模块，以便可以更容易地读取输出。

2.1.1. 使用 GET HTTP Verb
复制链接

使用 GET HTTP 动词从 API 获取有关现有条目或资源的数据。

Example

本例请求 Satellite 主机数量：

请求示例： 

$ curl --request GET --insecure --user sat_username:sat_password \
https://satellite.example.com/api/hosts | python -m json.tool
Copy to Clipboard Toggle word wrap

响应示例： 

{
  "total": 2,
  "subtotal": 2,
  "page": 1,
  "per_page": 20,
  "search": null,
  "sort": {
    "by": null,
    "order": null
  },
  "results":
output truncated
Copy to Clipboard Toggle word wrap

API 的响应表示总数中有两个结果，这是结果的第一个页面，并且每个页面的最大结果设置为 20。更多信息请参阅 第 2.2 节 “了解 JSON 响应格式”。

2.1.2. 使用 POST HTTP Verb
复制链接

使用 POST HTTP 动词将数据提交到 API，以创建条目或资源。您必须以 JSON 格式提交数据。更多信息请参阅 第 4.1.1 节 “将 JSON 数据传递给 API 请求”。

Example

这个示例创建了一个激活码。

  1. 创建包含以下内容的测试文件（如 activation-key.json ）： 

    {"organization_id":1, "name":"TestKey", "description":"Just for testing"}
    Copy to Clipboard Toggle word wrap

  2. 通过在 activation-key.json 文件中应用数据来创建激活码：

    请求示例： 

    $ curl --header "Accept:application/json" \
--header "Content-Type:application/json" --request POST \
--user sat_username:sat_password --insecure \
--data @activation-key.json \
https://satellite.example.com/katello/api/activation_keys \
| python -m json.tool
    Copy to Clipboard Toggle word wrap

    响应示例： 

    {
    "id": 2,
    "name": "TestKey",
    "description": "Just for testing",
    "unlimited_hosts": true,
    "auto_attach": true,
    "content_view_id": null,
    "environment_id": null,
    "usage_count": 0,
    "user_id": 3,
    "max_hosts": null,
    "release_version": null,
    "service_level": null,
    "content_overrides": [

    ],
    "organization": {
        "name": "Default Organization",
        "label": "Default_Organization",
        "id": 1
    },
    "created_at": "2017-02-16 12:37:47 UTC",
    "updated_at": "2017-02-16 12:37:48 UTC",
    "content_view": null,
    "environment": null,
    "products": null,
    "host_collections": [

    ],
    "permissions": {
        "view_activation_keys": true,
        "edit_activation_keys": true,
        "destroy_activation_keys": true
    }
}
    Copy to Clipboard Toggle word wrap
  3. 验证是否存在新的激活码。在 Satellite Web UI 中，导航到 Content > Activation keys 以查看您的激活码。

2.1.3. 使用 PUT HTTP Verb
复制链接

使用 PUT HTTP 动词更改现有值或附加到现有资源。您必须以 JSON 格式提交数据。更多信息请参阅 第 4.1.1 节 “将 JSON 数据传递给 API 请求”。

Example

本例更新上例中创建的 TestKey 激活密钥。

  1. 编辑之前创建的 activation-key.json 文件，如下所示： 

    {"organization_id":1, "name":"TestKey", "description":"Just for testing","max_hosts":"10" }
    Copy to Clipboard Toggle word wrap

  2. 在 JSON 文件中应用更改：

    请求示例： 

    $ curl --header "Accept:application/json" \
--header "Content-Type:application/json" --request PUT \
--user sat_username:sat_password --insecure \
--data @activation-key.json \
https://satellite.example.com/katello/api/activation_keys/2 \
| python -m json.tool
    Copy to Clipboard Toggle word wrap

    响应示例： 

    {
    "id": 2,
    "name": "TestKey",
    "description": "Just for testing",
    "unlimited_hosts": false,
    "auto_attach": true,
    "content_view_id": null,
    "environment_id": null,
    "usage_count": 0,
    "user_id": 3,
    "max_hosts": 10,
    "release_version": null,
    "service_level": null,
    "content_overrides": [

    ],
    "organization": {
        "name": "Default Organization",
        "label": "Default_Organization",
        "id": 1
    },
    "created_at": "2017-02-16 12:37:47 UTC",
    "updated_at": "2017-02-16 12:46:17 UTC",
    "content_view": null,
    "environment": null,
    "products": null,
    "host_collections": [

    ],
    "permissions": {
        "view_activation_keys": true,
        "edit_activation_keys": true,
        "destroy_activation_keys": true
    }
}
    Copy to Clipboard Toggle word wrap
  3. 在 Satellite Web UI 中，导航到 Content > Activation keys 来验证更改。

2.1.4. 使用 DELETE HTTP Verb
复制链接

要删除资源，请使用 DELETE 动词和一个 API 路由，其中包含您要删除的资源 ID。

Example

这个示例删除 ID 为 2 的 TestKey 激活码：

请求示例： 

$ curl --header "Accept:application/json" \
--header "Content-Type:application/json" --request DELETE \
--user sat_username:sat_password --insecure \
https://satellite.example.com/katello/api/activation_keys/2 \
| python -m json.tool
Copy to Clipboard Toggle word wrap

响应示例： 

output omitted
    "started_at": "2017-02-16 12:58:17 UTC",
    "ended_at": "2017-02-16 12:58:18 UTC",
    "state": "stopped",
    "result": "success",
    "progress": 1.0,
    "input": {
        "activation_key": {
            "id": 2,
            "name": "TestKey"
output truncated
Copy to Clipboard Toggle word wrap

2.1.5. 与 API 参考相关的 API 错误信息
复制链接

API 使用 RAILs 格式来指示错误： 

Nested_Resource.Attribute_Name
Copy to Clipboard Toggle word wrap

这会转换为 API 引用中使用的以下格式： 

Resource[Nested_Resource_attributes][Attribute_Name_id]
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat