Модуль netapp_eseries.santricity.na_santricity_snapshot — Снимки хранения NetApp E-Series.

Примечание

Этот модуль входит в коллекцию netapp_eseries.santricity (версия 1.4.1).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install netapp_eseries.santricity.

Чтобы использовать её в плейбуке, укажите: netapp_eseries.santricity.na_santricity_snapshot.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление снимками хранилища NetApp E-Series.

Параметры

Параметр	Комментарии
alert_threshold_pct integer	Процент заполненной резервной емкости для выдачи предупреждения. По умолчанию: `75`
api_password string / required	Пароль для аутентификации с помощью SANtricity Web Services Proxy или Embedded Web Services API.
api_url string / required	URL для SANtricity Web Services Proxy или Embedded Web Services API. Пример https://prod-1.wahoo.acme.com:8443/devmgr/v2
api_username string / required	Имя пользователя для аутентификации с помощью SANtricity Web Services Proxy или Embedded Web Services API.
group_name string / required	Имя группы согласованности снимков или снимка тома. Используйте разные имена для групп согласованности снимков и снимков томов, чтобы избежать конфликтов имен.
maximum_snapshots integer	Общее количество снимков для хранения. По умолчанию: `32`
pit_description string	Произвольное описание снимков группы согласованности.
pit_name string	Имя снимков группы согласованности.
pit_timestamp string	Метка времени снимка в формате YYYY-MM-DD HH:MM:SS (AM\|PM) (часы, минуты, секунды и период дня необязательны) Определите только столько времени, сколько необходимо, чтобы отличить нужный снимок от других. Если индикатор периода дня (AM, PM) не указан, будет предполагаться 24-часовое время. Термины latest и oldest могут использоваться для выбора новейших и старейших снимков группы согласованности. Взаимоисключающий с pit_name или pit_description
preferred_reserve_storage_pool string	Пул хранения или группа томов по умолчанию для тома резервной емкости. Пул хранения или группа томов базового тома будут выбраны по умолчанию, если не определены. Используется для указания пула хранения или группы томов как для членов тома группы согласованности снимков, так и для снимков томов
reserve_capacity_full_policy string	Политика для полной резервной емкости. Purge удаляет старейший снимок для базового тома в группе согласованности. Reject запрещает запись в базовый том (сохраняет снимки действительными). Варианты: `"purge"` ← (по умолчанию) `"reject"`
reserve_capacity_pct integer	Процент емкости базового тома по умолчанию, который необходимо зарезервировать для копирования при записи снимков (COW). Используется для определения резервной емкости как для членов тома группы согласованности снимков, так и для снимков томов. По умолчанию: `40`
rollback_backup boolean	Следует ли сделать моментальный снимок перед выполнением отката. Варианты: `false` `true` ← (по умолчанию)
rollback_priority string	Приоритет системы хранения, предоставляемый при восстановлении моментального снимка. Варианты: `"highest"` `"high"` `"medium"` ← (по умолчанию) `"low"` `"lowest"`
ssid string	Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива. По умолчанию: `"1"`
state string	Когда state==absent, гарантирует, что type был удален. Когда state==present, гарантирует, что type доступен. Когда state==rollback, группа согласованности будет откатана к моментальным снимкам, выбранным с помощью pit_name или pit_timestamp. state==rollback всегда будет возвращать changed, так как невозможно оценить текущее состояние базового тома по отношению к снимку. Варианты: `"absent"` `"present"` ← (по умолчанию) `"rollback"`

тип строка	Тип объекта снимка для воздействия. Группа указывает на группу согласованности снимков; группы согласованности могут содержать один или несколько базовых томов, которые определены в volumes. Точка указывает на точку во времени (изображения) группы согласованности снимков; изображение снимка будет создано для каждого базового тома, когда state==present. Предупреждение! При state==absent and type==pit, pit_name или pit_timestamp должны быть определены, и все изображения точек во времени, созданные до выбранной, также будут удалены. Просмотр указывает на том, том группы согласованности снимка определённой точки во времени (изображения); для каждого базового тома-члена будут созданы объемы снимков. Просмотры создаются из изображений одной точки во времени, поэтому после создания их нельзя изменить. Варианты: `"group"` ← (по умолчанию) `"pit"` `"view"`
validate_certs булево	Нужно ли проверять сертификаты https? Варианты: `false` `true` ← (по умолчанию)
view_host строка	Хост или группа хостов по умолчанию для отображения объемов снимков.
view_name строка	Группа томов-снимков группы согласованности. Требуется, когда state==volume или при обеспечении отсутствия просмотров, когда state==absent.
view_validate булево	По умолчанию, нужно ли проверять объемы снимков. Варианты: `false` ← (по умолчанию) `true`
view_writable булево	По умолчанию, должны ли объемы снимков быть доступны для записи. Варианты: `false` `true` ← (по умолчанию)
volumes список / элементы=словарь	Детали для каждого базового тома группы согласованности для определения резервного объема, предпочтительного резервного хранилища и параметров тома снимка. При state==present and type==group записи томов будут использованы для добавления или удаления базового тома из группы согласованности снимков. При state==present and type==view записи томов будут использованы для выбора изображений из точки во времени для соответствующих томов снимков. Если state==present and type==view и volume не указан, то все тома будут выбраны по умолчанию. Просмотры создаются из изображений одной точки во времени, поэтому после создания их нельзя изменить. При state==rollback, то volumes может быть использован для указания базовых томов, которые нужно откатить; в противном случае все тома группы согласованности будут откачены.
preferred_reserve_storage_pool строка	Предпочтительный пул хранения или группа томов для тома резервного объема. Пул хранения или группа томов базового тома будет выбран по умолчанию, если не определен. Используется для указания пула хранения или группы томов как для членов тома группы согласованности снимков, так и для томов снимков
reserve_capacity_pct целое число	Процент ёмкости базового тома, который нужно зарезервировать для копирования-при-записи (COW) снимка. Используется для определения резервного объема как для томов группы согласованности снимков, так и для томов снимков. По умолчанию: `40`
snapshot_volume_host строка	Хост или группа хостов для отображения тома снимка.
snapshot_volume_lun целое число	Идентификатор LUN для тома снимка.
snapshot_volume_validate булево	Нужно ли проверять том снимка, включая сканирование носителя и проверку чётности. Варианты: `false` ← (по умолчанию) `true`
snapshot_volume_writable булево	Должны ли тома снимков изображений базового тома быть доступны для записи? Варианты: `false` `true` ← (по умолчанию)
volume строка / обязательно	Базовый том для группы согласованности.

Примечания

Примечание

Ключевые значения используются для отслеживания имен и описаний снимков, так как изображения снимков в точке во времени имеют метаданные, связанные со своей структурой данных; поэтому необходимо очистить старые ключи, которые больше не связаны с реальным изображением. Это действие очистки выполняется каждый раз при выполнении этого модуля.
Модули Ansible E-Series требуют либо экземпляра прокси веб-сервисов (WSP), доступного для управления хранилищем, либо системы хранения E-Series, поддерживающей встроенный API веб-служб.
Встроенные веб-службы в настоящее время доступны на моделях E2800, E5700, EF570 и более новых аппаратных моделях.
netapp_eseries.santricity.netapp_e_storage_system может быть использован для настройки систем, управляемых экземпляром WSP.

Примеры

- name: Ensure snapshot consistency group exists.
  na_santricity_snapshot:
    ssid: "1"
    api_url: https://192.168.1.100:8443/devmgr/v2
    api_username: admin
    api_password: adminpass
    state: present
    type: group
    group_name: snapshot_group1
    volumes:
      - volume: vol1
        reserve_capacity_pct: 20
        preferred_reserve_storage_pool: vg1
      - volume: vol2
        reserve_capacity_pct: 30
      - volume: vol3
    alert_threshold_pct: 80
    maximum_snapshots: 30
- name: Take the current consistency group's base volumes point-in-time snapshot images.
  na_santricity_snapshot:
    ssid: "1"
    api_url: https://192.168.1.100:8443/devmgr/v2
    api_username: admin
    api_password: adminpass
    state: present
    type: pit
    group_name: snapshot_group1
    pit_name: pit1
    pit_description: Initial consistency group's point-in-time snapshot images.
- name: Ensure snapshot consistency group view exists and is mapped to host group.
  na_santricity_snapshot:
    ssid: "1"
    api_url: https://192.168.1.100:8443/devmgr/v2
    api_username: admin
    api_password: adminpass
    state: present
    type: view
    group_name: snapshot_group1
    pit_name: pit1
    view_name: view1
    view_host: view1_hosts_group
    volumes:
      - volume: vol1
        reserve_capacity_pct: 20
        preferred_reserve_storage_pool: vg4
        snapshot_volume_writable: false
        snapshot_volume_validate: true
      - volume: vol2
        reserve_capacity_pct: 20
        preferred_reserve_storage_pool: vg4
        snapshot_volume_writable: true
        snapshot_volume_validate: true
      - volume: vol3
        reserve_capacity_pct: 20
        preferred_reserve_storage_pool: vg4
        snapshot_volume_writable: false
        snapshot_volume_validate: true
    alert_threshold_pct: 80
    maximum_snapshots: 30
- name: Rollback base volumes to consistency group's point-in-time pit1.
  na_santricity_snapshot:
    ssid: "1"
    api_url: https://192.168.1.100:8443/devmgr/v2
    api_username: admin
    api_password: adminpass
    state: present
    type: group
    group_name: snapshot_group1
    pit_name: pit1
    rollback: true
    rollback_priority: high
- name: Ensure snapshot consistency group view no longer exists.
  na_santricity_snapshot:
    ssid: "1"
    api_url: https://192.168.1.100:8443/devmgr/v2
    api_username: admin
    api_password: adminpass
    state: absent
    type: view
    group_name: snapshot_group1
    view_name: view1
- name: Ensure that the consistency group's base volumes point-in-time snapshot images pit1 no longer exists.
  na_santricity_snapshot:
    ssid: "1"
    api_url: https://192.168.1.100:8443/devmgr/v2
    api_username: admin
    api_password: adminpass
    state: absent
    type: image
    group_name: snapshot_group1
    pit_name: pit1
- name: Ensure snapshot consistency group no longer exists.
  na_santricity_snapshot:
    ssid: "1"
    api_url: https://192.168.1.100:8443/devmgr/v2
    api_username: admin
    api_password: adminpass
    state: absent
    type: group
    group_name: snapshot_group1

Значения возврата

Общие значения возврата описаны здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Описание
changed boolean	Указывает, были ли внесены изменения. Возвращается: всегда
deleted_metadata_keys список / элементы=строка	Ключи, которые были удалены из хранилища значений ключа. Возвращается: всегда
group_changes словарь	Все изменения, внесенные в группу согласованности. Возвращается: всегда

Авторы

Nathan Swartz (@swartzn)
Vu Tran (@VuTran007)

Ссылки на коллекцию

© 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/netapp_eseries/santricity/na_santricity_snapshot_module.html