cs_image_store – Управляет хранилищами образов CloudStack

Новая в версии 2.8.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

Развертывание, удаление, повторное создание хранилищ образов CloudStack.

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

python >= 2.6
cs >= 0.6.10

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_http_method строка	Варианты: get post	Метод HTTP, используемый для запроса к API-точке. Если не указано, используется переменная среды `CLOUDSTACK_METHOD`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел Примечания. Значение по умолчанию — `get`, если не указано.
api_key строка		Ключ API для CloudStack API. Если не указано, используется переменная среды `CLOUDSTACK_KEY`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел Примечания.
api_region строка	Значение по умолчанию: "cloudstack"	Имя раздела ini в файле `cloustack.ini`. Если не указано, используется переменная среды `CLOUDSTACK_REGION`.
api_secret строка		Секретный ключ CloudStack API. Если не задано, используется переменная среды `CLOUDSTACK_SECRET`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел Примечания.
api_timeout целое число		Таймаут HTTP в секундах. Если не указано, используется переменная среды `CLOUDSTACK_TIMEOUT`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел Примечания. Значение по умолчанию 10 секунд, если не указано.
api_url строка		URL CloudStack API, например, https://cloud.example.com/client/api. Если не указано, используется переменная среды `CLOUDSTACK_ENDPOINT`. В качестве последнего варианта используется значение из файла конфигурации ini, см. также раздел Примечания.
force_recreate логическое	Варианты: нет ← да	Установите значение `yes`, если вы изменяете существующее хранилище образов. Это принудительно пересоздаст хранилище образов. Пересоздание может завершиться неудачно, если в хранилище образов присутствуют снимки. Удалите их перед выполнением пересоздания.
name строка / обязательно		Идентификатор хранилища образов. Обязательно при удалении хранилища образов.
provider строка		Имя поставщика хранилища образов. Обязательно при создании нового хранилища образов.
state строка	Варианты: present ← absent	Стадия хранилища образов.
url строка		URL хранилища образов. Обязательно, когда state=present.
zone строка / обязательно		Имя зоны для хранилища образов.

Примечания

Примечание

Ansible использует метод конфигурации библиотеки cs, если учетные данные не предоставлены аргументами api_url, api_key, api_secret. Конфигурация считывается из нескольких мест в следующем порядке. CLOUDSTACK_ENDPOINT, CLOUDSTACK_KEY, CLOUDSTACK_SECRET и CLOUDSTACK_METHOD. Переменные среды CLOUDSTACK_TIMEOUT. Переменная среды CLOUDSTACK_CONFIG, указывающая на файл .ini. Файл cloudstack.ini в текущем каталоге. Файл .cloudstack.ini в домашнем каталоге пользователя. Допускается указание нескольких учетных данных и конечных точек с использованием разделов ini в cloudstack.ini. Для выбора имени раздела используется аргумент api_region, по умолчанию это раздел cloudstack. Дополнительная информация доступна по адресу https://github.com/exoscale/cs.
Подробное руководство по модулям cloudstack можно найти в руководстве CloudStack Cloud Guide по адресу ../scenario_guides/guide_cloudstack.
Этот модуль поддерживает режим проверки.

Примеры

- name: Add a Image Store (NFS)
  cs_image_store:
    zone: zone-01
    name: nfs-01
    provider: NFS
    url: nfs://192.168.21.16/exports/secondary
  delegate_to: localhost

# Change the NFS share URL and force a Image Store recreation
- name: Change the NFS url
  cs_image_store:
    zone: zone-01
    name: nfs-01
    provider: NFS
    force_recreate: yes
    url: nfs://192.168.21.10/shares/secondary
  delegate_to: localhost

- name: delete the image store
  cs_image_store:
    name: nfs-01
    zone: zone-01
    state: absent
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
id строка	успех	Идентификатор хранилища образов Пример: feb11a84-a093-45eb-b84d-7f680313c40b
name строка	успех	Имя хранилища образов Пример: nfs-01
protocol строка	успех	Протокол хранилища образов Пример: nfs
provider_name строка	успех	Имя поставщика хранилища образов Пример: NFS
scope строка	успех	Область действия хранилища образов Пример: ZONE
url строка	успех	URL хранилища образов Пример: nfs://192.168.21.16/exports/secondary
zone строка	успех	Имя зоны хранилища образов Пример: zone-01

Статус

Гарантии обратной совместимости интерфейса этого модуля нет. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Патрик Цихи (@PatTheSilent)

Подсказка

Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/cs_image_store_module.html