Spec-Zone.ru › Ansible

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

Примечание

Этот модуль является частью коллекции dellemc.powerflex (версия 2.5.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 1.12.0.

Параметры

Параметр

Комментарии

acceleration_pool_id

строка

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

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

Поддерживаемые типы носителей SSD и NVDIMM.

Взаимоисключающие параметры с acceleration_pool_name, storage_pool_name и storage_pool_id.

acceleration_pool_name

строка

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

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

Поддерживаемые типы носителей SSD и NVDIMM.

Взаимоисключающие параметры с storage_pool_id, storage_pool_name и acceleration_pool_name.

current_pathname

строка

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

Необходимый параметр при добавлении устройства.

device_id

строка

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

Взаимоисключающий параметр с device_name.

device_name

строка

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

Взаимоисключающий параметр с device_id.

external_acceleration_type

строка

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

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

Варианты:

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

force

булево

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

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

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

Варианты:

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

hostname

алиасы: gateway_host

строка / обязательно

IP-адрес или FQDN хоста PowerFlex.

media_type

строка

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

Необходимый параметр при добавлении устройства.

Варианты:

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

password

строка / обязательно

Пароль хоста PowerFlex.

port

целое число

Номер порта, через который происходит общение с хостом PowerFlex.

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

protection_domain_id

строка

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

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

Взаимоисключающий параметр с protection_domain_name.

protection_domain_name

строка

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

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

Взаимоисключающий параметр с protection_domain_id.

sds_id

строка

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

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

Взаимоисключающий параметр с sds_name.

sds_name

строка

Имя SDS.

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

Взаимоисключающий параметр с sds_id.

state

строка / обязательно

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

Варианты:

  • "present"
  • "absent"

storage_pool_id

строка

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

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

Поддерживаемые типы носителей SSD и HDD.

Взаимоисключающие параметры с storage_pool_name, acceleration_pool_id и acceleration_pool_name.

storage_pool_name

строка

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

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

Взаимоисключающие параметры с storage_pool_id, acceleration_pool_id и acceleration_pool_name.

timeout

целое число

Время, по истечении которого произойдет отключение соединения.

Указывается в секундах.

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

username

строка / обязательно

Имя пользователя хоста PowerFlex.
END_OF_DOCUMENT_MARKER

validate_certs

aliases: verifycert

boolean

Булево значение для указания, необходимо ли проверять сертификат SSL.

true - Указывает, что сертификат SSL должен быть проверен.

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

Варианты:

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

Примечания

Примечание

  • Значение для device_id генерируется только после успешного добавления устройства.
  • Для уникальной идентификации устройства можно передать либо device_id, либо current_pathname или device_name вместе с sds_id или sds_name.
  • Рекомендуется установить драйвер Rfcache для устройства SSD на 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

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

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

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

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

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

ledSetting

string

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

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

links

list / elements=string

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

Возвращено: success

href

string

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

Возвращено: success

rel

string

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

Возвращено: success

logicalSectorSizeInBytes

integer

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

Возвращено: success

longSuccessfulIos

list / elements=string

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

Возвращено: success

maxCapacityInKb

integer

Максимальный предел емкости устройства в КБ.

Возвращено: success

mediaFailing

boolean

Указывает на неисправность носителя.

Возвращено: success

mediaType

string

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

Возвращено: success

modelName

string

Указывает имя модели.

Возвращено: success

name

string

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

Возвращено: success

persistentChecksumState

string

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

Возвращено: success

physicalSectorSizeInBytes

integer

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

Возвращено: success

protectionDomainId

string

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

Возвращено: success

protectionDomainName

string

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

Возвращено: success

raidControllerSerialNumber

string

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

Возвращено: success

rfcacheErrorDeviceDoesNotExist

boolean

Указывает на ошибку кэша RF: устройство не существует.

Возвращено: success

rfcacheProps

string

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

Возвращено: success

sdsId

string

ID SDS.

Возвращено: success

sdsName

string

Имя SDS.

Возвращено: success

serialNumber

string

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

Возвращено: success

spSdsId

string

Указывает ID SDS для SP.

Возвращено: success

ssdEndOfLifeState

string

Указывает состояние SSD на конец срока службы.

Возвращено: success

storagePoolId

string

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

Возвращено: success

storagePoolName

string

Имя хранилища.

Возвращаемое значение: успех

storageProps

список / элементы=строка

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

Возвращаемое значение: успех

temperatureState

строка

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

Возвращаемое значение: успех

vendorName

строка

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

Возвращаемое значение: успех

writeCacheActive

булево

Указывает активность кэша записи.

Возвращаемое значение: успех

Авторы

  • Rajshree Khare (@khareRajshree)

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

  • Система отслеживания ошибок
  • Репозиторий (источники)

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

Spec-Zone.ru

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