Модуль vultr.cloud.vpc – Управление VPC на Vultr

Примечание

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

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

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

Для использования в книге задач укажите: vultr.cloud.vpc.

Новое в vultr.cloud 1.0.0

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

Обзор

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

Параметры

Параметр	Комментарии
api_endpoint строка	URL конечной точки API (без конечного слэша). Дополнительная переменная окружения `VULTR_API_ENDPOINT`. По умолчанию: `"https://api.vultr.com/v2"`
api_key строка / обязательный	Ключ API для Vultr API. Дополнительная переменная окружения `VULTR_API_KEY`.
api_retries целое число	Количество попыток повторной отправки запроса в случае, если Vultr API возвращает код HTTP ошибки, такой как - 429 Слишком много запросов - 500 Внутренняя ошибка сервера - 504 Ошибка таймаута шлюза Дополнительная переменная окружения `VULTR_API_RETRIES`. По умолчанию: `5`
api_retry_max_delay целое число	Задержка отката при повторных попытках в секундах, экспоненциально возрастающая до этого максимального значения. Дополнительная переменная окружения `VULTR_API_RETRY_MAX_DELAY`. По умолчанию: `12`
api_timeout целое число	Таймаут HTTP-соединения с Vultr API. Дополнительная переменная окружения `VULTR_API_TIMEOUT`. По умолчанию: `180`
описание псевдонимы: имя строка / обязательный	Описание VPC.
регион строка	Регион, к которому будет относиться VPC. Обязательно, если state=present.
состояние строка	Состояние VPC. Выбор: `"present"` ← (по умолчанию) `"absent"`
v4_subnet строка	IPv4 подсеть VPC. Обязательно, если state=present.
v4_subnet_mask целое число	IPv4 маска подсети VPC. Обязательно, если state=present.
validate_certs логический	Проверка SSL-сертификатов Vultr API. Выбор: `false` `true` ← (по умолчанию)

Примечания

Примечание

Также обратитесь к документации API по адресу https://www.vultr.com/api/.

Примеры

- name: Ensure a VPC is present
  vultr.cloud.vpc:
    description: my VPC.
    subnet: 10.99.1.0
    subnet_mask: 24
    region: ewr

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

END_OF_DOCUMENT_MARKER

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

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

Ключ	Описание
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_vpc словарь	Ответ от API Vultr. Возвращено: успешно
date_created строка	Дата создания VPC. Возвращено: успешно Пример: `"2020-10-10T01:56:20+00:00"`
date_modified строка	Дата изменения VPC. Возвращено: успешно Пример: `"2020-10-10T01:56:20+00:00"`
description строка	Описание VPC. Возвращено: успешно Пример: `"my vpc"`
id строка	Идентификатор VPC. Возвращено: успешно Пример: `"cb676a46-66fd-4dfb-b839-443f2e6c0b60"`
v4_subnet строка	Подсеть VPC. Возвращено: успешно Пример: `"10.99.1.0"`
v4_subnet_maks строка	Маска подсети VPC. Возвращено: успешно Пример: `"10.99.1.0"`

Авторы

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