community.general.hwc_evs_disk – Создаёт ресурс Evs/Диск в Huawei Cloud

Примечание

Этот плагин входит в состав коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в плейбуке укажите: community.general.hwc_evs_disk.

Новое в версии 0.2.0: коллекции community.general

Описание
Требования
Параметры
Примечания
Примеры
Значения возврата

Описание

управление хранилищем блочного типа.

Требования

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

keystoneauth1 >= 3.6.0

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
availability_zone строка / обязательно			Указывает зону доступности (AZ), где нужно создать диск.
backup_id строка			Указывает идентификатор резервной копии, который можно использовать для создания диска. Этот параметр обязателен, когда вы используете резервную копию для создания диска.
description строка			Указывает описание диска. Значение может содержать не более 255 байт.
domain строка / обязательно			Имя домена для области действия (Identity v3). (в настоящее время поддерживаются только имена доменов, а не идентификаторы доменов).
enable_full_clone логическое		Варианты: no yes	Если диск создаётся из моментального снимка и необходимо использовать клонирование, установите этот параметр в True.
enable_scsi логическое		Варианты: no yes	Если этот параметр установлен в True, тип устройства диска будет SCSI, что позволяет операционным системам ECS напрямую получать доступ к базовому хранилищу. Поддерживаются команды резервирования SCSI. Если этот параметр установлен в False, тип устройства диска будет VBD, который поддерживает только простые команды чтения/записи SCSI. Если параметр enable_share установлен в True, а этот параметр не указан, создаются общие диски SCSI. Диски SCSI EVS не могут быть созданы из резервных копий, что означает, что этот параметр не может быть True, если backup_id был указан.
enable_share логическое		Варианты: no yes	Указывает, является ли диск общим. Значение по умолчанию — False.
encryption_id строка			Указывает идентификатор шифрования. Длина фиксирована в 36 байтах.
enterprise_project_id строка			Указывает идентификатор корпоративного проекта. Этот идентификатор связывается с диском при создании диска. Если он не указан, диск привязывается к корпоративному проекту по умолчанию.
id строка			Идентификатор управляемого ресурса.
identity_endpoint строка / обязательно			URL аутентификации Identity.
image_id строка			Указывает идентификатор образа. Если этот параметр указан, диск создаётся из образа. Диски BMS не могут быть созданы из образов BMS.
name строка / обязательно			Указывает имя диска. Значение может содержать не более 255 байт.
password строка / обязательно			Пароль для входа.
project строка / обязательно			Имя арендатора (Identity v2) или проекта (Identity v3). (в настоящее время поддерживаются только имена проектов, а не идентификаторы проектов).
region строка			Регион, к которому принадлежит проект.
size целое число			Указывает размер диска в ГБ. Допустимые значения: системный диск — от 1 до 1024 ГБ, диск данных — от 10 до 32768 ГБ. Этот параметр обязателен при создании пустого диска или использовании образа или моментального снимка для создания диска. Если вы используете образ или моментальный снимок для создания диска, размер диска должен быть не меньше размера образа или моментального снимка. Этот параметр необязателен при использовании резервной копии для создания диска. Если этот параметр не указан, размер диска равен размеру резервной копии.
snapshot_id строка			Указывает идентификатор моментального снимка. Если этот параметр указан, диск создаётся из моментального снимка.
state строка		Варианты: present ← absent	Требуется ли существование данного объекта в облаке Huaweicloud.
timeouts словарь			Таймауты для каждой операции.
	create строка	По умолчанию: "30м"	Таймауты для операции создания.
	delete строка	По умолчанию: "30м"	Таймауты для операции удаления.
	update строка	По умолчанию: "30м"	Таймауты для операции обновления.
user строка / обязательно			Имя пользователя для входа (в настоящее время поддерживаются только имена пользователей, а не идентификаторы пользователей).
volume_type строка / обязательно			Указывает тип диска. В настоящее время значение может быть SSD, SAS или SATA. SSD — ультрабыстрый тип диска с высокой производительностью ввода-вывода. SAS — тип диска с высокой производительностью ввода-вывода. SATA — стандартный тип диска с обычной производительностью ввода-вывода. Если указанный тип диска недоступен в AZ, создание диска завершится ошибкой. Если диск EVS создается из моментального снимка, поле volume_type должно совпадать с типом диска-источника моментального снимка.

Примечания

Примечание

Для аутентификации можно установить identity_endpoint, используя переменную среды ANSIBLE_HWC_IDENTITY_ENDPOINT.
Для аутентификации можно установить user, используя переменную среды ANSIBLE_HWC_USER.
Для аутентификации можно установить password, используя переменную среды ANSIBLE_HWC_PASSWORD.
Для аутентификации можно установить domain, используя переменную среды ANSIBLE_HWC_DOMAIN.
Для аутентификации можно установить project, используя переменную среды ANSIBLE_HWC_PROJECT.
Для аутентификации можно установить region, используя переменную среды ANSIBLE_HWC_REGION.
Значения переменных среды будут использоваться только в том случае, если значения плейбука не заданы.

Примеры

# test create disk
- name: Create a disk
  community.general.hwc_evs_disk:
    availability_zone: "cn-north-1a"
    name: "ansible_evs_disk_test"
    volume_type: "SATA"
    size: 10

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

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

Ключ		Возвращаемое значение	Описание
attachments сложный		успех	Указывает информацию о подключении диска.
	attached_at строка	успех	Указывает время подключения диска. Формат времени — 'UTC ГГГГ-ММ-ДДЧЧ:ММ:СС'.
	attachment_id строка	успех	Указывает идентификатор информации о подключении.
	device строка	успех	Указывает имя устройства.
	server_id строка	успех	Указывает идентификатор сервера, к которому подключен диск.
availability_zone строка		успех	Указывает зону доступности, в которой вы хотите создать диск.
backup_id строка		успех	Указывает идентификатор резервной копии, которую можно использовать для создания диска. Этот параметр обязателен, когда для создания диска используется резервная копия.
backup_policy_id строка		успех	Указывает идентификатор политики резервного копирования.
created_at строка		успех	Указывает время создания диска. Формат времени — 'UTC ГГГГ-ММ-ДДЧЧ:ММ:СС'.
description строка		успех	Указывает описание диска. Значение может содержать максимум 255 байт.
enable_full_clone логическое		успех	Если диск создается из моментального снимка и необходимо использовать клонирование, установите этот параметр в True.
enable_scsi логическое		успех	Если этот параметр установлен в True, тип устройства диска будет SCSI, что позволяет ECS OS напрямую обращаться к базовым носителям хранения. Поддерживаются команды резервирования SCSI. Если этот параметр установлен в False, тип устройства диска будет VBD, который поддерживает только простые команды чтения/записи SCSI. Если параметр enable_share установлен в True, и этот параметр не указан, создаются общие диски SCSI. Диски SCSI EVS не могут создаваться из резервных копий, что означает, что этот параметр не может быть True, если указан backup_id.
enable_share логическое		успех	Указывает, является ли диск доступным для общего использования. Значение по умолчанию — False.
encryption_id строка		успех	Указывает идентификатор шифрования. Его длина фиксируется в 36 байт.
enterprise_project_id строка		успех	Указывает идентификатор корпоративного проекта. Этот идентификатор связывается с диском при создании диска. Если он не указан, диск привязывается к корпоративному проекту по умолчанию.
image_id строка		успех	Указывает идентификатор образа. Если этот параметр указан, диск создается из образа. Диски BMS системы не могут создаваться из образов BMS.
is_bootable логическое		успех	Указывает, является ли диск загрузочным.
is_readonly логическое		успех	Указывает, является ли диск только для чтения или для чтения и записи. True означает, что диск только для чтения. False означает, что диск для чтения и записи.
name строка		успех	Указывает имя диска. Значение может содержать максимум 255 байт.
size целое число		успех	Указывает размер диска в ГБ. Значения: системный диск — от 1 до 1024 ГБ, диск данных — от 10 до 32768 ГБ. Этот параметр обязателен при создании пустого диска или использовании образа или моментального снимка для создания диска. Если используется образ или моментальный снимок для создания диска, размер диска должен быть больше или равен размеру образа или моментального снимка. Этот параметр необязателен при использовании резервной копии для создания диска. Если этот параметр не указан, размер диска равен размеру резервной копии.
snapshot_id строка		успех	Указывает идентификатор моментального снимка. Если этот параметр указан, диск создается из моментального снимка.
source_volume_id строка		успех	Указывает идентификатор исходного диска. Этот параметр имеет значение, если диск создается из исходного диска.
status строка		успех	Указывает состояние диска.
tags словарь		успех	Указывает метки диска.
volume_type строка		успех	Указывает тип диска. В настоящее время значение может быть SSD, SAS или SATA. SSD указывает тип диска с сверхвысокой производительностью ввода-вывода. SAS указывает тип диска с высокой производительностью ввода-вывода. SATA указывает тип диска с обычной производительностью ввода-вывода. Если указанный тип диска недоступен в зоне доступности, диск не будет создан. Если диск EVS создается из моментального снимка, поле volume_type должно совпадать с типом диска-источника моментального снимка.

Авторы

Huawei Inc. (@huaweicloud)

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