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

Примечание

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

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

Чтобы использовать его в плейбуке, укажите: cloudscale_ch.cloud.subnet.

Новое в версии 1.3.0: of 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`.
cidr строка			CIDR подсети. Требуется, если state=present.
dns_servers список / элементы=строка			Список IP-адресов DNS-серверов. Если не задано, используются стандартные DNS-серверы cloudscale.ch.
gateway_address строка			IP-адрес шлюза подсети. Если не задано, шлюз не используется. Не может находиться в диапазоне DHCP, который находится в диапазоне .101-.254 подсети.
network словарь			Имя сети, к которой относится подсеть. Требуется, если state=present.
	name строка		UUID сети.
	uuid строка		UUID сети.
	zone строка		Зона, в которой размещена сеть.
reset логическое значение		Варианты: no ← yes	Сбрасывает значения gateway_address и dns_servers до значений по умолчанию API. Примечание: идемпотентность не гарантируется.
state строка		Варианты: present ← absent	Состояние подсети.
tags словарь			Теги, связанные с подсетью. Установите значение в `{}` для очистки всех тегов.
uuid строка			UUID подсети.

Примечания

Примечание

Все операции выполняются с использованием публичного API cloudscale.ch v1.
Подробная информация доступна в полной документации API: https://www.cloudscale.ch/en/api/v1.
Для всех операций требуется действительный токен API. Вы можете создать сколько угодно токенов, используя панель управления cloudscale.ch по адресу https://control.cloudscale.ch.

Примеры

---
- name: Ensure subnet exists
  cloudscale_ch.cloud.subnet:
    cidr: 172.16.0.0/24
    network:
      uuid: 2db69ba3-1864-4608-853a-0771b6885a3a
    api_token: xxxxxx

- name: Ensure subnet exists
  cloudscale_ch.cloud.subnet:
    cidr: 192.168.1.0/24
    gateway_address: 192.168.1.1
    dns_servers:
      - 192.168.1.10
      - 192.168.1.11
    network:
      name: private
      zone: lpg1
    api_token: xxxxxx

- name: Ensure a subnet is absent
  cloudscale_ch.cloud.subnet:
    cidr: 172.16.0.0/24
    network:
      name: private
      zone: lpg1
    state: absent
    api_token: xxxxxx

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ		Возвращаемое значение	Описание
cidr строка		success	CIDR подсети. Пример: 172.16.0.0/24
dns_servers список / элементы=строка		success	Список IP-адресов DNS-серверов. Пример: ['9.9.9.9', '149.112.112.112']
gateway_address строка		success	IP-адрес шлюза подсети. Пример: 192.168.42.1
href строка		success	URL API для получения подробной информации о подсети. Пример: https://api.cloudscale.ch/v1/subnets/33333333-1864-4608-853a-0771b6885a3
network сложный тип		success	Объект сети подсети.
	href строка	success	URL API для получения подробной информации о сети. Пример: https://api.cloudscale.ch/v1/networks/33333333-1864-4608-853a-0771b6885a3
	name строка	success	Название сети. Пример: моя сеть
	uuid строка	success	Уникальный идентификатор сети. Пример: 33333333-1864-4608-853a-0771b6885a3
	zone словарь добавлено в 1.4.0 cloudscale_ch.cloud	success	Зона, в которой размещена сеть. Пример: {'slug': 'rma1'}
state строка		success	Состояние подсети. Пример: present
tags словарь		success	Теги, связанные с подсетью. Пример: {'project': 'мой проект'}
uuid строка		success	Уникальный идентификатор подсети. Пример: 33333333-1864-4608-853a-0771b6885a3

Авторы

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/subnet_module.html