Модуль cloudscale_ch.cloud.network — Управление сетями на службе IaaS cloudscale.ch

Примечание

Этот модуль входит в коллекцию 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 целое число	Время ожидания в секундах для вызовов API cloudscale.ch. Также может быть передано в переменной среды `CLOUDSCALE_API_TIMEOUT`. По умолчанию: `45`
api_token строка / обязательно	Токен API cloudscale.ch. Также может быть передан в переменной среды `CLOUDSCALE_API_TOKEN`.
api_url строка добавлено в cloudscale_ch.cloud 1.3.0	URL API cloudscale.ch. Также может быть передан в переменной среды `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`).

Примечания

Примечание

Все операции выполняются с использованием публичного API cloudscale.ch 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-адрес для получения подробной информации о данной сети. Возвращается: успех Пример: `"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-адрес для получения подробной информации о подсети. Возвращается: успех Пример: `"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)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cloudscale_ch/cloud/network_module.html