dellemc.powerflex.info модуль — Сбор информации о Dell PowerFlex
Примечание
Этот модуль является частью коллекции dellemc.powerflex (версия 2.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install dellemc.powerflex. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.
Для использования в playbook укажите: dellemc.powerflex.info.
Новая функция в dellemc.powerflex 1.0.0
Обзор
- Сбор информации о системе хранения Dell PowerFlex включает получение данных API, списка томов, SDS, SDC, хранилищ, областей защиты, политик снимков и устройств.
- Сбор информации о Dell PowerFlex Manager включает получение списка управляемых устройств, развертываний, шаблонов служб и репозитория микропрограмм.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется этот модуль.
- Система хранения Dell PowerFlex версии 3.6 или более поздней.
- PyPowerFlex 1.12.0.
Параметры
Параметр | Комментарии |
|---|---|
filters list / elements=dictionary | Список фильтров для поддержки отфильтрованного вывода для объектов хранения. Каждый фильтр представляет собой список filter_key, filter_operator, filter_value. Поддерживает передачу нескольких фильтров. |
|
filter_key string / required |
Идентификатор имени фильтра. |
|
filter_operator string / required |
Операция, которая должна быть выполнена над ключом фильтра. Выбор Варианты:
|
|
filter_value string / required |
Значение ключа фильтра. |
full boolean | Укажите, является ли ответ полным или кратким. Применимо, когда gather_subset равно Для Варианты:
|
gather_subset list / elements=string | Список строковых переменных для указания сущностей системы хранения PowerFlex, для которых требуется информация. Тома - Пулы хранения - Домены защиты - SDCs - SDSs - Политики снимков - Устройства - Группы согласованности репликации - Пары репликации - Наборы ошибок - Шаблоны сервисов - Управляемые устройства - Развертывания - FirmwareRepository - Варианты:
|
hostname aliases: gateway_host string / required | IP-адрес или FQDN хоста PowerFlex. |
include_attachments boolean | Включить вложения. Применимо, когда gather_subset равно Варианты:
|
include_bundles boolean добавлено в dellemc.powerflex 2.3.0 | Включить сущности программных пакетов. Применимо, когда gather_subset равно Варианты:
|
include_components boolean добавлено в dellemc.powerflex 2.3.0 | Включить сущности программных компонентов. Применимо, когда gather_subset равно Варианты:
|
include_devices boolean | Включить устройства в ответ. Применимо, когда gather_subset равно Варианты:
|
boolean добавлено в dellemc.powerflex 2.3.0 | Включить связанные сущности. Применимо, когда gather_subset равно Варианты:
|
include_template boolean | Включить шаблоны сервисов в ответ. Применимо, когда gather_subset равно Варианты:
|
limit integer | Лимит страницы. Поддерживается для ключей gather_subset Значение по умолчанию: |
offset integer | Смещение постраничной навигации. Поддерживается для ключей gather_subset Значение по умолчанию: |
пароль строка / обязательно | Пароль хоста PowerFlex. |
порт целое число | Номер порта, через который происходит общение с хостом PowerFlex. По умолчанию: |
сортировка строка | Отсортировать возвращаемые компоненты по указанному полю. Поддерживается для ключей gather_subset Поддерживаемые ключи сортировки для gather_subset можно найти в документации API PowerFlex Manager по адресу https://developer.dell.com. |
таймаут целое число | Время, по истечении которого произойдёт разрыв соединения. Указывается в секундах. По умолчанию: |
имя пользователя строка / обязательно | Имя пользователя хоста PowerFlex. |
проверка_сертификата алиасы: verifycert булево | Булевое значение, определяющее, нужно ли проверять SSL-сертификат.
Варианты:
|
Примечания
Примечание
- Поддерживается check_mode.
- Поддерживаемые ключи фильтрации для gather_subset можно найти в документации API PowerFlex Manager по адресу https://developer.dell.com.
- Опции filter, sort, limit и offset игнорируются, когда задано несколько gather_subset вместе с
service_template,managed_device,deploymentилиfirmware_repository. - Модули, присутствующие в коллекции с именем «dellemc.powerflex», разработаны для поддержки платформы хранения Dell PowerFlex.
Примеры
- name: Get detailed list of PowerFlex entities
dellemc.powerflex.info:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
gather_subset:
- vol
- storage_pool
- protection_domain
- sdc
- sds
- snapshot_policy
- device
- rcg
- replication_pair
- fault_set
- name: Get a subset list of PowerFlex volumes
dellemc.powerflex.info:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
gather_subset:
- vol
filters:
- filter_key: "name"
filter_operator: "equal"
filter_value: "ansible_test"
- name: Get deployment and resource provisioning info
dellemc.powerflex.info:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
gather_subset:
- managed_device
- deployment
- service_template
- name: Get deployment with filter, sort, pagination
dellemc.powerflex.info:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
gather_subset:
- deployment
filters:
- filter_key: "name"
filter_operator: "contains"
filter_value: "partial"
sort: name
limit: 10
offset: 10
include_devices: true
include_template: true
- name: Get the list of firmware repository.
dellemc.powerflex.info:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
gather_subset:
- firmware_repository
- name: Get the list of firmware repository
dellemc.powerflex.info:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
gather_subset:
- firmware_repository
include_related: true
include_bundles: true
include_components: true
- name: Get the list of firmware repository with filter
dellemc.powerflex.info:
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
validate_certs: "{{ validate_certs }}"
gather_subset:
- firmware_repository
filters:
- filter_key: "createdBy"
filter_operator: "equal"
filter_value: "admin"
sort: createdDate
limit: 10
include_related: true
include_bundles: true
include_components: true
register: result_repository_out
- name: Get the list of available firmware repository
ansible.builtin.debug:
msg: "{{ result_repository_out.FirmwareRepository | selectattr('state', 'equalto', 'available') }}"
- name: Get the list of software components in the firmware repository
ansible.builtin.debug:
msg: "{{ result_repository_out.FirmwareRepository |
selectattr('id', 'equalto', '8aaa80788b7') | map(attribute='softwareComponents') | flatten }}"
- name: Get the list of software bundles in the firmware repository
ansible.builtin.debug:
msg: "{{ result_repository_out.FirmwareRepository |
selectattr('id', 'equalto', '8aaa80788b7') | map(attribute='softwareBundles') | flatten }}"
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
Ключ | Описание |
|---|---|
API_Version string | Версия API шлюза PowerFlex API. Возвращается: всегда Пример: |
Array_Details dictionary | Системные сущности массива хранения PowerFlex. Возвращается: всегда Пример: |
|
addressSpaceUsage string |
Использование адресного пространства. Возвращается: успех |
|
authenticationMethod string |
Метод аутентификации. Возвращается: успех |
|
capacityAlertCriticalThresholdPercent integer |
Процент критического порога предупреждения о емкости. Возвращается: успех |
|
capacityAlertHighThresholdPercent integer |
Процент высокого порога предупреждения о емкости. Возвращается: успех |
|
capacityTimeLeftInDays string |
Остаток времени до заполнения емкости в днях. Возвращается: успех |
|
cliPasswordAllowed boolean |
Разрешен пароль CLI. Возвращается: успех |
|
daysInstalled integer |
Дней с момента установки. Возвращается: успех |
|
defragmentationEnabled boolean |
Включена дефрагментация. Возвращается: успех |
|
enterpriseFeaturesEnabled boolean |
Включены функции предприятия. Возвращается: успех |
|
id string |
Идентификатор системы. Возвращается: успех |
|
installId string |
Идентификатор установки. Возвращается: успех |
|
isInitialLicense boolean |
Начальная лицензия. Возвращается: успех |
|
lastUpgradeTime integer |
Время последнего обновления. Возвращается: успех |
|
managementClientSecureCommunicationEnabled boolean |
Включено безопасное соединение клиента управления. Возвращается: успех |
|
maxCapacityInGb dictionary |
Максимальная емкость в ГБ. Возвращается: успех |
|
mdmCluster dictionary |
Подробная информация о кластере MDM. Возвращается: успех |
|
mdmExternalPort integer |
Внешний порт MDM. Возвращается: успех |
|
mdmManagementPort integer |
Порт управления MDM. Возвращается: успех |
|
mdmSecurityPolicy string |
Политика безопасности MDM. Возвращается: успех |
|
showGuid boolean |
Показать GUID. Возвращается: успех |
|
swid string |
ИД устройства. Возвращаемое значение: success |
|
systemVersionName string |
Версия и название системы. Возвращаемое значение: success |
|
tlsVersion string |
Версия TLS. Возвращаемое значение: success |
|
upgradeState string |
Состояние обновления. Возвращаемое значение: success |
changed boolean | Изменились ли ресурсы. Возвращаемое значение: всегда Пример: |
Deployments list / elements=string | Подробности всех развертываний. Возвращаемое значение: если gather_subset равно deployment Пример: |
|
deploymentName string |
Название развертывания. Возвращаемое значение: success |
|
firmwareRepository dictionary |
Репозиторий прошивки. Возвращаемое значение: success |
|
downloadStatus string |
Статус загрузки. Возвращаемое значение: success |
|
rcmapproved boolean |
Если одобрено RCM. Возвращаемое значение: success |
|
signature string |
Детали подписи. Возвращаемое значение: success |
|
id string |
Идентификатор развертывания. Возвращаемое значение: success |
|
status string |
Статус развертывания. Возвращаемое значение: success |
Devices list / elements=string | Подробности устройств. Возвращаемое значение: всегда Пример: |
|
id string |
Идентификатор устройства. Возвращаемое значение: success |
|
name string |
Название устройства. Возвращаемое значение: success |
Fault_Sets list / elements=string | Подробности наборов ошибок. Возвращаемое значение: всегда Пример: |
|
id string |
Идентификатор устройства. Возвращаемое значение: success |
|
name string |
Название устройства. Возвращаемое значение: success |
|
protectionDomainId string |
Идентификатор области защиты. Возвращаемое значение: success |
FirmwareRepository list / elements=string | Подробности всех репозиториев прошивки. Возвращаемое значение: если gather_subset равно Пример: |
|
deployments list / elements=string |
Развертывания репозитория прошивки. Возвращено: success |
|
id string |
Идентификатор репозитория прошивки. Возвращено: success |
|
name string |
Имя репозитория прошивки. Возвращено: success |
|
softwareBundles list / elements=string |
Наборы программного обеспечения репозитория прошивки. Возвращено: success |
|
softwareComponents list / elements=string |
Компоненты программного обеспечения репозитория прошивки. Возвращено: success |
|
sourceLocation string |
Местоположение источника репозитория прошивки. Возвращено: success |
|
state string |
Состояние репозитория прошивки. Возвращено: success |
ManagedDevices list / elements=string | Подробная информация обо всех устройствах из инвентаря. Возвращено: когда gather_subset равно managed_device Пример: |
|
compliance string |
Состояние соответствия устройства. Возвращено: success |
|
deviceType string |
Тип устройства. Возвращено: success |
|
managedState string |
Управляемое состояние устройства. Возвращено: success |
|
serverTemplateId string |
Идентификатор шаблона сервера. Возвращено: success |
|
serviceTag string |
Сервисный тег. Возвращено: success |
|
state string |
Состояние устройства. Возвращено: success |
|
systemId string |
Системный идентификатор. Возвращено: success |
Protection_Domains list / elements=string | Подробная информация обо всех доменах защиты. Возвращено: всегда Пример: |
|
id string |
Идентификатор домена защиты. Возвращено: success |
|
name string |
Имя домена защиты. Возвращено: success |
Replication_Consistency_Groups list / elements=string | Подробная информация о rcg. Возвращено: всегда Пример: |
|
abstractState string |
Абстрактное состояние группы согласованности репликации. Возвращено: success |
|
activeLocal boolean |
Является ли активной локальная группа согласованности репликации. Возвращено: success |
|
activeRemote boolean |
Активна ли удаленная группа согласованности репликации Returned: success |
|
currConsistMode string |
Текущий режим согласованности группы согласованности репликации. Returned: success |
|
disasterRecoveryState string |
Состояние аварийного восстановления локальной группы согласованности репликации. Returned: success |
|
error integer |
Код ошибки группы согласованности репликации. Returned: success |
|
failoverState string |
Состояние отработки отказа группы согласованности репликации. Returned: success |
|
failoverType string |
Тип отработки отказа группы согласованности репликации. Returned: success |
|
freezeState string |
Состояние заморозки группы согласованности репликации. Returned: success |
|
id string |
ID группы согласованности репликации. Returned: success |
|
inactiveReason integer |
Причина неактивности группы согласованности репликации. Returned: success |
|
lastSnapCreationRc integer |
Код возврата последнего снимка группы согласованности репликации. Returned: success |
|
lastSnapGroupId string |
ID последнего снимка группы согласованности репликации. Returned: success |
|
lifetimeState string |
Состояние времени жизни группы согласованности репликации. Returned: success |
|
localActivityState string |
Состояние активности локальной группы согласованности репликации. Returned: success |
|
name string |
Имя группы согласованности репликации. Returned: success |
|
pauseMode string |
Состояние времени жизни группы согласованности репликации. Returned: success |
|
peerMdmId string |
ID сопоставленного MDM группы согласованности репликации. Returned: success |
|
protectionDomainId string |
ID домена защиты группы согласованности репликации. Returned: success |
|
remoteActivityState string |
Состояние активности удаленной группы согласованности репликации. Returned: success |
|
remoteDisasterRecoveryState string |
Состояние аварийного восстановления удаленной группы согласованности репликации. Returned: success |
|
remoteId string |
ID удаленной группы согласованности репликации. Returned: success |
|
remoteMdmId string |
ID удаленного MDM группы согласованности репликации. Returned: success |
|
remoteProtectionDomainId string |
Идентификатор удалённого домена защиты. Возвращено: success |
|
remoteProtectionDomainName string |
Имя удалённого домена защиты. Возвращено: success |
|
replicationDirection string |
Направление репликации группы согласованности репликации. Возвращено: success |
|
rpoInSeconds integer |
Значение RPO группы согласованности репликации в секундах. Возвращено: success |
|
snapCreationInProgress boolean |
Выполняется ли в данный момент процесс создания снимка группы согласованности репликации. Возвращено: success |
|
targetVolumeAccessMode string |
Режим доступа к целевому тому группы согласованности репликации. Возвращено: success |
|
type string |
Тип группы согласованности репликации. Возвращено: success |
Replication_pairs list / elements=string | Подробная информация о парах репликации. Возвращено: Always Пример: |
|
copyType string |
Тип копии пары репликации. Возвращено: success |
|
id string |
Идентификатор пары репликации. Возвращено: success |
|
initialCopyState string |
Начальное состояние копии пары репликации. Возвращено: success |
|
localActivityState string |
Состояние активности локальной пары репликации. Возвращено: success |
|
localVolumeId string |
Идентификатор локального тома. Возвращено: success |
|
name string |
Имя пары репликации. Возвращено: success |
|
remoteActivityState string |
Состояние активности удалённой пары репликации. Возвращено: success |
|
remoteId string |
Идентификатор удалённой пары репликации. Возвращено: success |
|
replicationConsistencyGroupId string |
Идентификатор группы согласованности репликации. Возвращено: success |
SDCs list / elements=string | Подробная информация о клиентах данных хранения. Возвращено: always Пример: |
|
id string |
Идентификатор клиента данных хранения. Возвращено: success |
|
name string |
Имя клиента данных хранения. Возвращено: success |
SDSs list / elements=string | Подробная информация о серверах данных хранения. Возвращено: always Пример: |
|
id string |
идентификатор сервера хранения данных. Возвращается при: успехе |
|
name string |
имя сервера хранения данных. Возвращается при: успехе |
ServiceTemplates list / elements=string | Подробности всех шаблонов сервисов. Возвращается при: когда gather_subset равен service_template Пример: |
|
category string |
Категория шаблона. Возвращается при: успехе |
|
serverCount integer |
Количество серверов. Возвращается при: успехе |
|
templateDescription string |
Описание шаблона. Возвращается при: успехе |
|
templateName string |
Имя шаблона. Возвращается при: успехе |
|
templateType string |
Тип шаблона. Возвращается при: успехе |
|
templateVersion string |
Версия шаблона. Возвращается при: успехе |
Snapshot_Policies list / elements=string | Подробности политик создания моментальных снимков. Возвращается при: всегда Пример: |
|
id string |
идентификатор политики моментальных снимков. Возвращается при: успехе |
|
name string |
название политики моментальных снимков. Возвращается при: успехе |
Storage_Pools list / elements=string | Подробности хранилищ данных. Возвращается при: всегда Пример: |
|
id string |
Идентификатор хранилища данных в области защиты. Возвращается при: успехе |
|
mediaType string |
Тип устройств в хранилище данных. Возвращается при: успехе |
|
name string |
Имя хранилища данных в области защиты. Возвращается при: успехе |
|
protectionDomainId string |
Идентификатор области защиты, в которой находится хранилище. Возвращается при: успехе |
|
protectionDomainName string |
Имя области защиты, в которой находится хранилище. Возвращается при: успехе |
|
statistics dictionary |
Подробности статистики хранилища данных. Возвращается при: успехе |
|
capacityInUseInKb string |
Общий объем хранилища. Возвращается при: успехе |
|
deviceIds list / elements=string |
Идентификаторы устройств в хранилище данных. Возвращается при: успехе |
|
unusedCapacityInKb string |
Неиспользуемый объем хранилища. Возвращается при: успехе |
|
useRfcache boolean |
Включить/выключить RFcache на определённом пуле хранения. Возвращено: success |
|
useRmcache boolean |
Включить/выключить RMcache на определённом пуле хранения. Возвращено: success |
Volumes list / elements=string | Подробная информация о томах. Возвращено: всегда Пример: |
|
id string |
Идентификатор тома. Возвращено: success |
|
mappedSdcInfo dictionary |
Подробная информация о сопоставленном SDC. Возвращено: success |
|
accessMode string |
Режим доступа к сопоставлению для указанного тома. Возвращено: success |
|
limitBwInMbps integer |
Лимит пропускной способности для SDC. Возвращено: success |
|
limitIops integer |
Лимит IOPS для SDC. Возвращено: success |
|
sdcId string |
Идентификатор SDC. Возвращено: success |
|
sdcIp string |
IP-адрес SDC. Возвращено: success |
|
sdcName string |
Имя SDC. Возвращено: success |
|
name string |
Имя тома. Возвращено: success |
|
protectionDomainId string |
Идентификатор домена защиты, в котором находится том. Возвращено: success |
|
protectionDomainName string |
Имя домена защиты, в котором находится том. Возвращено: success |
|
sizeInGb integer |
Размер тома в Гб. Возвращено: success |
|
sizeInKb integer |
Размер тома в Кб. Возвращено: success |
|
snapshotPolicyId string |
Идентификатор политики снимков, связанной с томом. Возвращено: success |
|
snapshotPolicyName string |
Имя политики снимков, связанной с томом. Возвращено: success |
|
snapshotsList string |
Список снимков, связанных с томом. Возвращено: success |
|
statistics dictionary |
Статистические данные пула хранения. Возвращено: success |
|
numOfChildVolumes integer |
Количество дочерних томов. Возвращено: success |
|
numOfMappedSdcs integer |
Количество сопоставленных SDC тома. Возвращено: success |
|
storagePoolId string |
Идентификатор хранилища пула, в котором находится том. Возвращается: success |
|
storagePoolName string |
Имя хранилища пула, в котором находится том. Возвращается: success |
Ссылки на сборку
© 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/info_module.html