cloudscale_ch.cloud.network 模块 – 管理 cloudscale.ch IaaS 服务上的网络

注意

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

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

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

要在 playbook 中使用它，请指定： cloudscale_ch.cloud.network。

cloudscale_ch.cloud 1.2.0 中的新增功能

概要 

创建、更新和删除网络。

参数 

参数	注释
api_timeout 整数	调用 cloudscale.ch API 的超时时间（以秒为单位）。也可以在 `CLOUDSCALE_API_TIMEOUT` 环境变量中传递此值。默认值： `45`
api_token 字符串 / 必需	cloudscale.ch API 令牌。也可以在 `CLOUDSCALE_API_TOKEN` 环境变量中传递此值。
api_url 字符串在 cloudscale_ch.cloud 1.3.0 中添加	cloudscale.ch API URL。也可以在 `CLOUDSCALE_API_URL` 环境变量中传递此值。默认值： `"https://api.cloudscale.ch/v1"`
auto_create_ipv4_subnet 布尔值	是否在网络中自动创建 IPv4 子网。选择 `false` `true` ← (默认)
mtu 整数	网络的 MTU。默认值： `9000`
name 字符串	网络的名称。需要 name 或 uuid。
state 字符串	网络的状态。选择 `"present"` ← (默认) `"absent"`
tags 字典	与网络关联的标签。将其设置为 `{}` 以清除任何标签。
uuid 字符串	网络的 UUID。需要 name 或 uuid。
zone 字符串	网络的区域 slug（例如， `lpg1` 或 `rma1`）。

说明 

注意

所有操作都使用 cloudscale.ch 公共 API v1 执行。
有关详细信息，请查阅完整的 API 文档： https://www.cloudscale.ch/en/api/v1。
所有操作都需要有效的 API 令牌。您可以使用 cloudscale.ch 控制面板在 https://control.cloudscale.ch 创建任意数量的令牌。

示例 

---
- name: Ensure network exists
  cloudscale_ch.cloud.network:
    name: my network
    api_token: xxxxxx

- name: Ensure network in a specific zone
  cloudscale_ch.cloud.network:
    name: my network
    zone: lpg1
    api_token: xxxxxx

- name: Ensure a network is absent
  cloudscale_ch.cloud.network:
    name: my network
    state: absent
    api_token: xxxxxx

返回值 

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

键	描述
created_at 字符串	网络的创建日期和时间。返回值：成功示例： `"2019-05-29T13:18:42.511407Z"`
href 字符串	用于获取有关此网络的详细信息的 API URL。返回值：成功示例： `"https://api.cloudscale.ch/v1/networks/cfde831a-4e87-4a75-960f-89b0148aa2cc"`
mtu 整数	网络的 MTU。返回值：成功示例： `9000`
name 字符串	网络的名称。返回值：成功示例： `"my network"`
state 字符串	网络的状态。返回值：成功示例： `"present"`
subnets 复杂类型	网络子网对象的列表。返回值：成功
cidr 字符串	子网的 CIDR。返回值：成功示例： `"172.16.0.0/24"`
href 字符串	用于获取有关子网详细信息的 API URL。返回值：成功示例： `"https://api.cloudscale.ch/v1/subnets/33333333-1864-4608-853a-0771b6885a3"`
uuid 字符串	子网的唯一标识符。返回值：成功示例： `"33333333-1864-4608-853a-0771b6885a3"`
tags 字典	与网络关联的标签。返回值：成功示例： `{"project": "my project"}`
uuid 字符串	网络的唯一标识符。返回值：成功示例： `"cfde831a-4e87-4a75-960f-89b0148aa2cc"`
zone 字典	网络的区域。返回值：成功示例： `{"slug": "rma1"}`

作者

René Moser (@resmo)