Модуль dellemc.powerflex.device_v2 — управление устройством в Dell PowerFlex

Примечание

Этот модуль входит в коллекцию dellemc.powerflex (версия 3.0.0).

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

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

Чтобы использовать его в плейбуке, укажите: dellemc.powerflex.device_v2.

Добавлено в dellemc.powerflex 3.0.0

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

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

Управление устройством в системе хранения PowerFlex включает добавление нового устройства, получение сведений об устройстве, изменение его атрибутов и удаление устройства.
Поддерживаются только версии PowerFlex 5.0 и выше.

Требования

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

Система хранения Dell PowerFlex версии 5.0 или более поздней.
PyPowerFlex 2.0.0

Параметры

Параметр	Комментарии
capacity_limit_gb integer	Ограничение ёмкости устройства в ГБ.
clear_error boolean	Используйте этот флаг, чтобы сбросить ошибку устройства. Если ошибка не устранена, при обращении к устройству оно снова перейдёт в состояние ошибки. Варианты: `false` `true`
current_pathname string	Полный путь к добавляемому устройству. Обязателен при добавлении устройства.
device_group_id string	Идентификатор группы устройств. Обязателен при добавлении устройства. Не совместим с device_group_name.
device_group_name string	Название группы устройств. Обязательно при добавлении устройства. Не совместимо с device_group_id.
device_id string	Идентификатор устройства. Не совместим с device_name.
device_name string	Имя устройства. Не совместимо с device_id.
force boolean	Используйте флаг Force для добавления устройства. Используйте этот флаг, чтобы сбросить состояние ошибки устройства без проверки. Используйте этот флаг с осторожностью, поскольку все данные на устройстве будут уничтожены. Варианты: `false` `true`
hostname псевдонимы: gateway_host string / обязательный	IP-адрес или FQDN узла PowerFlex.
media_type string	Тип носителя устройства. Обязателен при добавлении устройства. Варианты: `"SSD"` `"PMEM"`
new_device_name string	Новое имя устройства.
password string / обязательный	Пароль узла PowerFlex.
port integer	Номер порта для взаимодействия с узлом PowerFlex. По умолчанию: `443`
state string	Состояние устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`
storage_node_id string	Идентификатор узла хранения. Обязателен при добавлении устройства. Не совместим с storage_node_name.
storage_node_name string	Имя узла хранения. Обязательно при добавлении устройства. Не совместимо с storage_node_id.
timeout integer	Время, по истечении которого соединение будет разорвано. Значение указывается в секундах. По умолчанию: `120`
username string / обязательный	Имя пользователя узла PowerFlex.
validate_certs псевдонимы: verifycert boolean	Логическая переменная, указывающая, следует ли проверять сертификат SSL. `true` — означает, что сертификат SSL следует проверить. `false` — означает, что сертификат SSL проверять не следует. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Запускает задачу для проверки без выполнения действий на целевой машине.
diff_mode	Поддержка: полная	Запускает задачу для отображения внесённых или планируемых изменений.

Примечания

Примечание

Модули коллекции «dellemc.powerflex» предназначены для поддержки платформы хранения Dell PowerFlex.

Примеры

- name: Create device
  register: device1_result
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    current_pathname: "/dev/sdc"
    device_group_name: "DG1"
    media_type: "SSD"
    storage_node_name: "Node1"

- name: Create device using name with force flag
  register: device2_result
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    current_pathname: "/dev/sdd"
    device_group_id: "39a898be00000000"
    storage_node_id: "03b589bf00000003"
    media_type: "SSD"
    device_name: "node1-d2"
    force: true
    state: "present"

- name: Get device details using device_id
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    device_id: "{{ device1_result.device_details.id }}"
    state: "present"

- name: Get device details using (current_pathname, storage_node_name)
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    current_pathname: "/dev/sdd"
    storage_node_name: "Node1"
    state: "present"

- name: Get device details using (current_pathname, storage_node_id)
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    current_pathname: "/dev/sdd"
    storage_node_id: "03b589bf00000003"
    state: "present"

- name: Rename device
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    device_id: "{{ device1_result.device_details.id }}"
    new_device_name: "node1-d3"
    state: "present"

- name: Clear device error
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    device_id: "{{ device1_result.device_details.id }}"
    clear_error: true
    force: true
    state: "present"

- name: Clear device error with force flag
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    device_name: "{{ device2_result.device_details.name }}"
    clear_error: true
    force: true
    state: "present"

- name: Modify device capacity limit
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    device_name: "{{ device2_result.device_details.name }}"
    capacity_limit_gb: 500
    state: "present"

- name: Remove device using device_id
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    device_id: "{{ device1_result.device_details.id }}"
    state: "absent"

- name: Remove device using (current_pathname, storage_node_name)
  dellemc.powerflex.device_v2:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    current_pathname: "/dev/sdd"
    storage_node_name: "Node1"
    state: "absent"

Возвращаемые значения

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

Ключ	Описание
changed boolean	Изменился ли ресурс. Возвращается: всегда Пример: `false`
device_details dictionary	Сведения об устройстве. Возвращается: если устройство существует Пример: {"accelerationPoolId": null, "accelerationProps": null, "aggregatedState": "NeverFailed", "ataSecurityActive": false, "autoDetectMediaType": null, "cacheLookAheadActive": false, "capacity": 0, "capacityInMb": 1048576, "capacityLimitInKb": 1073479680, "deviceCurrentPathName": "/dev/sdd", "deviceGroupId": "39a898be00000000", "deviceOriginalPathName": "/dev/sdd", "deviceState": "Normal", "deviceType": "Unknown", "errorState": "None", "externalAccelerationType": "None", "fglNvdimmMetadataAmortizationX100": null, "fglNvdimmWriteCacheSize": null, "firmwareVersion": null, "id": "e7ffaabf00030002", "ledSetting": "Off", "links": [{"href": "/api/instances/Device::e7ffaabf00030002", "rel": "self"}, {"body": {"ids": ["e7ffaabf00030002"], "resource_type": "device"}, "href": "/dtapi/rest/v1/metrics/query", "rel": "/dtapi/rest/v1/metrics/query"}, {"href": "/api/instances/DeviceGroup::39a898be00000000", "rel": "/api/parent/relationship/deviceGroupId"}, {"href": "/api/instances/StorageNode::03b589bf00000003", "rel": "/api/parent/relationship/storageNodeId"}], "logicalSectorSizeInBytes": 0, "longSuccessfulIos": {"longWindow": null, "mediumWindow": null, "shortWindow": null}, "maxCapacityInKb": 1073479680, "mediaFailing": false, "mediaType": "SSD", "modelName": null, "name": null, "persistentChecksumState": "StateInvalid", "physicalSectorSizeInBytes": 0, "raidControllerSerialNumber": null, "rfcacheErrorDeviceDoesNotExist": false, "rfcacheProps": null, "sdsId": null, "serialNumber": null, "slotNumber": "N/A", "spSdsId": null, "ssdEndOfLifeState": "NeverFailed", "storageNodeId": "03b589bf00000003", "storagePoolId": null, "storageProps": null, "temperatureState": "NeverFailed", "usableCapacityInMb": 1048320, "vendorName": null, "writeCacheActive": false}
aggregatedState string	Указывает агрегированное состояние устройства. Возвращается: при успешном выполнении
ataSecurityActive boolean	Указывает, активно ли состояние безопасности ATA. Возвращается: при успешном выполнении
autoDetectMediaType string	Результат автоматического определения типа носителя. Возвращается: при успешном выполнении
cacheLookAheadActive boolean	Указывает, активно ли упреждающее чтение кэша. Возвращается: при успешном выполнении
capacity integer	Емкость устройства в байтах. Возвращается: при успешном выполнении
capacityLimitInKb integer	Ограничение емкости устройства в КБ. Возвращается: при успешном выполнении
deviceCurrentPathname string	Текущий путь к устройству. Возвращается: при успешном выполнении
deviceGroupId string	Идентификатор группы устройств. Возвращается: при успешном выполнении
deviceOriginalPathname string	Исходный путь к устройству. Возвращается: при успешном выполнении
deviceState string	Указывает состояние устройства. Возвращается: при успешном выполнении
deviceType string	Указывает тип устройства. Возвращается: при успешном выполнении
errorState string	Указывает состояние ошибки. Возвращается: при успешном выполнении
firmwareVersion string	Версия встроенного ПО устройства. Возвращается: при успешном выполнении
id string	Идентификатор устройства. Возвращается: при успешном выполнении
ledSetting string	Состояние настройки светодиода. Возвращается: при успешном выполнении
logicalSectorSizeInBytes integer	Размер логического сектора в байтах. Возвращается: при успешном выполнении
longSuccessfulIos dictionary	Указывает на длительные успешные операции ввода-вывода. Возвращается: при успешном выполнении
maxCapacityInKb integer	Максимальная емкость устройства в КБ. Возвращается: при успешном выполнении
mediaFailing boolean	Указывает, выходит ли носитель из строя. Возвращается: при успешном выполнении
mediaType string	Указывает тип носителя. Возвращается: при успешном выполнении
modelName string	Название модели устройства. Возвращается: при успешном выполнении
name string	Имя устройства. Возвращается: при успешном выполнении
persistentChecksumState string	Указывает состояние постоянной контрольной суммы. Возвращается: при успешном выполнении
physicalSectorSizeInBytes integer	Размер физического сектора в байтах. Возвращается: при успешном выполнении
raidControllerSerialNumber string	Серийный номер RAID-контроллера. Возвращается: при успешном выполнении
serialNumber string	Серийный номер устройства. Возвращается: при успешном выполнении
ssdEndOfLifeState string	Указывает состояние окончания срока службы SSD. Возвращается: при успешном выполнении
storageNodeId string	Идентификатор узла хранения. Возвращается: при успешном выполнении
storageProps dictionary	Свойства устройства хранения данных. Возвращается: при успешном выполнении
temperatureState string	Указывает температурное состояние. Возвращается: при успешном выполнении
updateConfiguration boolean	Указывает, включено ли обновление конфигурации. Возвращается: при успешном выполнении
vendorName string	Название производителя устройства. Возвращается: при успешном выполнении
writeCacheActive boolean	Указывает, активно ли кэширование записи. Возвращается: при успешном выполнении

Авторы

Tao He (@taohe1012)

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

© 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/dellemc/powerflex/device_v2_module.html