vultr.cloud.vpc2 模块 – 在 Vultr 上管理 VPC 2.0

注意

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

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

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

要在剧本中使用它，请指定： vultr.cloud.vpc2。

vultr.cloud 1.9.0 中的新增功能

概要 

创建和删除 VPC 2.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`
description 别名：name 字符串 / 必需	VPC 的描述。
ip_block 字符串	VPC 的子网。如果 state=present，则为必需。
ip_type 字符串	IP 版本的类型。如果 state=present，则为必需。选项 `"v4"` ← (默认)
prefix_length 整数	CIDR 表示法中子网掩码的位数，例如 24。如果 state=present，则为必需。
region 字符串	VPC 将关联到的区域。如果 state=present，则为必需。
state 字符串	VPC 的状态。选项 `"present"` ← (默认) `"absent"`
validate_certs 布尔值	验证 Vultr API 的 SSL 证书。选项 `false` `true` ← (默认)

备注 

注意

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

示例 

- name: Ensure a VPC is present
  vultr.cloud.vpc2:
    description: my VPC.
    ip_block: 10.99.1.0
    prefix_length: 24
    region: ewr

- name: Ensure a VPC is absent
  vultr.cloud.vpc2:
    description: my VPC.
    state: absent

返回值 

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

键	描述
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_vpc2 字典	来自 Vultr API 的响应。已返回：成功
date_created 字符串	创建 VPC 的日期。已返回：成功示例： `"2023-08-20T19:39:20+00:00"`
description 字符串	VPC 的描述。已返回：成功示例： `"my vpc"`
id 字符串	VPC 的 ID。已返回：成功示例： `"cb676a46-66fd-4dfb-b839-443f2e6c0b60"`
ip_block 字符串	VPC 的子网。已返回：成功示例： `"10.99.1.0"`
prefix_length 整数	CIDR 表示法中子网掩码的位数。已返回：成功示例： `24`
region 字符串	VPC 所在的区域。已返回：成功示例： `"ewr"`

作者

René Moser (@resmo)