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 булево	Варианты: нет ← да	Является ли iops предложения диска настраиваемым.
disk_size целое число		Размер предложения диска в ГБ (1 ГБ = 1 073 741 824 байта).
display_offering булево	Варианты: нет да	Необязательное поле, отображать ли предложение пользователю или нет.
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 строка	Варианты: существующий ← отсутствует	Состояние предложения диска.
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
  cs_disk_offering:
    name: small
    display_text: Small 10GB
    disk_size: 10
    storage_type: local
  delegate_to: localhost

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

- name: Remove a disk offering
  cs_disk_offering:
    name: small
    state: absent
  delegate_to: localhost

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

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

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

Статус

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

Авторы

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.9/modules/cs_disk_offering_module.html