Spec-Zone.ru › Ansible

Модуль community.general.hwc_evs_disk — создание ресурса Evs/Disk в Huawei Cloud

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в сценарии, укажите: community.general.hwc_evs_disk.

Добавлено в community.general 0.2.0

  • Краткое описание
  • Требования
  • Параметры
  • Атрибуты
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управление блочным хранилищем.

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

  • keystoneauth1 >= 3.6.0

Параметры

Параметр

Комментарии

availability_zone

string / обязательный

Указывает зону доступности, в которой нужно создать диск.

backup_id

string

Указывает идентификатор резервной копии, которую можно использовать для создания диска. Этот параметр обязателен, если для создания диска используется резервная копия.

description

string

Указывает описание диска. Максимальная длина значения — 255 байт.

domain

string / обязательный

Имя области действия Domain (Identity v3).

В настоящее время поддерживаются только имена доменов, но не их идентификаторы.

enable_full_clone

boolean

Если диск создается из снимка и необходимо использовать связанное клонирование, установите для этого параметра значение True.

Варианты:

  • false
  • true

enable_scsi

boolean

Если для этого параметра задано значение true, тип устройства диска — SCSI, что позволяет ОС ECS напрямую обращаться к нижележащим носителям данных. Поддерживается команда резервирования SCSI. Если для этого параметра задано значение false, тип устройства диска — VBD, который поддерживает только простые команды чтения и записи SCSI.

Если для параметра enable_share задано значение True, а этот параметр не указан, создаются общие диски SCSI. Диски EVS SCSI нельзя создавать из резервных копий, поэтому для этого параметра нельзя задавать значение True, если указан backup_id.

Варианты:

  • false
  • true

enable_share

boolean

Указывает, является ли диск общим. Значение по умолчанию — False.

Варианты:

  • false
  • true

encryption_id

string

Указывает идентификатор шифрования. Его длина фиксирована и составляет 36 байт.

enterprise_project_id

string

Указывает идентификатор корпоративного проекта. Этот идентификатор связывается с диском при его создании. Если он не указан, диск привязывается к корпоративному проекту по умолчанию.

id

string

Идентификатор управляемого ресурса.

identity_endpoint

string / обязательный

URL-адрес аутентификации Identity.

image_id

string

Указывает идентификатор образа. Если этот параметр указан, диск создается из образа. Системные диски BMS нельзя создавать из образов BMS.

name

string / обязательный

Указывает имя диска. Максимальная длина значения — 255 байт.

password

string / обязательный

Пароль для входа в систему.

project

string / обязательный

Имя Tenant (Identity v2) или Project (Identity v3).

В настоящее время поддерживаются только имена проектов, но не их идентификаторы.

region

string

Регион, к которому относится проект.

size

integer

Указывает размер диска в ГБ. Допустимые значения: системный диск — от 1 до 1024 ГБ, диск данных — от 10 до 32768 ГБ. Этот параметр обязателен при создании пустого диска, а также при создании диска из образа или снимка. Если диск создается из образа или снимка, его размер должен быть не меньше размера образа или снимка. При создании диска из резервной копии этот параметр необязателен. Если параметр не указан, размер диска будет равен размеру резервной копии.

snapshot_id

string

Указывает идентификатор снимка. Если этот параметр указан, диск создается из снимка.

state

string

Должен ли указанный объект существовать в Huawei Cloud.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

timeouts

dictionary

Тайм-ауты для каждой операции.

По умолчанию: {}

create

string

Тайм-аут операции создания.

По умолчанию: "30m"

delete

string

Тайм-аут операции удаления.

По умолчанию: "30m"

update

string

Тайм-аут операции обновления.

По умолчанию: "30m"

user

string / обязательный

Имя пользователя для входа в систему.

В настоящее время поддерживаются только имена пользователей, но не их идентификаторы.

volume_type

string / обязательный

Указывает тип диска. В настоящее время допустимы значения SSD, SAS или SATA.

SSD обозначает тип диска со сверхвысокой производительностью ввода-вывода.

SAS обозначает тип диска с высокой производительностью ввода-вывода.

SATA обозначает тип диска со стандартной производительностью ввода-вывода.

Если указанный тип диска недоступен в зоне доступности, создание диска завершается с ошибкой. Если диск EVS создается из снимка, значение поля volume_type должно совпадать со значением для исходного диска снимка.

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

Может выполняться в режиме check_mode и возвращать прогноз статуса изменений без внесения изменений на целевом узле.

diff_mode

Поддержка: нет

В режиме сравнения изменений возвращает сведения о том, что изменилось (или что, возможно, необходимо изменить в check_mode).

Примечания

Примечание

  • Для аутентификации можно задать 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

list / elements=dictionary

Содержит сведения о подключении диска.

Возвращается: при успешном выполнении

attached_at

string

Указывает время подключения диска. Формат времени: ‘UTC YYYY-MM-DDTHH:MM:SS’.

Возвращается: при успешном выполнении

attachment_id

string

Указывает идентификатор сведений о подключении.

Возвращается: при успешном выполнении

device

string

Указывает имя устройства.

Возвращается: при успешном выполнении

server_id

string

Указывает идентификатор сервера, к которому подключен диск.

Возвращается: при успешном выполнении

availability_zone

string

Указывает зону доступности (AZ), в которой нужно создать диск.

Возвращается: при успешном выполнении

backup_id

string

Указывает идентификатор резервной копии, которую можно использовать для создания диска. Этот параметр обязателен, если для создания диска используется резервная копия.

Возвращается: при успешном выполнении

backup_policy_id

string

Указывает идентификатор политики резервного копирования.

Возвращается: при успешном выполнении

created_at

string

Указывает время создания диска. Формат времени: ‘UTC YYYY-MM-DDTHH:MM:SS’.

Возвращается: при успешном выполнении

description

string

Указывает описание диска. Длина значения не должна превышать 255 байт.

Возвращается: при успешном выполнении

enable_full_clone

boolean

Если диск создается из снимка и необходимо использовать связанное клонирование, задайте для этого параметра значение True.

Возвращается: при успешном выполнении

enable_scsi

boolean

Если для этого параметра задано значение true, тип устройства диска — SCSI, что позволяет ОС ECS напрямую обращаться к базовым носителям данных. Поддерживается команда резервирования SCSI. Если для этого параметра задано значение false, тип устройства диска — VBD, который поддерживает только простые команды чтения/записи SCSI.

Если параметру enable_share задано значение True, а этот параметр не указан, создаются общие диски SCSI. Диски EVS SCSI нельзя создавать из резервных копий, поэтому этому параметру нельзя присвоить значение True, если указан backup_id.

Возвращается: при успешном выполнении

enable_share

boolean

Указывает, является ли диск общим. Значение по умолчанию — False.

Возвращается: при успешном выполнении

encryption_id

string

Указывает идентификатор шифрования. Его длина фиксирована и составляет 36 байт.

Возвращается: при успешном выполнении

enterprise_project_id

string

Указывает идентификатор корпоративного проекта. Этот идентификатор связывается с диском при его создании. Если он не указан, диск привязывается к корпоративному проекту по умолчанию.

Возвращается: при успешном выполнении

image_id

string

Указывает идентификатор образа. Если этот параметр указан, диск создается из образа. Системные диски BMS нельзя создавать из образов BMS.

Возвращается: при успешном выполнении

is_bootable

boolean

Указывает, является ли диск загрузочным.

Возвращается: при успешном выполнении

is_readonly

boolean

Указывает, доступен ли диск только для чтения или для чтения и записи. Значение True означает, что диск доступен только для чтения. Значение False означает, что диск доступен для чтения и записи.

Возвращается: при успешном выполнении

name

string

Указывает имя диска. Длина значения не должна превышать 255 байт.

Возвращается: при успешном выполнении

size

integer

Указывает размер диска в ГБ. Допустимые значения: системный диск — от 1 до 1024 ГБ, диск данных — от 10 до 32768 ГБ. Этот параметр обязателен при создании пустого диска, а также при создании диска из образа или снимка. Если диск создается из образа или снимка, его размер должен быть не меньше размера образа или снимка. Этот параметр необязателен, если диск создается из резервной копии. Если параметр не указан, размер диска будет равен размеру резервной копии.

Возвращается: при успешном выполнении

snapshot_id

string

Указывает идентификатор снимка. Если этот параметр указан, диск создается из снимка.

Возвращается: при успешном выполнении

source_volume_id

string

Указывает идентификатор исходного диска. Этот параметр имеет значение, если диск создан на основе исходного диска.

Возвращается: при успешном выполнении

status

string

Указывает состояние диска.

Возвращается: при успешном выполнении

tags

dictionary

Указывает теги диска.

Возвращается: при успешном выполнении

volume_type

string

Указывает тип диска. В настоящее время допустимы значения SSD, SAS и SATA.

SSD обозначает тип диска со сверхвысокой производительностью ввода-вывода.

SAS обозначает тип диска с высокой производительностью ввода-вывода.

SATA обозначает тип диска со стандартной производительностью ввода-вывода.

Если указанный тип диска недоступен в зоне доступности, создать диск не удастся. Если диск EVS создается из снимка, поле volume_type должно совпадать с типом исходного диска снимка.

Возвращается: при успешном выполнении

Авторы

  • Huawei Inc. (@huaweicloud)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Задать вопрос
  • Сообщить об ошибке
  • Предложить новую функцию
  • Общение

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

Spec-Zone.ru

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