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 | if disks were found | Подробная информация об одном конкретном диске. | |||
| bus_type string | always | Тип шины конкретного диска. Пример: SCSI | |||
| physical_disk complex | if existent | Подробная информация о свойствах физического диска конкретного диска. | |||
| bus_type string | always | Тип шины конкретного физического диска. Пример: SCSI | |||
| operational_status string | always | Операционный статус конкретного физического диска. Пример: OK | |||
| partial bool | always | Информация о том, является ли конкретный физический диск частичным. | |||
| cannot_pool_reason string | if can_pool property has value false | Информация о том, почему конкретный физический диск не может быть добавлен в пул хранения. Пример: Недостаточная ёмкость | |||
| media_type string | always | Тип носителя конкретного физического диска. Пример: Неопределён | |||
| supported_usages complex | always | Поддерживаемые типы использования конкретного физического диска. | |||
| Count int | always | Количество поддерживаемых типов использования. Пример: 5 | |||
| value string | always | Список поддерживаемых типов использования. Пример: Автовыбор, Резервный | |||
| usage_type string | always | Тип использования конкретного физического диска. Пример: Автовыбор | |||
| size int | always | Размер в байтах конкретного физического диска. Пример: 240057409536 | |||
| can_pool bool | always | Информация о том, может ли конкретный физический диск быть добавлен в пул хранения. | |||
| allocated_size int | always | Назначенный размер в байтах конкретного физического диска. Пример: 240057409536 | |||
| friendly_name string | always | Дружественное имя конкретного физического диска. Пример: PhysicalDisk0 | |||
| object_id string | always | Объектный идентификатор конкретного физического диска. Пример: {1}\\\\HOST\\root/Microsoft/Windows/Storage/Providers_v2\\SPACES_PhysicalDisk.ObjectId=\"{<object_id>}:PD:{<pd>}\" | |||
| health_status string | always | Статус работоспособности конкретного физического диска. Пример: Здоровый | |||
| indication_enabled bool | always | Информация о том, включена ли индикация для конкретного физического диска. Пример: True | |||
| physical_location string | always | Физическое расположение конкретного физического диска. Пример: Встроенный : Адаптер 3 : Порт 0 : Цель 0 : LUN 0 | |||
| serial_number string | always | Серийный номер конкретного физического диска. Пример: b62beac80c3645e5877f | |||
| model string | always | Модель конкретного физического диска. Пример: Xen Block | |||
| manufacturer string | always | Производитель конкретного физического диска. Пример: SUSE | |||
| spindle_speed int | always | Скорость вращения шпинделя в об/мин конкретного физического диска. Пример: 4294967295 | |||
| device_id string | always | Идентификатор устройства конкретного физического диска. Пример: 0 | |||
| unique_id string | always | Уникальный идентификатор конкретного физического диска. Пример: 3141463431303031 | |||
| virtual_disk complex | if existent | Подробная информация о свойствах виртуального диска конкретного диска. | |||
| operational_status string | always | Операционный статус конкретного виртуального диска. Пример: OK | |||
| доступные_копии int | если существует | Количество доступных копий конкретного виртуального диска. Пример: 1 | |||
| размер int | всегда | Размер конкретного виртуального диска в байтах. Пример: 240057409536 | |||
| размер_физического_сектора int | всегда | Размер физического сектора конкретного виртуального диска в байтах. Пример: 4096 | |||
| интерливинг int | всегда | Интерливинг конкретного виртуального диска в байтах. Пример: 102400 | |||
| запрос_без_единой_точки_сбоя bool | всегда | Информация о том, требует ли конкретный виртуальный диск отсутствия единой точки отказа. Пример: True | |||
| идентификатор_объекта string | всегда | Идентификатор объекта конкретного виртуального диска. Пример: {1}\\\\HOST\\root/Microsoft/Windows/Storage/Providers_v2\\SPACES_VirtualDisk.ObjectId=\"{<object_id>}:VD:{<vd>}\" | |||
| доступ string | всегда | Доступ к конкретному виртуальному диску. Пример: Чтение/Запись | |||
| включена_дедупликация bool | всегда | Информация о том, включена ли дедупликация для конкретного виртуального диска. Пример: True | |||
| отпечаток_в_пуле int | всегда | Отпечаток в пуле в байтах конкретного виртуального диска. Пример: 240057409536 | |||
| тип_резервирования string | всегда | Тип резервирования конкретного виртуального диска. Пример: Толстый | |||
| тип_носителя string | всегда | Тип носителя конкретного виртуального диска. Пример: Не указано | |||
| логический_размер_сектора int | всегда | Логический размер сектора в байтах конкретного виртуального диска. Пример: 512 | |||
| колонки int | всегда | Количество столбцов конкретного виртуального диска. Пример: 2 | |||
| ручная_привязка bool | всегда | Информация о том, привязан ли конкретный виртуальный диск вручную. Пример: True | |||
| учитывающий_оболочку bool | всегда | Информация о том, учитывает ли конкретный виртуальный диск оболочку. | |||
| размер_кеша_чтения int | всегда | Размер кеша чтения в байтах конкретного виртуального диска. | |||
| избыточность_физического_диска int | всегда | Тип избыточности физического диска конкретного виртуального диска. Пример: 1 | |||
| группы int | всегда | Количество групп конкретного виртуального диска. Пример: 1 | |||
| причина_отключения string | всегда | Причина отключения конкретного виртуального диска. Пример: Нет | |||
| размер_кеша_записи int | всегда | Размер кеша записи в байтах конкретного виртуального диска. Пример: 100 | |||
| имя string | всегда | Имя конкретного виртуального диска. Пример: vDisk1 | |||
| размер_выделенной_памяти int | всегда | Размер выделенной памяти в байтах конкретного виртуального диска. Пример: 240057409536 | |||
| имя_настройки_избыточности int | всегда | Тип избыточности физического диска конкретного виртуального диска. Пример: 1 | |||
| дружественное_имя string | всегда | Дружественное имя конкретного виртуального диска. Пример: Виртуальный диск Prod2 | |||
| размер_блока_выделения int | всегда | Размер блока выделения в байтах конкретного виртуального диска. Пример: 4096 | |||
| формат_уникального_идентификатора string | всегда | Формат уникального идентификатора конкретного виртуального диска. Пример: Специфичный для поставщика | |||
| иерархический bool | всегда | Информация о том, является ли конкретный виртуальный диск иерархическим. Пример: True | |||
| health_status string | always | Состояние работоспособности конкретного виртуального диска. Пример: Healthy | |||
| snapshot bool | always | Информация о том, является ли конкретный виртуальный диск снимком. | |||
| parity_layout int | if existent | Схема чётности конкретного виртуального диска. Пример: 1 | |||
| unique_id string | always | Уникальный идентификатор конкретного виртуального диска. Пример: 260542E4C6B01D47A8FA7630FD90FFDE | |||
| fault_domain_awareness string | always | Учёт области отказа конкретного виртуального диска. Пример: PhysicalDisk | |||
| partition_style string | always | Стиль разбиения конкретного диска. Пример: MBR | |||
| unique_id string | always | Уникальный ID конкретного диска на целевом устройстве. Пример: 3141463431303031 | |||
| number int | always | Номер конкретного диска. | |||
| clustered bool | always | Информация о том, является ли конкретный диск кластеризованным (частью кластера резервного копирования). | |||
| path string | always | Путь к конкретному диску на целевом устройстве. Пример: \\?\scsi#disk&ven_red_hat&prod_virtio#4&23208fd0&1&000000#{<id>} | |||
| firmware_version string | always | Версия микропрограммы конкретного диска. Пример: 0001 | |||
| guid string | if existent | GUID конкретного диска на целевом устройстве. Пример: {efa5f928-57b9-47fc-ae3e-902e85fbe77f} | |||
| size int | always | Размер конкретного диска в байтах. Пример: 227727638528 | |||
| read_only bool | always | Статус только для чтения конкретного диска. Пример: True | |||
| sector_size int | always | Размер сектора конкретного диска в байтах. Пример: 4096 | |||
| bootable bool | always | Информация о том, является ли конкретный диск загрузочным. | |||
| partitions list | if existent | Подробная информация об одной конкретной разбиении на указанном диске. | |||
| transition_state int | always | Состояние перехода конкретной разбиения. Пример: 1 | |||
| no_default_driveletter bool | if partition_style property of the particular disk has value "GPT" | Информация о том, имеет ли конкретная разбиение букву диска по умолчанию. Пример: True | |||
| gpt_type string | if partition_style property of the particular disk has value "GPT" | Тип GPT конкретной разбиения. Пример: {e3c9e316-0b5c-4db8-817d-f92df00215ae} | |||
| number int | always | Номер конкретной разбиения. Пример: 1 | |||
| access_paths string | if existent | Пути доступа к конкретной разбиению. Пример: \\?\Volume{85bdc4a8-f8eb-11e6-80fa-806e6f6e6963}\ | |||
| shadow_copy bool | always | Информация о том, является ли конкретная разбиение теневой копией другой разбиения. | |||
| mbr_type int | if partition_style property of the particular disk has value "MBR" | Тип MBR конкретной разбиения. Пример: 7 | |||
| drive_letter string | if existent | Буква диска конкретной разбиения. Пример: C | |||
| volumes list | if existent | Подробная информация об одном конкретном томе на указанном разделе. | |||
| allocation_unit_size int | always | Размер единицы выделения в байтах конкретного тома. Пример: 4096 | |||
| object_id string | always | Идентификатор объекта конкретного тома. Пример: \\?\Volume{85bdc4a9-f8eb-11e6-80fa-806e6f6e6963}\ | |||
| label string | always | Метка файловой системы конкретного тома. Пример: System Reserved | |||
| size_remaining int | always | Остающийся размер в байтах конкретного тома. Пример: 395620352 | |||
| health_status string | always | Состояние работоспособности конкретного тома. Пример: Healthy | |||
| drive_type string | always | Тип устройства хранения конкретного тома. Пример: Fixed | |||
| path string | always | Путь к конкретному тому. Пример: \\?\Volume{85bdc4a9-f8eb-11e6-80fa-806e6f6e6963}\ | |||
| type string | always | Тип файловой системы конкретного тома. Пример: NTFS | |||
| size int | always | Размер в байтах конкретного тома. Пример: 838856704 | |||
| offset int | always | Смещение конкретного раздела. Пример: 368050176 | |||
| active bool | если свойство partition_style конкретного диска имеет значение "MBR" | Информация о том, является ли конкретный раздел активным разделом или нет. Пример: True | |||
| hidden bool | always | Информация о том, скрыт ли конкретный раздел или нет. Пример: True | |||
| guid string | если существует | GUID конкретного раздела. Пример: {302e475c-6e64-4674-a8e2-2f1c7018bf97} | |||
| type string | always | Тип конкретного раздела. Пример: IFS | |||
| size int | always | Размер в байтах конкретного раздела. Пример: 838860800 | |||
| operational_status string | always | Операционное состояние конкретного диска. Пример: Online | |||
| friendly_name string | always | Наименование конкретного диска. Пример: Red Hat VirtIO SCSI Disk Device | |||
| partition_count int | always | Количество разделов на конкретном диске. Пример: 4 | |||
| location string | always | Расположение конкретного диска на целевом устройстве. Пример: PCIROOT(0)#PC0400#SCSP00T00L00
| |||
| serial_number string | always | Серийный номер конкретного диска на целевом устройстве. Пример: b62beac80c3645e5877f | |||
| model string | always | Модель конкретного диска. Пример: VirtIO | |||
| manufacturer string | always | Производитель конкретного диска. Пример: Red Hat | |||
| system_disk bool | always | Информация о том, является ли конкретный диск системным диском. Пример: True | |||
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимости.
Автор
- 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.5/modules/win_disk_facts_module.html