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[0].serial_number
Возвращаемые данные
Возвращаемые данным модулем данные добавляются/обновляются в hostvars фактах хоста и могут быть использованы по имени, как и любые другие факты хоста. Для их использования не требуется регистрация.
| Fact | Returned | Description | |||
|---|---|---|---|---|---|
| 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 | |||
| type string | всегда | Тип конкретного раздела. Пример: IFS | |||
| volumes list | если существуют | Подробная информация об одном конкретном томе в указанном разделе. | |||
| allocation_unit_size целое число | всегда | Размер блока выделения в байтах данного тома. Пример: 4096 | |||
| drive_type строка | всегда | Тип диска данного тома. Пример: Fixed | |||
| health_status строка | всегда | Состояние здоровья данного тома. Пример: Healthy | |||
| label строка | всегда | Метка файловой системы данного тома. Пример: System Reserved | |||
| object_id строка | всегда | Объектный идентификатор данного тома. Пример: \\?\Volume{85bdc4a9-f8eb-11e6-80fa-806e6f6e6963}\ | |||
| path строка | всегда | Путь к данному тому. Пример: \\?\Volume{85bdc4a9-f8eb-11e6-80fa-806e6f6e6963}\ | |||
| size целое число | всегда | Размер данного тома в байтах. Пример: 838856704 | |||
| size_remaining целое число | всегда | Остаточный размер данного тома в байтах. Пример: 395620352 | |||
| type строка | всегда | Тип файловой системы данного тома. Пример: NTFS | |||
| path строка | всегда | Путь к данному диску на целевом устройстве. Пример: \\?\scsi#disk&ven_red_hat&prod_virtio#4&23208fd0&1&000000#{<id>} | |||
| physical_disk сложное | если существует | Подробная информация о свойствах физического диска. | |||
| allocated_size целое число | всегда | Выделенный размер физического диска в байтах. Пример: 240057409536 | |||
| bus_type строка | всегда | Тип шины данного физического диска. Пример: SCSI | |||
| can_pool булево | всегда | Указание, можно ли добавить данный физический диск в пул хранилища. | |||
| cannot_pool_reason строка | если свойство can_pool имеет значение false | Причина, по которой данный физический диск нельзя добавить в пул хранилища. Пример: Недостаточно емкости | |||
| device_id строка | всегда | Идентификатор устройства данного физического диска. Пример: 0 | |||
| friendly_name строка | всегда | Наименование данного физического диска. Пример: PhysicalDisk0 | |||
| health_status строка | всегда | Состояние здоровья данного физического диска. Пример: Healthy | |||
| indication_enabled булево | всегда | Указание, включена ли индикация для данного физического диска. Пример: True | |||
| manufacturer строка | всегда | Производитель данного физического диска. Пример: SUSE | |||
| media_type строка | всегда | Тип носителя данного физического диска. Пример: UnSpecified | |||
| model строка | всегда | Модель данного физического диска. Пример: Xen Block | |||
| object_id строка | всегда | Объектный идентификатор данного физического диска. Пример: {1}\\\\HOST\\root/Microsoft/Windows/Storage/Providers_v2\\SPACES_PhysicalDisk.ObjectId=\"{<object_id>}:PD:{<pd>}\" | |||
| operational_status строка | всегда | Рабочее состояние данного физического диска. Пример: OK | |||
| partial булево | всегда | Указание, является ли данный физический диск частичным. | |||
| physical_location строка | всегда | Физическое расположение данного физического диска. Пример: Встроенный : Адаптер 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 | Список поддерживаемых типов использования. Пример: Автоматический выбор, Активный резерв | |||
| 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 | |||
| groups integer | always | Количество групп конкретного виртуального диска. Пример: 1 | |||
| health_status string | always | Состояние здоровья конкретного виртуального диска. Пример: Здоровый | |||
| inter_leave целое число | всегда | Интерливинг в байтах конкретного виртуального диска. Пример: 102400 | |||
| logical_sector_size целое число | всегда | Логический размер сектора в байтах конкретного виртуального диска. Пример: 512 | |||
| manual_attach логическое значение | всегда | Информация о том, прикреплен ли конкретный виртуальный диск вручную. Пример: True | |||
| media_type строка | всегда | Тип носителя конкретного виртуального диска. Пример: Unspecified | |||
| name строка | всегда | Имя конкретного виртуального диска. Пример: vDisk1 | |||
| object_id строка | всегда | Объектный идентификатор конкретного виртуального диска. Пример: {1}\\\\HOST\\root/Microsoft/Windows/Storage/Providers_v2\\SPACES_VirtualDisk.ObjectId=\"{<object_id>}:VD:{<vd>}\" | |||
| operational_status строка | всегда | Рабочее состояние конкретного виртуального диска. Пример: OK | |||
| parity_layout целое число | если существует | Схема расположения четности конкретного виртуального диска. Пример: 1 | |||
| physical_disk_redundancy целое число | всегда | Тип избыточности физического диска конкретного виртуального диска. Пример: 1 | |||
| physical_sector_size целое число | всегда | Размер физического сектора в байтах конкретного виртуального диска. Пример: 4096 | |||
| provisioning_type строка | всегда | Тип выделения памяти конкретного виртуального диска. Пример: Thin | |||
| read_cache_size целое число | всегда | Размер кэша чтения в байтах конкретного виртуального диска. | |||
| request_no_spof логическое значение | всегда | Информация о том, запрашивает ли конкретный виртуальный диск отсутствие единой точки отказа. Пример: True | |||
| resiliency_setting_name целое число | всегда | Тип избыточности физического диска конкретного виртуального диска. Пример: 1 | |||
| size целое число | всегда | Размер в байтах конкретного виртуального диска. Пример: 240057409536 | |||
| snapshot логическое значение | всегда | Информация о том, является ли конкретный виртуальный диск снимком. | |||
| tiered логическое значение | всегда | Информация о том, является ли конкретный виртуальный диск тиражированным. Пример: True | |||
| unique_id строка | всегда | Уникальный идентификатор конкретного виртуального диска. Пример: 260542E4C6B01D47A8FA7630FD90FFDE | |||
| unique_id_format строка | всегда | Формат уникального идентификатора конкретного виртуального диска. Пример: Vendor Specific | |||
| write_cache_size целое число | всегда | Размер кэша записи в байтах конкретного виртуального диска. Пример: 100 | |||
Состояние
- Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.8/modules/win_disk_facts_module.html