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