cs_storage_pool - Управляет первичными пулами хранилища на облаках Apache CloudStack.

Новое в версии 2.4.

Описание
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Возвращаемые значения
Примечания
- Статус

Описание

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

Требования (к хосту, на котором выполняется модуль)

python >= 2.6
cs >= 0.6.10

Параметры

параметр	обязательно	значение по умолчанию	варианты	комментарии
allocation_state	нет		enabled disabled	Состояние распределения пула хранилища.
api_http_method	нет	get	get post	Используемый метод HTTP.
api_key	нет			Ключ API CloudStack API.
api_region	нет	cloudstack		Имя раздела ini в файле `cloustack.ini`.
api_secret	нет			Секретный ключ CloudStack API.
api_timeout	нет	10		Таймаут HTTP.
api_url	нет			URL CloudStack API, например, https://cloud.example.com/client/api.
capacity_bytes	нет			Количество байт, которые CloudStack может выделять из этого пула хранилища.
capacity_iops	нет			Количество операций ввода-вывода в секунду (IOPS), которые CloudStack может выделять из этого пула хранилища.
cluster	нет			Имя кластера.
hypervisor	нет		KVM VMware BareMetal XenServer LXC HyperV UCS OVM Simulator	Требуется при создании пула, охватывающего зону.
managed	нет			Управляется ли пул хранилища CloudStack. Учитывается только при создании.
name	да			Имя пула хранилища.
pod	нет			Имя подсети.
provider	нет	DefaultPrimary		Имя поставщика хранилища, например, SolidFire, SolidFireShared, DefaultPrimary, CloudByte.
scope	нет		cluster zone	Область действия пула хранилища. По умолчанию равно cluster, если указано `cluster`, в противном случае zone.
state	нет	present	present absent	Состояние пула хранилища.
storage_tags	нет			Теги, связанные с этим пулом хранилища.
storage_url	нет			URL пула хранилища. Требуется, если `state=present`.
zone	нет			Имя зоны, в которой должен быть развернут хост. Если не задано, используется зона по умолчанию.

Примеры

- name: ensure a zone scoped storage_pool is present
  local_action:
    module: cs_storage_pool
    zone: zone01
    storage_url: rbd://admin:SECRET@ceph-mons.domain/poolname
    provider: DefaultPrimary
    name: Ceph RBD
    scope: zone
    hypervisor: KVM

- name: ensure a cluster scoped storage_pool is disabled
  local_action:
    module: cs_storage_pool
    name: Ceph RBD
    zone: zone01
    cluster: cluster01
    pod: pod01
    storage_url: rbd://admin:SECRET@ceph-the-mons.domain/poolname
    provider: DefaultPrimary
    name: Ceph RBD
    scope: cluster
    allocation_state: disabled

- name: ensure a cluster scoped storage_pool is in maintenance
  local_action:
    module: cs_storage_pool
    name: Ceph RBD
    zone: zone01
    cluster: cluster01
    pod: pod01
    storage_url: rbd://admin:SECRET@ceph-the-mons.domain/poolname
    provider: DefaultPrimary
    name: Ceph RBD
    scope: cluster
    allocation_state: maintenance

- name: ensure a storage_pool is absent
  local_action:
    module: cs_storage_pool
    name: Ceph RBD
    state: absent

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

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

имя	описание	возвращается	тип	пример
allocation_state	Состояние пула хранилища.	при успехе	строка	enabled
capacity_iops	Количество операций ввода-вывода в секунду (IOPS), которые CloudStack может выделять из этого пула хранилища.	если доступно	целое число	60000
cluster	Имя кластера.	если scope = cluster	строка	Cluster01
created	Дата создания пула.	при успехе	строка	2014-12-01T14:57:57+0100
disk_size_allocated	Текущий размер выделенного дискового пространства пула.	при успехе	целое число	2443517624320
disk_size_total	Общий размер пула.	при успехе	целое число	3915055693824
disk_size_used	Текущий размер использованного дискового пространства пула.	при успехе	целое число	1040862622180
hypervisor	Гипервизор, связанный с этим пулом хранилища.	если доступно	строка	KVM
id	UUID пула.	при успехе	строка	a3fca65a-7db1-4891-b97c-48806a978a96
overprovision_factor	Коэффициент перевыделения пула хранилища.	при успехе	строка	2.0
path	Путь пула хранилища, используемый в storage_url.	при успехе	строка	poolname
pod	Имя подсети.	если scope = cluster	строка	Cluster01
scope	Область действия пула хранилища.	при успехе	строка	cluster
state	Состояние пула хранилища, возвращаемое API.	при успехе	строка	Up
storage_capabilities	Возможности пула хранилища.	при успехе	словарь	{'VOLUME_SNAPSHOT_QUIESCEVM': 'false'}
storage_tags	Теги пула хранилища.	при успехе	список	['perf', 'ssd']
suitable_for_migration	Подходит ли пул хранилища для миграции тома.	при успехе	логическое значение	False
zone	Имя зоны.	при успехе	строка	Zone01

Примечания

Примечание

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 можно найти по адресу http://docs.ansible.com/ansible/guide_cloudstack.html
Этот модуль поддерживает режим проверки.

Статус

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

Для помощи в разработке модулей, если у вас есть желание, пожалуйста, прочитайте Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.

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