Spec-Zone.ru › Ansible 2.6

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
Подробная информация об одном конкретном диске.

number
int
 always
Номер диска.

size
int
 always
Размер в байтах конкретного диска.

Пример:
227727638528
bus_type
string
 always
Тип шины конкретного диска.

Пример:
SCSI
friendly_name
string
 always
Наименование конкретного диска.

Пример:
Red Hat VirtIO SCSI Disk Device
partition_style
string
 always
Стиль разбиения конкретного диска.

Пример:
MBR
partition_count
int
 always
Количество разделов на конкретном диске.

Пример:
4
operational_status
string
 always
Рабочее состояние конкретного диска.

Пример:
Online
sector_size
int
 always
Размер сектора в байтах конкретного диска.

Пример:
4096
read_only
bool
 always
Статус только для чтения конкретного диска.

Пример:
True
bootable
bool
 always
Информация о том, является ли конкретный диск загрузочным.

system_disk
bool
 always
Информация о том, является ли конкретный диск системным.

Пример:
True
clustered
bool
 always
Информация о том, является ли конкретный диск кластеризованным (частью кластера отказоустойчивости).

manufacturer
string
 always
Производитель конкретного диска.

Пример:
Red Hat
model
string
 always
Модель конкретного диска.

Пример:
VirtIO
firmware_version
string
 always
Версия прошивки конкретного диска.

Пример:
0001
location
string
 always
Расположение конкретного диска на целевом устройстве.

Пример:
PCIROOT(0)#PC0400#SCSP00T00L00
serial_number
string
 always
Серийный номер конкретного диска на целевом устройстве.

Пример:
b62beac80c3645e5877f
unique_id
string
 always
Уникальный идентификатор конкретного диска на целевом устройстве.

Пример:
3141463431303031
guid
string
 если существует
GUID конкретного диска на целевом устройстве.

Пример:
{efa5f928-57b9-47fc-ae3e-902e85fbe77f}
path
string
 always
Путь к конкретному диску на целевом устройстве.

Пример:
\\?\scsi#disk&ven_red_hat&prod_virtio#4&23208fd0&1&000000#{<id>}
partitions
list
 если существуют
Подробная информация об одном конкретном разделе на указанном диске.

number
int
 always
Номер конкретного раздела.

Пример:
1
size
int
 always
Размер в байтах конкретного раздела.

Пример:
838860800
type
string
 always
Тип конкретного раздела.

Пример:
IFS
gpt_type
string
 если свойство partition_style конкретного диска имеет значение "GPT"
Тип gpt конкретного раздела.

Пример:
{e3c9e316-0b5c-4db8-817d-f92df00215ae}
no_default_driveletter
bool
 если свойство partition_style конкретного диска имеет значение "GPT"
Информация о том, имеет ли конкретный раздел букву диска по умолчанию или нет.

Пример:
True
mbr_type
int
 если свойство partition_style конкретного диска имеет значение "MBR"
Тип mbr конкретного раздела.

Пример:
7
active
bool
 если свойство partition_style конкретного диска имеет значение "MBR"
Информация о том, является ли конкретный раздел активным или нет.

Пример:
True
drive_letter
string
 если существует
Буква диска конкретного раздела.

Пример:
C
transition_state
int
 always
Состояние перехода конкретного раздела.

Пример:
1
offset
int
 always
Смещение конкретного раздела.

Пример:
368050176
hidden
bool
 always
Информация о том, скрыт ли конкретный раздел или нет.

Пример:
True
shadow_copy
bool
 always
Информация о том, является ли конкретный раздел теневой копией другого раздела.

guid
string
 if existent
GUID конкретного раздела.

Пример:
{302e475c-6e64-4674-a8e2-2f1c7018bf97}
access_paths
string
 if existent
Пути доступа к конкретному разделу.

Пример:
\\?\Volume{85bdc4a8-f8eb-11e6-80fa-806e6f6e6963}\
volumes
list
 if existent
Подробная информация об одном конкретном томе на указанном разделе.

size
int
 always
Размер в байтах конкретного тома.

Пример:
838856704
size_remaining
int
 always
Остающийся размер в байтах конкретного тома.

Пример:
395620352
type
string
 always
Тип файловой системы конкретного тома.

Пример:
NTFS
label
string
 always
Метка файловой системы конкретного тома.

Пример:
Системный резерв
health_status
string
 always
Состояние здоровья конкретного тома.

Пример:
Здоровый
drive_type
string
 always
Тип диска конкретного тома.

Пример:
Фиксированный
allocation_unit_size
int
 always
Размер единицы размещения в байтах конкретного тома.

Пример:
4096
object_id
string
 always
Идентификатор объекта конкретного тома.

Пример:
\\?\Volume{85bdc4a9-f8eb-11e6-80fa-806e6f6e6963}\
path
string
 always
Путь конкретного тома.

Пример:
\\?\Volume{85bdc4a9-f8eb-11e6-80fa-806e6f6e6963}\
physical_disk
complex
 if existent
Подробная информация о свойствах физического диска конкретного диска.

media_type
string
 always
Тип носителя конкретного физического диска.

Пример:
Неопределённый
size
int
 always
Размер в байтах конкретного физического диска.

Пример:
240057409536
allocated_size
int
 always
Размер выделенной памяти в байтах конкретного физического диска.

Пример:
240057409536
device_id
string
 always
Идентификатор устройства конкретного физического диска.

Пример:
0
friendly_name
string
 always
Дружественное имя конкретного физического диска.

Пример:
PhysicalDisk0
operational_status
string
 always
Рабочее состояние конкретного физического диска.

Пример:
OK
health_status
string
 always
Состояние здоровья конкретного физического диска.

Пример:
Здоровый
bus_type
string
 always
Тип шины конкретного физического диска.

Пример:
SCSI
usage_type
string
 always
Тип использования конкретного физического диска.

Пример:
Автоматический выбор
supported_usages
complex
 always
Поддерживаемые типы использования конкретного физического диска.

Количество
int
 всегда
Количество поддерживаемых типов использования.

Пример:
5
значение
строка
 всегда
Список поддерживаемых типов использования.

Пример:
Автовыбор, Активный резерв
скорость_шпинделя
int
 всегда
Скорость шпинделя в об/мин для конкретного физического диска.

Пример:
4294967295
физическое_расположение
строка
 всегда
Физическое расположение конкретного физического диска.

Пример:
Встроенный : Адаптер 3 : Порт 0 : Цель 0 : LUN 0
производитель
строка
 всегда
Производитель конкретного физического диска.

Пример:
SUSE
модель
строка
 всегда
Модель конкретного физического диска.

Пример:
Xen Block
можно_в_пул
булево
 всегда
Информация о возможности добавления конкретного физического диска в пул хранилища.

причина_невозможности_в_пул
строка
 если свойство можно_в_пул имеет значение ложь
Информация о причинах невозможности добавления конкретного физического диска в пул хранилища.

Пример:
Недостаточная емкость
указание_включено
булево
 всегда
Информация о включении указания для конкретного физического диска.

Пример:
Истина
частичный
булево
 всегда
Информация о том, является ли конкретный физический диск частичным.

серийный_номер
строка
 всегда
Серийный номер конкретного физического диска.

Пример:
b62beac80c3645e5877f
идентификатор_объекта
строка
 всегда
Идентификатор объекта конкретного физического диска.

Пример:
{1}\\\\HOST\\root/Microsoft/Windows/Storage/Providers_v2\\SPACES_PhysicalDisk.ObjectId=\"{<object_id>}:PD:{<pd>}\"
уникальный_идентификатор
строка
 всегда
Уникальный идентификатор конкретного физического диска.

Пример:
3141463431303031
виртуальный_диск
сложный
 если существует
Подробная информация о свойствах виртуального диска для конкретного диска.

размер
int
 всегда
Размер в байтах конкретного виртуального диска.

Пример:
240057409536
размер_выделенной_области
int
 всегда
Выделенный размер в байтах конкретного виртуального диска.

Пример:
240057409536
отпечаток_на_пуле
int
 всегда
Отпечаток на пуле в байтах конкретного виртуального диска.

Пример:
240057409536
имя
строка
 всегда
Имя конкретного виртуального диска.

Пример:
vDisk1
дружественное_имя
строка
 всегда
Дружественное имя конкретного виртуального диска.

Пример:
Виртуальный диск Prod2
операционный_статус
строка
 всегда
Операционный статус конкретного виртуального диска.

Пример:
OK
статус_работоспособности
строка
 всегда
Статус работоспособности конкретного виртуального диска.

Пример:
Работоспособный
тип_обеспечения
строка
 всегда
Тип обеспечения конкретного виртуального диска.

Пример:
Толстый
размер_блока_выделения
int
 всегда
Размер блока выделения в байтах конкретного виртуального диска.

Пример:
4096
тип_носителя
строка
 всегда
Тип носителя конкретного виртуального диска.

Пример:
Не указано
макет_паритета
int
 если существует
Макет паритета конкретного виртуального диска.

Пример:
1
доступ
строка
 всегда
Доступ к конкретному виртуальному диску.

Пример:
Чтение/Запись
причина_отключения
строка
 всегда
Причина отключения конкретного виртуального диска.

Пример:
Нет
write_cache_size
int
 always
Размер кэша записи в байтах для данного виртуального диска.

Пример:
100
fault_domain_awareness
string
 always
Осведомленность о домене отказов для данного виртуального диска.

Пример:
PhysicalDisk
inter_leave
int
 always
Интерлейв в байтах для данного виртуального диска.

Пример:
102400
deduplication_enabled
bool
 always
Информация о том, включена ли дедупликация для данного виртуального диска.

Пример:
True
enclosure_aware
bool
 always
Информация о том, является ли данный виртуальный диск осведомленным об оболочке.
manual_attach
bool
 always
Информация о том, прикреплен ли данный виртуальный диск вручную.

Пример:
True
snapshot
bool
 always
Информация о том, является ли данный виртуальный диск снимком.
tiered
bool
 always
Информация о том, является ли данный виртуальный диск тиерированным.

Пример:
True
physical_sector_size
int
 always
Размер физического сектора в байтах для данного виртуального диска.

Пример:
4096
logical_sector_size
int
 always
Размер логического сектора в байтах для данного виртуального диска.

Пример:
512
available_copies
int
 если существует
Количество доступных копий данного виртуального диска.

Пример:
1
columns
int
 always
Количество столбцов данного виртуального диска.

Пример:
2
groups
int
 always
Количество групп данного виртуального диска.

Пример:
1
physical_disk_redundancy
int
 always
Тип избыточности физического диска для данного виртуального диска.

Пример:
1
read_cache_size
int
 always
Размер кэша чтения в байтах для данного виртуального диска.
request_no_spof
bool
 always
Информация о том, запрашивает ли данный виртуальный диск отсутствие единой точки отказа.

Пример:
True
resiliency_setting_name
int
 always
Тип избыточности физического диска для данного виртуального диска.

Пример:
1
object_id
string
 always
Объектный идентификатор данного виртуального диска.

Пример:
{1}\\\\HOST\\root/Microsoft/Windows/Storage/Providers_v2\\SPACES_VirtualDisk.ObjectId=\"{<object_id>}:VD:{<vd>}\"
unique_id
string
 always
Уникальный идентификатор данного виртуального диска.

Пример:
260542E4C6B01D47A8FA7630FD90FFDE
unique_id_format
string
 always
Формат уникального идентификатора данного виртуального диска.

Пример:
Vendor Specific


Статус

Этот модуль помечен как превью, что означает, что его обратная совместимость не гарантируется.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробности см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом 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.6/modules/win_disk_facts_module.html

Spec-Zone.ru

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