hetzner.hcloud.server_network 模块 – 管理 Hetzner Cloud 网络和服务器之间的关系

注意

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

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

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

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

概要 

创建和删除 Hetzner Cloud 网络和服务器之间的关系

别名：hcloud_server_network

要求 

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

python-dateutil >= 2.7.5
requests >=2.20

参数 

参数	注释
alias_ips 列表 / 元素=字符串	服务器拥有的别名 IP。
api_endpoint 别名：endpoint 字符串	Hetzner Cloud 的 API 端点。您还可以使用 `HCLOUD_ENDPOINT` 环境变量设置此选项。默认值： `"https://api.hetzner.cloud/v1"`
api_token 字符串 / 必填	Hetzner Cloud 的 API 令牌。您还可以使用 `HCLOUD_TOKEN` 环境变量设置此选项。
ip 字符串	服务器应具有的 IP。
network 字符串 / 必填	Hetzner Cloud 网络的名称或 ID。
server 字符串 / 必填	Hetzner Cloud 服务器的名称或 ID。
state 字符串	server_network 的状态。选项 `"absent"` `"present"` ← (默认)

另请参阅 

另请参阅

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

示例 

- name: Create a basic server network
  hetzner.hcloud.server_network:
    network: my-network
    server: my-server
    state: present

- name: Create a server network and specify the ip address
  hetzner.hcloud.server_network:
    network: my-network
    server: my-server
    ip: 10.0.0.1
    state: present

- name: Create a server network and add alias ips
  hetzner.hcloud.server_network:
    network: my-network
    server: my-server
    ip: 10.0.0.1
    alias_ips:
      - 10.1.0.1
      - 10.2.0.1
    state: present

- name: Ensure the server network is absent (remove if needed)
  hetzner.hcloud.server_network:
    network: my-network
    server: my-server
    state: absent

返回值 

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

键	描述
hcloud_server_network 复杂	服务器和网络之间的关系返回：总是
alias_ips 列表 / 元素=字符串	服务器在网络 IP 范围内的别名 IP 返回：总是示例： `["10.1.0.1", "..."]`
ip 字符串	服务器在网络 IP 范围内的 IP 返回：总是示例： `"10.0.0.8"`
network 字符串	网络名称返回：总是示例： `"my-network"`
server 字符串	服务器名称返回：总是示例： `"my-server"`

作者

Lukas Kaemmerling (@lkaemmerling)