cs_disk_offering – Управляет предложениями дисков в облаках на основе Apache CloudStack.

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

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

Обзор

Создание и удаление предложений дисков для гостевых виртуальных машин.
Обновление display_text или display_offering существующего предложения диска.

Требования

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

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, см. также примечания.
bytes_read_rate -		Скорость чтения байтов предложения диска.
bytes_write_rate -		Скорость записи байтов предложения диска.
customized boolean	Варианты: нет ← да	Указывается, является ли iops предложения диска пользовательским или нет.
disk_size -		Размер предложения диска в ГБ (1 ГБ = 1 073 741 824 байт).
display_offering boolean	Варианты: нет да	Необязательное поле, указывает, отображать ли предложение пользователю.
display_text -		Текст для отображения предложения диска. Если не задано, будет использовано `name`, как `display_text`, при создании.
domain -		Домен, к которому относится предложение диска. Общедоступно для всех доменов и поддоменов, если не указано.
hypervisor_snapshot_reserve -		Зарезервированное пространство для моментальных снимков гипервизора в процентах от объема. Только для управляемого хранилища с Xen или VMware.
iops_max -		Максимальное значение iops для предложения диска.
iops_min -		Минимальное значение iops для предложения диска.
iops_read_rate -		Скорость чтения операций ввода-вывода предложения диска.
iops_write_rate -		Скорость записи операций ввода-вывода предложения диска.
name - / обязательно		Имя предложения диска.
provisioning_type -	Варианты: thin sparse fat	Тип разбиения, используемый при создании томов.
state -	Варианты: present ← absent	Состояние предложения диска.
storage_tags -		Теги хранилища для данного предложения диска. псевдонимы: storage_tag
storage_type -	Варианты: local shared	Тип хранилища предложения диска.

Примечания

Примечание

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.
Этот модуль поддерживает режим проверки.

Примеры

- name: Create a disk offering with local storage
  local_action:
    module: cs_disk_offering
    name: small
    display_text: Small 10GB
    disk_size: 10
    storage_type: local

- name: Create or update a disk offering with shared storage
  local_action:
    module: cs_disk_offering
    name: small
    display_text: Small 10GB
    disk_size: 10
    storage_type: shared
    storage_tags: SAN01

- name: Remove a disk offering
  local_action:
    module: cs_disk_offering
    name: small
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
bytes_read_rate целое число	успех	Скорость чтения байтов предложения диска Пример: 1000
bytes_write_rate целое число	успех	Скорость записи байтов предложения диска Пример: 1000
created строка	успех	Дата создания предложения Пример: 2017-11-19T10:48:59+0000
customized логическое значение	успех	Используются ли для предложения настраиваемые значения IOPS
disk_size целое число	успех	Размер предложения диска в ГБ Пример: 10
display_offering логическое значение	успех	Отображается ли предложение конечному пользователю?
display_text строка	успех	Текст отображения предложения Пример: Small 10GB
domain строка	успех	Домен, в который входит предложение Пример: ROOT
id строка	успех	UUID предложения диска Пример: a6f7a5fc-43f8-11e5-a151-feff819cdc9f
iops_max целое число	успех	Максимальное значение IOPS для предложения диска Пример: 1000
iops_min целое число	успех	Минимальное значение IOPS для предложения диска Пример: 500
iops_read_rate целое число	успех	Скорость чтения запросов ввода-вывода в секунду для предложения диска Пример: 1000
iops_write_rate целое число	успех	Скорость записи запросов ввода-вывода в секунду для предложения диска Пример: 1000
name строка	успех	Название предлагаемой системы Пример: Micro
provisioning_type строка	успех	Тип резервирования, используемый для создания томов Пример: thin
storage_tags список	успех	Список тегов хранилища Пример: ['eco']
storage_type строка	успех	Тип хранилища, используемый для создания томов Пример: shared

Статус

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

Авторы

David Passante (@dpassante)
René Moser(@resmo)

Подсказка

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

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