win_disk_facts – Отображение подключенных дисков и информации о дисках целевого хоста
Новое в версии 2.5.
Описание
- Модуль позволяет извлекать и выводить подробную информацию о подключенных дисках целевого хоста, а также о его томах и разделах, если они существуют.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- Windows 8.1 / Windows 2012 (NT 6.2)
Примечания
Примечание
- Для понимания всех возвращаемых свойств и значений посетите следующий сайт и откройте соответствующий класс MSFT https://msdn.microsoft.com/en-us/library/windows/desktop/hh830612.aspx
Примеры
- name: Get disk facts
win_disk_facts:
- name: Output first disk size
debug:
var: ansible_facts.disks[0].size
- name: Convert first system disk into various formats
debug:
msg: '{{ disksize_gib }} vs {{ disksize_gib_human }}'
vars:
# Get first system disk
disk: '{{ ansible_facts.disks|selectattr("system_disk")|first }}'
# Show disk size in Gibibytes
disksize_gib_human: '{{ disk.size|filesizeformat(true) }}' # returns "223.6 GiB" (human readable)
disksize_gib: '{{ (disk.size/1024|pow(3))|round|int }} GiB' # returns "224 GiB" (value in GiB)
# Show disk size in Gigabytes
disksize_gb_human: '{{ disk.size|filesizeformat }}' # returns "240.1 GB" (human readable)
disksize_gb: '{{ (disk.size/1000|pow(3))|round|int }} GB' # returns "240 GB" (value in GB)
- name: Output second disk serial number
debug:
var: ansible_facts.disks[1].serial_number
Возвращаемые данные
Возвращаемые данным модулем данные добавляются/обновляются в hostvars фактах хоста и могут быть использованы по имени, как и любые другие факты хоста. Для их использования не требуется регистрация.
| Fact | Returned | Описание | |||
|---|---|---|---|---|---|
| ansible_disks list | если диски были найдены | Подробная информация об одном конкретном диске. | |||
| bootable boolean | всегда | Информация о том, является ли конкретный диск загрузочным диском. | |||
| bus_type string | всегда | Тип шины конкретного диска. Пример: SCSI | |||
| clustered boolean | всегда | Информация о том, является ли конкретный диск кластеризованным (частью кластера отказоустойчивости). | |||
| firmware_version string | всегда | Версия микропрограммы конкретного диска. Пример: 0001 | |||
| friendly_name string | всегда | Понятное имя конкретного диска. Пример: Red Hat VirtIO SCSI Disk Device | |||
| guid string | если существует | GUID конкретного диска на целевом устройстве. Пример: {efa5f928-57b9-47fc-ae3e-902e85fbe77f} | |||
| location string | всегда | Расположение конкретного диска на целевом устройстве. Пример: PCIROOT(0)#PC0400#SCSP00T00L00
| |||
| manufacturer string | всегда | Производитель конкретного диска. Пример: Red Hat | |||
| model string | всегда | Модель конкретного диска. Пример: VirtIO | |||
| number integer | всегда | Номер конкретного диска. | |||
| operational_status string | всегда | Оперативное состояние конкретного диска. Пример: Online | |||
| partition_count integer | всегда | Количество разделов на конкретном диске. Пример: 4 | |||
| partition_style string | всегда | Стиль разбиения конкретного диска. Пример: MBR | |||
| partitions list | если существуют | Подробная информация об одном конкретном разделе на указанном диске. | |||
| access_paths string | если существуют | Пути доступа к конкретному разделу. Пример: \\?\Volume{85bdc4a8-f8eb-11e6-80fa-806e6f6e6963}\ | |||
| active boolean | если свойство partition_style конкретного диска имеет значение "MBR" | Информация о том, является ли конкретный раздел активным разделом или нет. Пример: True | |||
| drive_letter string | если существует | Буквенное обозначение диска конкретного раздела. Пример: C | |||
| gpt_type string | если свойство partition_style конкретного диска имеет значение "GPT" | Тип GPT конкретного раздела. Пример: {e3c9e316-0b5c-4db8-817d-f92df00215ae} | |||
| guid string | если существует | GUID конкретного раздела. Пример: {302e475c-6e64-4674-a8e2-2f1c7018bf97} | |||
| hidden boolean | всегда | Информация о том, скрыт ли конкретный раздел или нет. Пример: True | |||
| mbr_type integer | если свойство partition_style конкретного диска имеет значение "MBR" | Тип MBR конкретного раздела. Пример: 7 | |||
| no_default_driveletter boolean | если свойство partition_style конкретного диска имеет значение "GPT" | Информация о том, имеет ли конкретный раздел буквенное обозначение по умолчанию или нет. Пример: True | |||
| number integer | всегда | Номер конкретного раздела. Пример: 1 | |||
| offset integer | всегда | Смещение конкретного раздела. Пример: 368050176 | |||
| shadow_copy boolean | всегда | Информация о том, является ли конкретный раздел тенью другого раздела. | |||
| size integer | всегда | Размер в байтах конкретного раздела. Пример: 838860800 | |||
| transition_state integer | всегда | Состояние перехода конкретного раздела. Пример: 1 | |||
| тип строка | всегда | Тип конкретного раздела. Пример: IFS | |||
| тома список | при наличии | Подробная информация об одном конкретном томе на указанном разделе. | |||
| размер_блока_выделения целое число | всегда | Размер блока выделения в байтах для конкретного тома. Пример: 4096 | |||
| тип_диска строка | всегда | Тип диска для конкретного тома. Пример: Фиксированный | |||
| состояние_здоровья строка | всегда | Состояние здоровья конкретного тома. Пример: Здоровый | |||
| метка строка | всегда | Метка файловой системы для конкретного тома. Пример: Системное резервное копирование | |||
| идентификатор_объекта строка | всегда | Идентификатор объекта конкретного тома. Пример: \\?\Volume{85bdc4a9-f8eb-11e6-80fa-806e6f6e6963}\ | |||
| путь строка | всегда | Путь к конкретному тому. Пример: \\?\Volume{85bdc4a9-f8eb-11e6-80fa-806e6f6e6963}\ | |||
| размер целое число | всегда | Размер в байтах конкретного тома. Пример: 838856704 | |||
| остаток_размера целое число | всегда | Остаток размера в байтах для конкретного тома. Пример: 395620352 | |||
| тип строка | всегда | Тип файловой системы конкретного тома. Пример: NTFS | |||
| путь строка | всегда | Путь к конкретному диску на целевом устройстве. Пример: \\?\scsi#disk&ven_red_hat&prod_virtio#4&23208fd0&1&000000#{<id>} | |||
| физический_диск сложный | при наличии | Подробная информация о свойствах физического диска конкретного диска. | |||
| выделенный_размер целое число | всегда | Выделенный размер в байтах для конкретного физического диска. Пример: 240057409536 | |||
| тип_шины строка | всегда | Тип шины для конкретного физического диска. Пример: SCSI | |||
| можно_в_пуле булево | всегда | Информация о возможности добавления конкретного физического диска в пул хранилища. | |||
| причина_невозможности_в_пуле строка | если свойство можно_в_пуле имеет значение ложь | Информация о причинах невозможности добавления конкретного физического диска в пул хранилища. Пример: Недостаточная емкость | |||
| идентификатор_устройства строка | всегда | Идентификатор устройства для конкретного физического диска. Пример: 0 | |||
| дружественное_имя строка | всегда | Дружественное имя конкретного физического диска. Пример: PhysicalDisk0 | |||
| состояние_здоровья строка | всегда | Состояние здоровья конкретного физического диска. Пример: Здоровый | |||
| индикация_включена булево | всегда | Информация о том, включена ли индикация для конкретного физического диска. Пример: Истина | |||
| производитель строка | всегда | Производитель конкретного физического диска. Пример: SUSE | |||
| тип_носителя строка | всегда | Тип носителя для конкретного физического диска. Пример: Неопределённый | |||
| модель строка | всегда | Модель конкретного физического диска. Пример: Xen Block | |||
| идентификатор_объекта строка | всегда | Идентификатор объекта конкретного физического диска. Пример: {1}\\\\HOST\\root/Microsoft/Windows/Storage/Providers_v2\\SPACES_PhysicalDisk.ObjectId=\"{<object_id>}:PD:{<pd>}\" | |||
| operational_status string | always | Операционный статус конкретного физического диска. Пример: OK | |||
| partial boolean | always | Информация о том, является ли конкретный физический диск частичным. | |||
| physical_location string | always | Физическое расположение конкретного физического диска. Пример: Встроенный : Адаптер 3 : Порт 0 : Цель 0 : LUN 0 | |||
| serial_number string | always | Серийный номер конкретного физического диска. Пример: b62beac80c3645e5877f | |||
| size integer | always | Размер в байтах конкретного физического диска. Пример: 240057409536 | |||
| spindle_speed integer | always | Скорость вращения шпинделя в об/мин конкретного физического диска. Пример: 4294967295 | |||
| supported_usages complex | always | Поддерживаемые типы использования конкретного физического диска. | |||
| Count integer | always | Количество поддерживаемых типов использования. Пример: 5 | |||
| value string | always | Список поддерживаемых типов использования. Пример: Автовыбор, Резервный диск (Hot Spare) | |||
| unique_id string | always | Уникальный идентификатор конкретного физического диска. Пример: 3141463431303031 | |||
| usage_type string | always | Тип использования конкретного физического диска. Пример: Автовыбор | |||
| read_only boolean | always | Статус только для чтения для конкретного диска. Пример: True | |||
| sector_size integer | always | Размер сектора в байтах для конкретного диска. Пример: 4096 | |||
| serial_number string | always | Серийный номер конкретного диска на целевом устройстве. Пример: b62beac80c3645e5877f | |||
| size integer | always | Размер в байтах конкретного диска. Пример: 227727638528 | |||
| system_disk boolean | always | Информация о том, является ли конкретный диск системным диском. Пример: True | |||
| unique_id string | always | Уникальный идентификатор конкретного диска на целевом устройстве. Пример: 3141463431303031 | |||
| virtual_disk complex | если существует | Подробная информация о свойствах виртуального диска для конкретного диска. | |||
| access string | always | Доступ к конкретному виртуальному диску. Пример: Чтение/Запись | |||
| allocated_size integer | always | Размер выделенного места в байтах конкретного виртуального диска. Пример: 240057409536 | |||
| allocation_unit_size integer | always | Размер блока выделения в байтах конкретного виртуального диска. Пример: 4096 | |||
| available_copies integer | если существует | Количество доступных копий конкретного виртуального диска. Пример: 1 | |||
| columns integer | always | Количество столбцов конкретного виртуального диска. Пример: 2 | |||
| deduplication_enabled boolean | always | Информация о том, включена ли дедупликация для конкретного виртуального диска. Пример: True | |||
| detached_reason string | always | Причина отсоединения конкретного виртуального диска. Пример: Нет | |||
| enclosure_aware boolean | always | Информация о том, осознает ли конкретный виртуальный диск оболочку. | |||
| fault_domain_awareness string | always | Осознание областью отказов конкретного виртуального диска. Пример: PhysicalDisk | |||
| footprint_on_pool integer | always | Размер отпечатка на пуле в байтах для конкретного виртуального диска. Пример: 240057409536 | |||
| friendly_name string | always | Наименование конкретного виртуального диска для удобства. Пример: Prod2 Virtual Disk | |||
| groups integer | always | Количество групп конкретного виртуального диска. Пример: 1 | |||
| health_status string | always | Состояние здоровья конкретного виртуального диска. Пример: Healthy | |||
| inter_leave integer | always | Интерливинг в байтах для конкретного виртуального диска. Пример: 102400 | |||
| logical_sector_size integer | always | Размер логического сектора в байтах для конкретного виртуального диска. Пример: 512 | |||
| manual_attach boolean | always | Информация о том, прикреплен ли конкретный виртуальный диск вручную. Пример: True | |||
| media_type string | always | Тип носителя конкретного виртуального диска. Пример: Неопределённый | |||
| name string | always | Имя конкретного виртуального диска. Пример: vDisk1 | |||
| object_id string | always | Идентификатор объекта конкретного виртуального диска. Пример: {1}\\\\HOST\\root/Microsoft/Windows/Storage/Providers_v2\\SPACES_VirtualDisk.ObjectId=\"{<object_id>}:VD:{<vd>}\" | |||
| operational_status string | always | Рабочее состояние конкретного виртуального диска. Пример: OK | |||
| parity_layout integer | если существует | Схема чётности конкретного виртуального диска. Пример: 1 | |||
| physical_disk_redundancy integer | always | Тип избыточности физического диска для конкретного виртуального диска. Пример: 1 | |||
| physical_sector_size integer | always | Размер физического сектора в байтах для конкретного виртуального диска. Пример: 4096 | |||
| provisioning_type string | always | Тип выделения ресурсов для конкретного виртуального диска. Пример: Толстый | |||
| read_cache_size integer | always | Размер кэша чтения в байтах для конкретного виртуального диска. | |||
| request_no_spof boolean | always | Информация о том, запрашивает ли конкретный виртуальный диск отсутствие единственной точки отказа. Пример: True | |||
| resiliency_setting_name integer | always | Тип избыточности физического диска для конкретного виртуального диска. Пример: 1 | |||
| size integer | always | Размер в байтах конкретного виртуального диска. Пример: 240057409536 | |||
| snapshot boolean | always | Информация о том, является ли конкретный виртуальный диск снимком. | |||
| tiered boolean | always | Информация о том, является ли конкретный виртуальный диск иерархическим. Пример: True | |||
| unique_id string | always | Уникальный идентификатор конкретного виртуального диска. Пример: 260542E4C6B01D47A8FA7630FD90FFDE | |||
| unique_id_format string | always | Формат уникального идентификатора конкретного виртуального диска. Пример: Специфичный для вендора | |||
| write_cache_size integer | always | Размер кэша записи в байтах для конкретного виртуального диска. Пример: 100 | |||
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [предварительная версия]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Marc Tschapek (@marqelme)
Подсказка
Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/win_disk_facts_module.html