Модуль vultr.cloud.vpc2 — управление VPC 2.0 на Vultr

Примечание

Этот модуль является частью коллекции vultr.cloud (версия 1.13.0).

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

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

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

Новое в vultr.cloud 1.9.0

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

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

Создание и удаление VPC 2.0.

Параметры

Параметр	Комментарии
api_endpoint string	URL конечной точки API (без конечного слеша). Резервная переменная окружения `VULTR_API_ENDPOINT`. По умолчанию: `"https://api.vultr.com/v2"`
api_key string / required	API ключ Vultr API. Резервная переменная окружения `VULTR_API_KEY`.
api_retries integer	Количество попыток в случае, если Vultr API возвращает код HTTP ошибки, например - 429 Too Many Requests - 500 Internal Server Error - 504 Gateway Time-out Резервная переменная окружения `VULTR_API_RETRIES`. По умолчанию: `5`
api_retry_max_delay integer	Задержка повторной попытки в секундах, экспоненциально увеличивается до этого максимального значения, в секундах. Резервная переменная окружения `VULTR_API_RETRY_MAX_DELAY`. По умолчанию: `12`
api_timeout integer	Таймаут HTTP для Vultr API. Резервная переменная окружения `VULTR_API_TIMEOUT`. По умолчанию: `180`
description aliases: name string / required	Описание VPC.
ip_block string	Подсеть VPC. Обязательно, если state=present.
ip_type string	Тип версии IP. Обязательно, если state=present. Варианты: `"v4"` ← (по умолчанию)
prefix_length integer	Количество битов для маски сети в нотации CIDR, например 24. Обязательно, если state=present.
region string	Регион, к которому будет относиться VPC. Обязательно, если state=present.
state string	Состояние VPC. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs boolean	Проверять SSL сертификаты Vultr API. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

См. также документацию по API на https://www.vultr.com/api/.

Примеры

- name: Ensure a VPC is present
  vultr.cloud.vpc2:
    description: my VPC.
    ip_block: 10.99.1.0
    prefix_length: 24
    region: ewr

- name: Ensure a VPC is absent
  vultr.cloud.vpc2:
    description: my VPC.
    state: absent

Значения возврата

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

Ключ	Описание
vultr_api словарь	Ответ от API Vultr с некоторыми дополнениями/изменениями. Возвращено: успех
api_endpoint строка	Точка входа, используемая для запросов API. Возвращено: успех Пример: `"https://api.vultr.com/v2"`
api_retries целое число	Количество максимальных попыток повторного запроса API. Возвращено: успех Пример: `5`
api_retry_max_delay целое число	Задержка экспоненциальной задержки в секундах между повторными попытками до этого максимального значения задержки. Возвращено: успех Пример: `12`
api_timeout целое число	Таймаут, используемый для запросов API. Возвращено: успех Пример: `60`
vultr_vpc2 словарь	Ответ от API Vultr. Возвращено: успех
date_created строка	Дата создания VPC. Возвращено: успех Пример: `"2023-08-20T19:39:20+00:00"`
description строка	Описание VPC. Возвращено: успех Пример: `"my vpc"`
id строка	Идентификатор VPC. Возвращено: успех Пример: `"cb676a46-66fd-4dfb-b839-443f2e6c0b60"`
ip_block строка	Подсеть VPC. Возвращено: успех Пример: `"10.99.1.0"`
prefix_length целое число	Количество битов для маски сети в CIDR-нотации. Возвращено: успех Пример: `24`
region строка	Регион расположения VPC. Возвращено: успех Пример: `"ewr"`

Авторы

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/vultr/cloud/vpc2_module.html