netapp.cloudmanager.na_cloudmanager_volume 模块 – NetApp Cloud Manager 卷

注意

此模块是 netapp.cloudmanager 集合（版本 21.24.0）的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install netapp.cloudmanager。

要在 Playbook 中使用它，请指定：netapp.cloudmanager.na_cloudmanager_volume。

netapp.cloudmanager 21.3.0 中的新增功能

概要

  • 在 Cloud Manager 上创建、修改或删除卷。

参数

参数

注释

aggregate_name

字符串

将在其中创建卷的聚合。 如果未提供，Cloud Manager 将选择最佳聚合。

capacity_tier

字符串

卷的容量层，用于将冷数据分层到对象存储。

每个云提供商的默认值如下。 Amazon 为“S3”，Azure 为“Blob”，GCP 为“cloudStorage”。

如果为“NONE”，则不会在创建卷时设置容量层。

选项

  • "NONE"

  • "S3"

  • "Blob"

  • "cloudStorage"

client_id

字符串 / 必需

Cloud Manager 连接器的连接器 ID。

enable_compression

布尔值

启用压缩。

如果未指定，则默认为 true。

选项

  • false

  • true

enable_deduplication

布尔值

启用重复数据删除。

如果未指定，则默认为 true。

选项

  • false

  • true

enable_thin_provisioning

布尔值

启用精简配置。

如果未指定，则默认为 true。

选项

  • false

  • true

environment

字符串

在 netapp.cloudmanager 21.8.0 中添加

NetApp Cloud Manager API 操作的环境。

选项

  • "prod" ←（默认）

  • "stage"

export_policy_ip

列表 / 元素=字符串

自定义 IP 导出策略列表（NFS 协议参数）。

export_policy_nfs_version

列表 / 元素=字符串

导出策略协议（NFS 协议参数）。

export_policy_type

字符串

导出策略类型（NFS 协议参数）。

feature_flags

字典

在 netapp.cloudmanager 21.11.0 中添加

启用或禁用新功能。

这可用于启用实验性功能或禁用破坏向后兼容性的新功能。

支持的键和值可能会在不事先通知的情况下更改。未知的键将被忽略。

igroups

列表 / 元素=字符串

igroup 列表（iSCSI 协议参数）。

initiators

列表 / 元素=字典

启动器的属性集（iSCSI 协议参数）。

alias

字符串 / 必需

与节点关联的别名。

iqn

字符串 / 必需

启动器节点名称。

iops

整数

预置的 IOPS。 仅当 provider_volume_type 为“io1”时才需要。

name

字符串 / 必需

卷的名称。

os_name

字符串

操作系统（iSCSI 协议参数）。

permission

字符串

CIFS 共享权限类型（CIFS 协议参数）。

provider_volume_type

字符串

底层云提供商卷类型。

对于 AWS 是 [“gp3”, “gp2”, “io1”, “st1”, “sc1”]。

对于 Azure 是 [‘Premium_LRS’,’Standard_LRS’,’StandardSSD_LRS’]。

对于 GCP 是 [‘pd-balanced’,’pd-ssd’,’pd-standard’]。

refresh_token

字符串

用于 NetApp Cloud Manager API 操作的刷新令牌。

sa_client_id

字符串

用于 NetApp Cloud Manager API 操作的服务帐户密钥客户端 ID。

sa_secret_key

字符串

用于 NetApp Cloud Manager API 操作的服务帐户密钥。

share_name

字符串

共享名称（CIFS 协议参数）。

size

浮点数

卷的大小。

size_unit

字符串

卷的大小单位。

选项

  • "GB" ←（默认）

snapshot_policy_name

字符串

快照策略名称。

state

字符串

指定的卷是否存在。

选项

  • "present" ←（默认）

  • "absent"

svm_name

字符串

SVM 的名称。 如果未提供名称，则使用默认 SVM 名称。

tenant_id

字符串

在 netapp.cloudmanager 21.20.0 中添加

连接器将与之关联的 NetApp 帐户 ID。 仅在使用 FSx 时使用。

throughput

整数

单位为 Mb/s。有效范围为 125-1000。

仅当 provider_volume_type 为 ‘gp3’ 时才需要。

tiering_policy

字符串

分层策略。

选项

  • "none"

  • "snapshot_only"

  • "auto"

  • "all"

users

列表 / 元素=字符串

具有权限的用户列表（CIFS 协议参数）。

volume_protocol

字符串

卷的协议。 这会影响提供的参数。

选项

  • "nfs" ←（默认）

  • "cifs"

  • "iscsi"

working_environment_id

字符串

将在其中创建卷的工作环境的公共 ID。

working_environment_name

字符串

将在其中创建卷的工作环境名称。

注释

注意

  • 支持 check_mode。

  • 前缀为 na_cloudmanager 的模块旨在管理 AWS/GCP/Azure 云中的 CloudManager 和 CVO 部署。

  • 如果提供了 sa_client_id 和 sa_secret_key，则将在操作中使用服务帐户。 refresh_token 将被忽略。

示例

- name: Create nfs volume with working_environment_name
  netapp.cloudmanager.na_cloudmanager_volume:
    state: present
    name: test_vol
    size: 15
    size_unit: GB
    working_environment_name: working_environment_1
    client_id: client_id
    refresh_token: refresh_token
    svm_name: svm_1
    snapshot_policy_name: default
    export_policy_type: custom
    export_policy_ip: ["10.0.0.1/16"]
    export_policy_nfs_version: ["nfs3","nfs4"]

- name: Delete volume
  netapp.cloudmanager.na_cloudmanager_volume:
    state: absent
    name: test_vol
    working_environment_name: working_environment_1
    client_id: client_id
    refresh_token: refresh_token
    svm_name: svm_1

作者

  • NetApp Ansible 团队 (@carchi8py)