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。
要在 playbook 中使用它，请指定：netapp_eseries.santricity.na_santricity_snapshot。
概要
管理 NetApp E-Series 存储系统的快照。
参数
参数 |
注释 |
|---|---|
发出警报的已填充后备容量的百分比。 默认值： |
|
使用 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的密码。 |
|
SANtricity Web Services Proxy 或嵌入式 Web Services API 的 URL。 |
|
使用 SANtricity Web Services Proxy 或嵌入式 Web Services API 进行身份验证的用户名。 |
|
快照一致性组或快照卷的名称。 请确保为快照一致性组和快照卷使用不同的名称，以避免名称冲突。 |
|
要维护的快照映像总数。 默认值： |
|
一致性组快照映像的任意描述 |
|
一致性组快照映像的名称。 |
|
快照映像时间戳，格式为 YYYY-MM-DD HH:MM:SS (AM|PM)（小时、分钟、秒和日期段是可选的） 仅定义区分所需快照映像与其他映像所需的时间。 如果未指定日期段指示符（AM、PM），则将假定为 24 小时制。 术语 latest 和 oldest 可用于选择最新和最旧的一致性组映像。 与 pit_name 或 pit_description 互斥 |
|
后备容量卷的默认首选存储池或卷组。 如果未定义，则默认情况下将选择基本卷的存储池或卷组。 用于为快照一致性组卷成员和快照卷指定存储池或卷组 |
|
完整后备容量的策略。 清除删除一致性组中基本卷的最旧快照映像。 拒绝写入基本卷（保持快照映像有效）。 选项
|
|
为快照写入时复制 (COW) 保留的基本卷容量的默认百分比。 用于定义快照一致性组卷成员和快照卷的后备容量。 默认值： |
|
在执行回滚之前是否应拍摄时间点快照。 选项
|
|
存储系统在恢复快照时间点时赋予的优先级。 选项
|
|
要管理的阵列的 ID。此值对于每个阵列必须是唯一的。 默认值： |
|
当 state==absent 时，确保已删除 type。 当 state==present 时，确保 type 可用。 当 state==rollback 时，一致性组将回滚到 pit_name 或 pit_timestamp 选择的时间点快照映像。 state==rollback 将始终返回已更改，因为它无法评估基本卷相对于快照映像的当前状态。 选项
|
|
要影响的快照对象的类型。 Group（组）表示快照一致性组；一致性组可能有一个或多个基本卷成员，这些成员在volumes中定义。 Pit（时间点）表示快照一致性组的时间点映像；当state==present时，将为每个基本卷创建一个快照映像。 警告！当state==absent 且 type==pit时，必须定义pit_name或pit_timestamp，并且在选择之前创建的所有时间点映像也将被删除。 View（视图）表示特定时间点映像的一致性组快照卷；将为每个基本卷成员创建快照卷。 视图是从单个时间点的映像创建的，因此一旦创建就无法修改。 选项
|
|
是否应验证 https 证书？ 选项
|
|
用于映射快照卷的默认主机或主机组。 |
|
一致性组快照卷组。 当state==volume或当确保视图在state==absent时不存在时，此项为必填。 |
|
默认是否应验证快照卷。 选项
|
|
默认快照卷是否应可写。 选项
|
|
每个一致性组基本卷的详细信息，用于定义保留容量、首选保留容量存储池和快照卷选项。 当state==present 且 type==group时，卷条目将用于添加或删除快照一致性组中的基本卷。 当state==present 且 type==view时，卷条目将用于从时间点中选择其各自快照卷的映像。 如果state==present 且 type==view且未指定volume，则将选择所有卷并使用默认值。 视图是从单个时间点的映像创建的，因此一旦创建就无法修改。 当state==rollback时，可以使用volumes来指定要回滚的基本卷；否则，将回滚所有一致性组卷。 |
|
用于保留容量卷的首选存储池或卷组。 如果未定义，则默认情况下将选择基本卷的存储池或卷组。 用于为快照一致性组卷成员和快照卷指定存储池或卷组 |
|
为快照写入时复制 (COW) 保留的基本卷容量百分比。 用于定义快照一致性组卷成员和快照卷的后备容量。 默认值： |
|
用于映射快照卷的主机或主机组。 |
|
快照卷的 LUN ID。 |
|
是否应验证快照卷，包括介质扫描和奇偶校验验证。 选项
|
|
基本卷映像的快照卷是否应可写。 选项
|
|
一致性组的基本卷。 |
注释
注意
键值对用于跟踪快照名称和描述，因为快照时间点映像确实有与其数据结构关联的元数据；因此，有必要清除不再与实际映像关联的旧键。每次执行此模块时都会执行此清理操作。
E 系列 Ansible 模块需要 Web 服务代理 (WSP) 的实例才能管理存储系统，或者需要支持嵌入式 Web 服务 API 的 E 系列存储系统。
嵌入式 Web 服务目前在 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
返回值
通用返回值记录在此处，以下是此模块独有的字段
键 |
描述 |
|---|---|
是否已进行更改。 返回: 总是 |
|
从键值数据存储中清除的键。 返回: 总是 |
|
对一致性组执行的所有更改。 返回: 总是 |