Spec-Zone.ru › Ansible

Модуль community.digitalocean.digital_ocean_vpc – Создание и удаление DigitalOcean VPC

Примечание

Этот модуль является частью коллекции community.digitalocean (версия 1.27.0).

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

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

Для использования в playbook, укажите: community.digitalocean.digital_ocean_vpc.

Новое в community.digitalocean 1.7.0

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

Краткое описание

  • Этот модуль может использоваться для создания и удаления DigitalOcean VPC.

Параметры

Параметр

Комментарии

baseurl

string

Базовый URL API DigitalOcean.

По умолчанию: "https://api.digitalocean.com/v2"

default

boolean

Логическое значение, указывающее, является ли VPC сетью по умолчанию для региона.

Все применимые ресурсы размещаются в сети VPC по умолчанию, если не указано иное при их создании.

Поле default не может быть сброшено с true.

Если вы хотите установить новую сеть VPC по умолчанию, обновите поле default другой сети VPC в том же регионе.

Поле default предыдущей сети будет установлено в false, когда будет определена новая VPC по умолчанию.

Варианты:

  • false ← (по умолчанию)
  • true

description

string

Поле свободного текста для описания цели VPC.

Может содержать максимум 255 символов.

ip_range

string

Запрашиваемый диапазон IP-адресов для VPC в нотации CIDR.

Диапазоны сетей не могут перекрываться с другими сетями в одной учетной записи и должны находиться в диапазоне частных адресов, как определено в RFC1918.

Он не может быть меньше /24 и больше /16.

Если диапазон IP не указан, генерируется диапазон сети /20, который не будет конфликтовать с другими сетями VPC в вашей учетной записи.

name

string / required

Имя VPC.

Должно быть уникальным и содержать только буквенно-цифровые символы, тире и точки.

oauth_token

aliases: api_token

string

Токен OAuth DigitalOcean.

Существует несколько других переменных среды, которые могут использоваться для предоставления этого значения.

Например, - DO_API_TOKEN, DO_API_KEY, DO_OAUTH_TOKEN и OAUTH_TOKEN.

region

string

Идентификатор в виде служебного слова для региона, где будет создана VPC.

state

string

Должна ли VPC существовать (быть создана) или отсутствовать (быть удалена).

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

timeout

integer

Таймаут в секундах, используемый для опроса API DigitalOcean.

По умолчанию: 30

validate_certs

boolean

Если установлено в no, SSL-сертификаты проверяться не будут.

Это следует устанавливать в no только на лично контролируемых сайтах, использующих самоподписанные сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

Примеры

- name: Create a VPC
  community.digitalocean.digital_ocean_vpc:
    state: present
    name: myvpc1
    region: nyc1

- name: Create a VPC (choose IP range)
  community.digitalocean.digital_ocean_vpc:
    state: present
    name: myvpc1
    region: nyc1
    ip_range: 192.168.192.0/24

- name: Update a VPC (make it default)
  community.digitalocean.digital_ocean_vpc:
    state: present
    name: myvpc1
    region: nyc1
    default: true

- name: Update a VPC (change description)
  community.digitalocean.digital_ocean_vpc:
    state: present
    name: myvpc1
    region: nyc1
    description: myvpc

- name: Delete a VPC
  community.digitalocean.digital_ocean_vpc:
    state: absent
    name: myvpc1

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

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

Ключ

Описание

data

dictionary

DigitalOcean VPC.

Возвращается: успех

Пример: {"msg": "Created VPC myvpc1 in nyc1", "vpc": {"created_at": "2021-06-17T11:43:12.12121565Z", "default": false, "description": "", "id": "a3b72d97-192f-4984-9d71-08a5faf2e0c7", "ip_range": "10.116.16.0/20", "name": "testvpc1", "region": "nyc1", "urn": "do:vpc:a3b72d97-192f-4984-9d71-08a5faf2e0c7"}}

Авторы

  • Mark Mercado (@mamercad)

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

  • Система отслеживания ошибок
  • Репозиторий (исходный код)

© 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/community/digitalocean/digital_ocean_vpc_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API