Spec-Zone.ru › Ansible

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

Примечание

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

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

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

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

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

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

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

  • Управление устройствами в системе хранения PowerFlex включает добавление нового устройства, получение сведений об устройстве и удаление устройства.

Требования

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

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

Параметры

Параметр

Комментарии

acceleration_pool_id

string

ID пула ускорения.

Используется при добавлении устройства ускорения.

Поддерживаются следующие типы носителей: SSD и NVDIMM.

Не может использоваться вместе с acceleration_pool_name, storage_pool_name и storage_pool_id.

acceleration_pool_name

string

Имя пула ускорения.

Используется при добавлении устройства ускорения.

Поддерживаются следующие типы носителей: SSD и NVDIMM.

Не может использоваться вместе с storage_pool_id, storage_pool_name и acceleration_pool_name.

current_pathname

string

Полный путь к добавляемому устройству.

Обязателен при добавлении устройства.

device_id

string

ID устройства.

Не может использоваться вместе с device_name.

device_name

string

Имя устройства.

Не может использоваться вместе с device_id.

external_acceleration_type

string

Типы внешнего ускорения устройства.

Используется при добавлении устройства.

Варианты:

  • "Invalid"
  • "None"
  • "Read"
  • "Write"
  • "ReadAndWrite"

force

boolean

Использование флага Force для добавления устройства.

Используйте этот флаг, чтобы перезаписать существующие данные на устройстве.

Используйте этот флаг с осторожностью, поскольку все данные на устройстве будут уничтожены.

Варианты:

  • false ← (по умолчанию)
  • true

hostname

псевдонимы: gateway_host

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

IP-адрес или полное доменное имя узла PowerFlex.

media_type

string

Типы носителей устройства.

Обязателен при добавлении устройства.

Варианты:

  • "HDD"
  • "SSD"
  • "NVDIMM"

password

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

Пароль узла PowerFlex.

port

integer

Номер порта для связи с узлом PowerFlex.

По умолчанию: 443

protection_domain_id

string

ID домена защиты.

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

Не может использоваться вместе с protection_domain_name.

protection_domain_name

string

Имя домена защиты.

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

Не может использоваться вместе с protection_domain_id.

sds_id

string

ID SDS.

Обязателен при добавлении устройства.

Не может использоваться вместе с sds_name.

sds_name

string

Имя SDS.

Обязательно при добавлении устройства.

Не может использоваться вместе с sds_id.

state

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

Состояние устройства.

Варианты:

  • "present"
  • "absent"

storage_pool_id

string

ID пула хранения.

Используется при добавлении устройства хранения.

Поддерживаются следующие типы носителей: SSD и HDD.

Не может использоваться вместе с storage_pool_name, acceleration_pool_id и acceleration_pool_name.

storage_pool_name

string

Имя пула хранения.

Используется при добавлении устройства хранения.

Не может использоваться вместе с storage_pool_id, acceleration_pool_id и acceleration_pool_name.

timeout

integer

Время, по истечении которого соединение будет разорвано.

Значение указывается в секундах.

По умолчанию: 120

username

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

Имя пользователя узла PowerFlex.

validate_certs

псевдонимы: verifycert

boolean

Логическая переменная, определяющая, нужно ли проверять сертификат SSL.

true — указывает, что сертификат SSL необходимо проверить.

false — указывает, что сертификат SSL проверять не нужно.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Значение device_id создаётся только после успешного добавления устройства.
  • Для уникальной идентификации устройства можно указать device_id либо один из параметров current_pathname или device_name вместе с sds_id или sds_name.
  • Для добавления устройства SSD в пул ускорения рекомендуется установить драйвер Rfcache на SDS.
  • Режим check_mode не поддерживается.
  • Модули коллекции ‘dellemc.powerflex’ предназначены для поддержки платформы хранения Dell PowerFlex.

Примеры

- name: Add a device
  dellemc.powerflex.device:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    current_pathname: "/dev/sdb"
    sds_name: "node1"
    media_type: "HDD"
    device_name: "device2"
    storage_pool_name: "pool1"
    protection_domain_name: "domain1"
    external_acceleration_type: "ReadAndWrite"
    state: "present"
- name: Add a device with force flag
  dellemc.powerflex.device:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    current_pathname: "/dev/sdb"
    sds_name: "node1"
    media_type: "HDD"
    device_name: "device2"
    storage_pool_name: "pool1"
    protection_domain_name: "domain1"
    external_acceleration_type: "ReadAndWrite"
    force: true
    state: "present"
- name: Get device details using device_id
  dellemc.powerflex.device:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    device_id: "d7fe088900000000"
    state: "present"
- name: Get device details using (current_pathname, sds_name)
  dellemc.powerflex.device:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    current_pathname: "/dev/sdb"
    sds_name: "node0"
    state: "present"
- name: Get device details using (current_pathname, sds_id)
  dellemc.powerflex.device:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    current_pathname: "/dev/sdb"
    sds_id: "5717d71800000000"
    state: "present"
- name: Remove a device using device_id
  dellemc.powerflex.device:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    device_id: "76eb7e2f00010000"
    state: "absent"
- name: Remove a device using (current_pathname, sds_id)
  dellemc.powerflex.device:
    hostname: "{{hostname}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    port: "{{port}}"
    current_pathname: "/dev/sdb"
    sds_name: "node1"
    state: "absent"

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

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

Ключ

Описание

changed

boolean

Изменился ли ресурс.

Возвращается: всегда

Пример: false

device_details

dictionary

Сведения об устройстве.

Возвращается: если устройство существует

Пример: {"accelerationPoolId": null, "accelerationProps": null, "aggregatedState": "NeverFailed", "ataSecurityActive": false, "autoDetectMediaType": "SSD", "cacheLookAheadActive": false, "capacity": 0, "capacityLimitInKb": 365772800, "deviceCurrentPathName": "/dev/sdb", "deviceOriginalPathName": "/dev/sdb", "deviceState": "Normal", "deviceType": "Unknown", "errorState": "None", "externalAccelerationType": "None", "fglNvdimmMetadataAmortizationX100": 150, "fglNvdimmWriteCacheSize": 16, "firmwareVersion": null, "id": "b6efa59900000000", "ledSetting": "Off", "links": [{"href": "/api/instances/Device::b6efa59900000000", "rel": "self"}, {"href": "/api/instances/Device::b6efa59900000000/relationships /Statistics", "rel": "/api/Device/relationship/Statistics"}, {"href": "/api/instances/Sds::8f3bb0ce00000000", "rel": "/api/parent/relationship/sdsId"}, {"href": "/api/instances/StoragePool::e0d8f6c900000000", "rel": "/api/parent/relationship/storagePoolId"}, {"href": "/api/instances/SpSds::fedf6f2000000000", "rel": "/api/parent/relationship/spSdsId"}], "logicalSectorSizeInBytes": 0, "longSuccessfulIos": {"longWindow": null, "mediumWindow": null, "shortWindow": null}, "maxCapacityInKb": 365772800, "mediaFailing": false, "mediaType": "HDD", "modelName": null, "name": "device230", "persistentChecksumState": "Protected", "physicalSectorSizeInBytes": 0, "protectionDomainId": "9300c1f900000000", "protectionDomainName": "domain1", "raidControllerSerialNumber": null, "rfcacheErrorDeviceDoesNotExist": false, "rfcacheProps": null, "sdsId": "8f3bb0ce00000000", "sdsName": "node1", "serialNumber": null, "slotNumber": null, "spSdsId": "fedf6f2000000000", "ssdEndOfLifeState": "NeverFailed", "storagePoolId": "e0d8f6c900000000", "storagePoolName": "pool1", "storageProps": {"destFglAccDeviceId": null, "destFglNvdimmSizeMb": 0, "fglAccDeviceId": null, "fglNvdimmSizeMb": 0}, "temperatureState": "NeverFailed", "vendorName": null, "writeCacheActive": false}

accelerationPoolId

string

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

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

accelerationPoolName

string

Имя пула ускорения.

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

accelerationProps

string

Свойства ускорения.

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

aggregatedState

string

Сводное состояние.

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

ataSecurityActive

boolean

Состояние активности защиты ATA.

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

autoDetectMediaType

string

Автоматическое определение типа носителя.

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

cacheLookAheadActive

boolean

Состояние активности упреждающего чтения из кэша.

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

capacity

integer

Емкость устройства.

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

capacityLimitInKb

integer

Ограничение емкости устройства в КБ.

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

deviceCurrentPathName

string

Текущий путь к устройству.

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

deviceOriginalPathName

string

Исходный путь к устройству.

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

deviceState

string

Состояние устройства.

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

deviceType

string

Тип устройства.

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

errorState

string

Состояние ошибки.

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

externalAccelerationType

string

Тип внешнего ускорения.

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

fglNvdimmMetadataAmortizationX100

integer

Значение амортизации метаданных FGL NVDIMM.

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

fglNvdimmWriteCacheSize

integer

Размер кэша записи FGL NVDIMM.

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

firmwareVersion

string

Версия микропрограммы.

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

id

string

Идентификатор устройства.

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

ledSetting

string

Настройка светодиодного индикатора.

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

links

list / elements=string

Ссылки на устройство.

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

href

string

URL экземпляра устройства.

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

rel

string

Связь устройства с различными сущностями.

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

logicalSectorSizeInBytes

integer

Размер логического сектора в байтах.

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

longSuccessfulIos

list / elements=string

Длительные успешные операции ввода-вывода.

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

maxCapacityInKb

integer

Максимальное ограничение емкости устройства в КБ.

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

mediaFailing

boolean

Признак сбоя носителя.

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

mediaType

string

Тип носителя.

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

modelName

string

Название модели.

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

name

string

Имя устройства.

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

persistentChecksumState

string

Состояние постоянной контрольной суммы.

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

physicalSectorSizeInBytes

integer

Размер физического сектора в байтах.

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

protectionDomainId

string

Идентификатор домена защиты.

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

protectionDomainName

string

Имя домена защиты.

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

raidControllerSerialNumber

string

Серийный номер RAID-контроллера.

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

rfcacheErrorDeviceDoesNotExist

boolean

Признак того, что устройство с ошибкой кэша RF не существует.

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

rfcacheProps

string

Свойства кэша RF.

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

sdsId

string

Идентификатор SDS.

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

sdsName

string

Имя SDS.

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

serialNumber

string

Серийный номер.

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

spSdsId

string

Идентификатор SDS для SP.

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

ssdEndOfLifeState

string

Состояние окончания срока службы SSD.

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

storagePoolId

string

Идентификатор пула хранения.

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

storagePoolName

string

Имя пула хранения.

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

storageProps

list / elements=string

Свойства хранилища.

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

temperatureState

string

Состояние температуры.

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

vendorName

string

Название производителя.

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

writeCacheActive

boolean

Признак активности кэша записи.

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

Авторы

  • Rajshree Khare (@khareRajshree)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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_module.html

Spec-Zone.ru

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