Spec-Zone.ru › Ansible 2.11

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
логическое значение
    Варианты:
  • 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 аутентификации идентификации.
image_id
строка
Указывает ID образа. Если этот параметр указан, диск создаётся из образа. Диски BMS системы не могут быть созданы из изображений BMS.
name
строка / обязательно
Указывает имя диска. Значение может содержать не более 255 байт.
password
строка / обязательно
Пароль для входа.
project
строка / обязательно
Имя арендатора (Identity v2) или проекта (Identity v3). (в настоящее время поддерживаются только имена проектов, а не идентификаторы проектов).
region
строка
Регион, к которому принадлежит проект.
size
целое число
Указывает размер диска в ГБ. Допустимые значения: системный диск от 1 до 1024 ГБ, диск данных от 10 до 32768 ГБ. Этот параметр является обязательным при создании пустого диска или использовании образа или снимка для создания диска. Если вы используете образ или снимок для создания диска, размер диска должен быть больше или равен размеру образа или снимка. Этот параметр необязателен при использовании резервной копии для создания диска. Если этот параметр не указан, размер диска равен размеру резервной копии.
snapshot_id
строка
Указывает ID снимка. Если этот параметр указан, диск создаётся из снимка.
state
строка
    Варианты:
  • present ←
  • absent
Требуется ли существование данного объекта в облаке 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API