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

Примечание

Этот модуль входит в коллекцию cloudscale_ch.cloud (версия 2.5.3).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

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

Новое в cloudscale_ch.cloud 1.3.0

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

Обзор

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

Параметры

Параметр	Комментарии
api_timeout integer	Тайм-аут в секундах для вызовов API cloudscale.ch. Это значение также можно передать в переменной среды `CLOUDSCALE_API_TIMEOUT`. По умолчанию: `45`
api_token string / обязательный	Токен API cloudscale.ch. Это значение также можно передать в переменной среды `CLOUDSCALE_API_TOKEN`.
api_url string добавлено в cloudscale_ch.cloud 1.3.0	URL API cloudscale.ch. Это значение также можно передать в переменной среды `CLOUDSCALE_API_URL`. По умолчанию: `"https://api.cloudscale.ch/v1"`
cidr string	CIDR подсети. Обязателен, если state=present.
dns_servers list / элементы типа string	Список IP-адресов DNS-резолверов, выступающих в качестве DNS-серверов. Если значение не задано, используются DNS-резолверы cloudscale.ch по умолчанию.
gateway_address string	Адрес шлюза подсети. Если значение не задано, шлюз не используется. Адрес не может входить в диапазон DHCP, который включает младшие адреса .101–.254 подсети.
network dictionary	Имя сети, к которой относится подсеть. Обязателен, если state=present.
name string	UUID сети.
uuid string	UUID сети.
zone string	Зона, в которой размещена сеть.
reset boolean	Сбрасывает gateway_address и dns_servers до значений API по умолчанию. Примечание: идемпотентность не гарантируется. Варианты: `false` ← (по умолчанию) `true`
state string	Состояние подсети. Варианты: `"present"` ← (по умолчанию) `"absent"`
tags dictionary	Теги, связанные с подсетью. Укажите `{}`, чтобы удалить все теги.
uuid string	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 string	CIDR подсети. Возвращается: при успехе Пример: `"172.16.0.0/24"`
dns_servers list / элементы типа string	Список IP-адресов DNS-резолверов. Возвращается: при успехе Пример: `["9.9.9.9", "149.112.112.112"]`
gateway_address string	Адрес шлюза подсети. Возвращается: при успехе Пример: `"192.168.42.1"`
href string	URL API для получения сведений о подсети. Возвращается: при успехе Пример: `"https://api.cloudscale.ch/v1/subnets/33333333-1864-4608-853a-0771b6885a3"`
network complex	Объект сети подсети. Возвращается: при успехе
href string	URL API для получения сведений о сети. Возвращается: при успехе Пример: `"https://api.cloudscale.ch/v1/networks/33333333-1864-4608-853a-0771b6885a3"`
name string	Имя сети. Возвращается: при успехе Пример: `"my network"`
uuid string	Уникальный идентификатор сети. Возвращается: при успехе Пример: `"33333333-1864-4608-853a-0771b6885a3"`
zone dictionary добавлено в cloudscale_ch.cloud 1.4.0	Зона, в которой размещена сеть. Возвращается: при успехе Пример: `{"slug": "rma1"}`
state string	Состояние подсети. Возвращается: при успехе Пример: `"present"`
tags dictionary	Теги, связанные с подсетью. Возвращается: при успехе Пример: `{"project": "my project"}`
uuid string	Уникальный идентификатор подсети. Возвращается: при успехе Пример: `"33333333-1864-4608-853a-0771b6885a3"`

Авторы

René Moser (@resmo)

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

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