Модуль vultr.cloud.object_storage — управление объектными хранилищами в Vultr

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install vultr.cloud.

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

Добавлено в vultr.cloud 1.12.0

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

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

Управление объектными хранилищами.

Параметры

Параметр	Комментарии
api_endpoint строка	URL конечной точки API (без завершающей косой черты). Резервная переменная окружения `VULTR_API_ENDPOINT`. По умолчанию: `"https://api.vultr.com/v2"`
api_key строка / обязательный	Ключ API Vultr. Резервная переменная окружения `VULTR_API_KEY`.
api_results_per_page целое число добавлено в vultr.cloud 1.14.0	При получении большого количества ресурсов укажите, сколько результатов должно возвращаться за один вызов API. Этот параметр не определяет общее количество возвращаемых результатов; все ресурсы возвращаются с учётом других фильтров. Максимальное значение для API Vultr — 500. Резервная переменная окружения `VULTR_API_RESULTS_PER_PAGE`. По умолчанию: `100`
api_retries целое число	Количество повторных попыток в случае, если API Vultr возвращает код ошибки HTTP, например: - 429 Too Many Requests - 500 Internal Server Error - 504 Gateway Time-out Резервная переменная окружения `VULTR_API_RETRIES`. По умолчанию: `5`
api_retry_max_delay целое число	Задержка между повторными попытками увеличивается экспоненциально до указанного максимального значения в секундах. Резервная переменная окружения `VULTR_API_RETRY_MAX_DELAY`. По умолчанию: `12`
api_timeout целое число	Тайм-аут HTTP-запросов к API Vultr. Резервная переменная окружения `VULTR_API_TIMEOUT`. По умолчанию: `180`
cluster строка / обязательный	Имя хоста кластера, в котором будет создано объектное хранилище.
label псевдонимы: name строка / обязательный	Имя объектного хранилища.
state строка	Состояние объектного хранилища. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
tier строка	Название уровня хранилища, используемого для объектного хранилища. Должно быть доступно для указанного кластера. Обязательно, если задан параметр state. По умолчанию: `"Legacy"`
validate_certs логическое значение	Проверять SSL-сертификаты API Vultr. Допустимые значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

---
- name: Ensure an object storage is present
  vultr.cloud.object_storage:
    label: my object storage
    cluster: ewr1.vultrobjects.com
    tier: standard

- name: Ensure an object storage is absent
  vultr.cloud.object_storage:
    label: my object storage
    cluster: ewr1.vultrobjects.com
    state: absent

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

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

Ключ	Описание
vultr_api словарь	Ответ API Vultr с несколькими дополнениями и изменениями. Возвращается: success
api_account строка	Учётная запись, использованная в ini-файле для выбора ключа. Возвращается: success Пример: `"default"`
api_endpoint строка	Конечная точка, используемая для запросов API. Возвращается: success Пример: `"https://api.vultr.com/v2"`
api_results_per_page целое число	Количество результатов, возвращаемых за один вызов API. Возвращается: success Пример: `100`
api_retries целое число	Максимальное количество повторных попыток для запросов API. Возвращается: success Пример: `5`
api_retry_max_delay целое число	Максимальная задержка в секундах при экспоненциальном увеличении интервала между повторными попытками. Возвращается: success Пример: `12`
api_timeout целое число	Тайм-аут, используемый для запросов API. Возвращается: success Пример: `60`
vultr_block_storage словарь	Ответ API Vultr. Возвращается: success
date_created строка	Дата создания объектного хранилища. Возвращается: success Пример: `"2020-10-10T01:56:20+00:00"`
id строка	Уникальный идентификатор объектного хранилища. Возвращается: success Пример: `"cb676a46-66fd-4dfb-b839-443f2e6c0b60"`
label строка	Метка этого объектного хранилища, заданная пользователем. Возвращается: success Пример: `"my object storage"`
region строка	Регион этого объектного хранилища. Возвращается: success Пример: `"ewr"`
s3_access_key строка	Ключ доступа к объектному хранилищу. Возвращается: success Пример: `"00example11223344"`
s3_hostname строка	Имя хоста кластера для этого объектного хранилища. Возвращается: success Пример: `"ewr1.vultrobjects.com"`
s3_secret_key строка	Секретный ключ объектного хранилища. Возвращается: success Пример: `"00example1122334455667788990011"`
status строка	Состояние этого объектного хранилища. Возвращается: success Пример: `"active"`

Авторы

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