vultr.cloud.plan_metal_info 模块 – 收集关于 Vultr 裸金属计划的信息

注意

此模块是 vultr.cloud 集合（版本 1.13.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install vultr.cloud。

要在 playbook 中使用它，请指定：vultr.cloud.plan_metal_info。

vultr.cloud 1.0.0 中的新增功能

概要 

收集有关可用于启动服务器的计划的信息。

参数 

参数	注释
api_endpoint 字符串	API 端点的 URL（不带尾部斜杠）。回退环境变量 `VULTR_API_ENDPOINT`。默认值： `"https://api.vultr.com/v2"`
api_key 字符串 / 必填	Vultr API 的 API 密钥。回退环境变量 `VULTR_API_KEY`。
api_retries 整数	如果 Vultr API 返回 HTTP 错误代码（例如 - 429 请求过多 - 500 内部服务器错误 - 504 网关超时），则重试的次数。回退环境变量 `VULTR_API_RETRIES`。默认值： `5`
api_retry_max_delay 整数	重试退避延迟以秒为单位呈指数增长，直到达到此最大值（以秒为单位）。回退环境变量 `VULTR_API_RETRY_MAX_DELAY`。默认值： `12`
api_timeout 整数	Vultr API 的 HTTP 超时。回退环境变量 `VULTR_API_TIMEOUT`。默认值： `180`
validate_certs 布尔值	验证 Vultr API 的 SSL 证书。选项 `false` `true` ← (默认)

说明 

注意

另请参阅 https://www.vultr.com/api/ 上的 API 文档。

示例 

- name: Gather Vultr bare metal plans information
  vultr.cloud.plan_metal_info:
  register: result

- name: Print the gathered information
  ansible.builtin.debug:
    var: result.vultr_plan_metal_info

返回值 

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

键	描述
vultr_api 字典	来自 Vultr API 的响应，并进行了一些添加/修改。已返回：成功
api_endpoint 字符串	用于 API 请求的端点。已返回：成功示例： `"https://api.vultr.com/v2"`
api_retries 整数	API 请求的最大重试次数。已返回：成功示例： `5`
api_retry_max_delay 整数	重试之间以秒为单位的指数退避延迟，直到达到此最大延迟值。已返回：成功示例： `12`
api_timeout 整数	用于 API 请求的超时。已返回：成功示例： `60`
vultr_plan_info 列表 / 元素=字符串	来自 Vultr API 的响应，以列表形式表示。已返回：成功
bandwidth 整数	带宽，单位为 MB。已返回：成功示例： `5120`
cpu_count 整数	CPU 数量。已返回：成功示例： `4`
cpu_model 字符串	CPU 型号。已返回：成功示例： `"E3-1270v6"`
cpu_threads 整数	CPU 线程数。已返回：成功示例： `8`
disk 整数	磁盘大小，单位为 GB。已返回：成功示例： `240`
disk_count 整数	磁盘数量。已返回：成功示例： `2`
id 字符串	计划的 ID。已返回：成功示例： `"vbm-4c-32gb"`
locations 列表 / 元素=字符串	该计划可用的位置列表。已返回：成功示例： `["ewr"]`
monthly_cost 整数	每月费用，单位为美元。已返回：成功示例： `300`
ram 整数	RAM 容量，单位为 MB。已返回：成功示例： `32768`
type 字符串	计划类型。已返回：成功示例： `"SSD"`

作者

Nate River (@vitikc)
Simon Baerlocher (@sbaerlocher)
René Moser (@resmo)