hetzner.hcloud.iso_info 模块 – 收集关于 Hetzner Cloud ISO 列表的信息。

注意

此模块是 hetzner.hcloud 集合（版本 4.2.2）的一部分。

如果您正在使用 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install hetzner.hcloud。您需要其他要求才能使用此模块，请参阅要求了解详细信息。

要在 playbook 中使用它，请指定：hetzner.hcloud.iso_info。

概要 

收集关于 Hetzner Cloud ISO 列表的信息。

别名：hcloud_iso_info

要求 

以下要求需要在执行此模块的主机上满足。

python-dateutil >= 2.7.5
requests >=2.20

参数 

参数	注释
api_endpoint 别名：endpoint 字符串	Hetzner Cloud 的 API 端点。您还可以使用 `HCLOUD_ENDPOINT` 环境变量来设置此选项。默认值： `"https://api.hetzner.cloud/v1"`
api_token 字符串 / 必填	Hetzner Cloud 的 API 令牌。您还可以使用 `HCLOUD_TOKEN` 环境变量来设置此选项。
architecture 字符串	筛选具有兼容架构的 ISO。选择 `"x86"` `"arm"`
id 整数	您要获取的 ISO 映像的 ID。如果提供的 ID 无效，模块将失败。
include_architecture_wildcard 布尔值	包括具有通配符架构（架构为 null）的 ISO。仅在指定架构筛选器时有效。选择 `false` `true`
name 字符串	您要获取的 ISO 的名称。

另请参阅 

另请参阅

Hetzner Cloud API 的文档: Hetzner Cloud API 的完整参考。

示例 

- name: Gather hcloud ISO type infos
  hetzner.hcloud.iso_info:
  register: output

- name: Print the gathered infos
  debug:
    var: output.hcloud_iso_info

返回值 

常见返回值在此处记录此处，以下是此模块独有的字段

键	描述
hcloud_iso_info 复杂类型	ISO 类型信息，以列表形式返回：始终
architecture 字符串	此 ISO 兼容的 CPU 架构类型。 None 表示对架构没有限制（通配符）。返回：在支持时示例： `"x86"`
deprecated 字符串	弃用 ISO 的 ISO 8601 时间戳，如果 ISO 仍然可用，则为 None。在弃用时间之后，将不再可能将 ISO 连接到服务器。此字段已弃用。请改用 `deprecation`。返回：始终示例： `"2024-12-01T00:00:00+00:00"`
deprecation 字典	描述资源是否已弃用、何时弃用以及如何弃用。如果此字段设置为 None，则资源未弃用。如果它有一个值，则被认为是已弃用的。返回：如果资源已弃用
announced 字符串	宣布弃用的日期。返回：始终示例： `"2021-11-01T00:00:00+00:00"`
unavailable_after 字符串	在此字段中的时间之后，该资源将无法从资源类型的通用列表端点获得，并且不能在新资源中使用。例如，如果这是一个映像，则在提及的日期之后，您不能使用此映像创建新服务器。返回：始终示例： `"2021-12-01T00:00:00+00:00"`
description 字符串	ISO 的描述返回：始终示例： `"Debian 12.0 (amd64/netinstall)"`
id 整数	ISO 的 ID 返回：始终示例： `22110`
name 字符串	ISO 的唯一标识符。仅为公共 ISO 设置返回：始终示例: `"debian-12.0.0-amd64-netinst.iso"`
类型字符串	ISO 的类型，可以是 `public` 或 `private` 中的一个。返回：始终示例: `"public"`

作者

Patrice Le Guyader (@patlegu)
Lukas Kaemmerling (@LKaemmerling)