community.general.hwc_evs_disk – Создаёт ресурс диска Evs/Disk в Huawei Cloud
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: 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 строка | Указывает ID резервной копии, которая может быть использована для создания диска. Этот параметр является обязательным, когда вы используете резервную копию для создания диска. | ||
| description строка | Указывает описание диска. Значение может содержать не более 255 байт. | ||
| domain строка / обязательно | Имя домена для области действия (Identity v3). (в настоящее время поддерживаются только имена доменов, а не идентификаторы доменов). | ||
| enable_full_clone логическое значение |
| Если диск создаётся из снимка и необходимо использовать клонирование, установите этот параметр в значение True. | |
| enable_scsi логическое значение |
| Если этот параметр установлен в значение True, тип устройства диска будет SCSI, что позволяет операционным системам ECS напрямую обращаться к базовым носителям хранения. Поддерживается команда резервирования SCSI. Если этот параметр установлен в значение False, тип устройства диска будет VBD, который поддерживает только простые команды чтения/записи SCSI. Если параметр enable_share установлен в значение True и этот параметр не указан, создаются объединённые SCSI-диски. Диски SCSI EVS не могут быть созданы из резервных копий, что означает, что этот параметр не может быть True, если backup_id был указан. | |
| enable_share логическое значение |
| Указывает, является ли диск доступным для совместного использования. Значение по умолчанию - False. | |
| encryption_id строка | Указывает идентификатор шифрования. Его длина фиксируется в 36 байтах. | ||
| enterprise_project_id строка | Указывает идентификатор корпоративного проекта. Этот идентификатор связывается с диском во время создания диска. Если он не указан, диск привязывается к корпоративному проекту по умолчанию. | ||
| id строка | Идентификатор ресурса, который необходимо обработать. | ||
| identity_endpoint строка / обязательно | URL аутентификации идентификации. | ||
| image_id строка | Указывает ID образа. Если этот параметр указан, диск создаётся из образа. Диски BMS системы не могут быть созданы из изображений BMS. | ||
| name строка / обязательно | Указывает имя диска. Значение может содержать не более 255 байт. | ||
| password строка / обязательно | Пароль для входа. | ||
| project строка / обязательно | Имя арендатора (Identity v2) или проекта (Identity v3). (в настоящее время поддерживаются только имена проектов, а не идентификаторы проектов). | ||
| region строка | Регион, к которому принадлежит проект. | ||
| size целое число | Указывает размер диска в ГБ. Допустимые значения: системный диск от 1 до 1024 ГБ, диск данных от 10 до 32768 ГБ. Этот параметр является обязательным при создании пустого диска или использовании образа или снимка для создания диска. Если вы используете образ или снимок для создания диска, размер диска должен быть больше или равен размеру образа или снимка. Этот параметр необязателен при использовании резервной копии для создания диска. Если этот параметр не указан, размер диска равен размеру резервной копии. | ||
| snapshot_id строка | Указывает ID снимка. Если этот параметр указан, диск создаётся из снимка. | ||
| state строка |
| Требуется ли существование данного объекта в облаке Huaweicloud. | |
| timeouts словарь | Таймауты для каждой операции. | ||
| create строка | Значение по умолчанию: "30m" | Таймауты для операции создания. | |
| delete строка | Значение по умолчанию: "30m" | Таймауты для операции удаления. | |
| update строка | Значение по умолчанию: "30m" | Таймауты для операции обновления. | |
| 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 complex | success | Указывает информацию об подключении диска. | |
| attached_at string | success | Указывает время подключения диска. Формат времени 'UTC YYYY-MM-DDTHH:MM:SS'. | |
| attachment_id string | success | Указывает ID информации о подключении. | |
| device string | success | Указывает имя устройства. | |
| server_id string | success | Указывает ID сервера, к которому подключен диск. | |
| availability_zone string | success | Указывает AZ, в котором вы хотите создать диск. | |
| backup_id string | success | Указывает ID резервной копии, которая может быть использована для создания диска. Этот параметр является обязательным, когда вы используете резервную копию для создания диска. | |
| backup_policy_id string | success | Указывает ID политики резервного копирования. | |
| created_at string | success | Указывает время создания диска. Формат времени 'UTC YYYY-MM-DDTHH:MM:SS'. | |
| description string | success | Указывает описание диска. Значение может содержать максимум 255 байтов. | |
| enable_full_clone boolean | success | Если диск создается из моментального снимка и требуется использовать полное клонирование, установите этот параметр в True. | |
| enable_scsi boolean | success | Если этот параметр установлен в True, тип устройства диска будет SCSI, что позволяет ECS OS напрямую обращаться к основным носителям хранения. Поддерживается команда резервирования SCSI. Если этот параметр установлен в False, тип устройства диска будет VBD, который поддерживает только простые команды чтения/записи SCSI. Если параметр enable_share установлен в True, и этот параметр не указан, создаются общие диски SCSI. Диски SCSI EVS не могут быть созданы из резервных копий, что означает, что этот параметр не может быть True, если указан backup_id. | |
| enable_share boolean | success | Указывает, является ли диск общим. Значение по умолчанию — False. | |
| encryption_id string | success | Указывает ID шифрования. Его длина фиксирована и составляет 36 байтов. | |
| enterprise_project_id string | success | Указывает ID корпоративного проекта. Этот ID связывается с диском во время создания диска. Если он не указан, диск привязан к корпоративному проекту по умолчанию. | |
| image_id string | success | Указывает ID образа. Если этот параметр указан, диск создается из образа. Диски BMS системы не могут быть созданы из образов BMS. | |
| is_bootable boolean | success | Указывает, является ли диск загрузочным. | |
| is_readonly boolean | success | Указывает, является ли диск только для чтения или для чтения/записи. True указывает, что диск только для чтения. False указывает, что диск для чтения/записи. | |
| name string | success | Указывает имя диска. Значение может содержать максимум 255 байтов. | |
| size integer | success | Указывает размер диска в ГБ. Значения следующие: системный диск — от 1 до 1024 ГБ, диск данных — от 10 до 32768 ГБ. Этот параметр обязателен при создании пустого диска или использовании образа или моментального снимка для создания диска. Если вы используете образ или моментальный снимок для создания диска, размер диска должен быть больше или равен размеру образа или моментального снимка. Этот параметр необязателен при использовании резервной копии для создания диска. Если этот параметр не указан, размер диска равен размеру резервной копии. | |
| snapshot_id string | success | Указывает ID моментального снимка. Если этот параметр указан, диск создается из моментального снимка. | |
| source_volume_id string | success | Указывает ID исходного диска. Этот параметр имеет значение, если диск создается из исходного диска. | |
| status string | success | Указывает состояние диска. | |
| tags dictionary | success | Указывает теги диска. | |
| volume_type string | success | Указывает тип диска. В настоящее время значение может быть SSD, SAS или SATA. SSD указывает тип диска с ультравысокой производительностью ввода-вывода. SAS указывает тип диска с высокой производительностью ввода-вывода. SATA указывает тип диска с обычной производительностью ввода-вывода. Если указанный тип диска недоступен в AZ, создание диска не удастся. Если диск EVS создается из моментального снимка, поле volume_type должно быть таким же, как и у исходного диска моментального снимка. | |
Авторы
- Huawei Inc. (@huaweicloud)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/hwc_evs_disk_module.html