hetzner.hcloud.volume_info 模块 – 收集关于您的 Hetzner Cloud 卷的信息。

注意

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

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

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

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

概要 

收集关于您的 Hetzner Cloud 卷的信息。

别名：hcloud_volume_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` 环境变量设置此选项。
id 整数	您要获取的卷的 ID。如果提供的 ID 无效，该模块将失败。
label_selector 字符串	您要获取的卷的标签选择器。
name 字符串	您要获取的卷的名称。

另请参阅 

另请参阅

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

示例 

- name: Gather hcloud Volume infos
  hetzner.hcloud.volume_info:
  register: output
- name: Print the gathered infos
  debug:
    var: output.hcloud_volume_info

返回值 

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

键	描述
hcloud_volume_info 复杂	卷信息作为列表返回值：总是
delete_protection 布尔值在 hetzner.hcloud 0.1.0 中添加	如果卷受到删除保护，则为 True 返回值：总是
id 整数	卷的数字标识符返回值：总是示例： `1937415`
labels 字典	用户定义的标签（键值对）返回值：总是
linux_device 字符串在 hetzner.hcloud 0.1.0 中添加	包含卷的设备的路径。返回值：总是示例： `"/dev/disk/by-id/scsi-0HC_Volume_12345"`
location 字符串	卷所在的地点名称返回值：总是示例： `"fsn1"`
name 字符串	卷的名称返回值：总是示例： `"my-volume"`
server 字符串	卷所连接的服务器的名称返回值：总是示例： `"my-server"`
size 字符串	卷的大小返回值：总是示例： `"10"`

作者

Lukas Kaemmerling (@LKaemmerling)