cloudscale_ch.cloud.network – Управляет сетями на службе cloudscale.ch IaaS

Примечание

Этот плагин является частью коллекции cloudscale_ch.cloud (версия 2.0.0).

Для его установки используйте: ansible-galaxy collection install cloudscale_ch.cloud.

Для использования в playbook, укажите: cloudscale_ch.cloud.network.

Новое в версии 1.2.0: плагина cloudscale_ch.cloud

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Создание, обновление и удаление сетей.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_timeout целое число	Значение по умолчанию: 30	Таймаут в секундах для вызовов API cloudscale.ch.
api_token строка / обязательно		Токен API cloudscale.ch. Его также можно передать в переменной среды `CLOUDSCALE_API_TOKEN`.
api_url строка добавлен в 1.3.0 версии cloudscale_ch.cloud	Значение по умолчанию: "https://api.cloudscale.ch/v1"	URL API cloudscale.ch. Его также можно передать в переменной среды `CLOUDSCALE_API_URL`.
auto_create_ipv4_subnet логическое значение	Варианты: нет да ←	Автоматически создавать IPv4 подсеть в сети или нет.
mtu целое число	Значение по умолчанию: 9000	MTU сети.
name строка		Имя сети. Требуется либо name, либо uuid.
state строка	Варианты: present ← absent	Состояние сети.
tags словарь		Теги, связанные с сетями. Установите это в `{}`, чтобы очистить все теги.
uuid строка		UUID сети. Требуется либо name, либо uuid.
zone строка		Идентификатор зоны сети (например, `lgp1` или `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 строка		успех	URL API для получения подробностей о данной сети. Пример: https://api.cloudscale.ch/v1/networks/cfde831a-4e87-4a75-960f-89b0148aa2cc
mtu целое число		успех	MTU сети. Пример: 9000
name строка		успех	Имя сети. Пример: моя сеть
state строка		успех	Состояние сети. Пример: present
subnets сложный тип		успех	Список объектов подсетей сети.
	cidr строка	успех	CIDR подсети. Пример: 172.16.0.0/24
	href строка	успех	URL 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cloudscale_ch/cloud/network_module.html