hetzner.hcloud.subnetwork 模块 – 管理 Hetzner Cloud 上的云子网。

注意

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

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

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

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

概要 

在 Hetzner Cloud 上创建、更新和删除云子网。

别名: hcloud_subnetwork

要求 

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

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` 环境变量来设置此选项。
ip_range 字符串 / 必填	子网的 IP 范围。
network 字符串 / 必填	Hetzner Cloud 网络的名称或 ID。
network_zone 字符串 / 必填	网络区域的名称。
state 字符串	子网的状态。选择 `"absent"` `"present"` ← (默认)
type 字符串 / 必填	子网的类型。选择 `"server"` `"cloud"` `"vswitch"`
vswitch_id 整数	您要与网络耦合的 vSwitch 的 ID。如果 type == vswitch 则为必填项

另请参阅 

另请参阅

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

示例 

- name: Create a basic subnetwork
  hetzner.hcloud.subnetwork:
    network: my-network
    ip_range: 10.0.0.0/16
    network_zone: eu-central
    type: cloud
    state: present

- name: Create a basic subnetwork
  hetzner.hcloud.subnetwork:
    network: my-vswitch-network
    ip_range: 10.0.0.0/24
    network_zone: eu-central
    type: vswitch
    vswitch_id: 123
    state: present

- name: Ensure the subnetwork is absent (remove if needed)
  hetzner.hcloud.subnetwork:
    network: my-network
    ip_range: 10.0.0.0/8
    network_zone: eu-central
    type: cloud
    state: absent

返回值 

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

键	描述
hcloud_subnetwork 复杂	网络的子网返回：总是
gateway 字符串	子网的网关返回：总是示例： `"10.0.0.1"`
ip_range 字符串	网络的 IP 范围返回：总是示例： `"10.0.0.0/8"`
network 字符串	网络的名称返回：总是示例： `"my-network"`
network_zone 字符串	网络区域的名称返回：总是示例： `"eu-central"`
type 字符串	子网的类型返回：总是示例： `"server"`
vswitch_id 整数	vswitch 的 ID，如果不是 vswitch 类型，则为 null 返回：总是示例： `123`

作者

Lukas Kaemmerling (@lkaemmerling)