infinidat.infinibox.infini_metadata 模块 – 在 Infinibox 上创建、删除或修改元数据

注意

此模块是 infinidat.infinibox 集合（版本 1.4.5）的一部分。

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

要安装它，请使用：ansible-galaxy collection install infinidat.infinibox。您需要进一步的要求才能使用此模块，请参阅要求了解详细信息。

要在 playbook 中使用它，请指定：infinidat.infinibox.infini_metadata。

infinidat.infinibox 2.13.0 中的新增功能

概要

  • 此模块在 Infinibox 上创建、删除或修改元数据。

  • 对于任何 object_type（例如 DELETE api/rest/metadata/system），未实现按对象删除元数据，而不指定密钥。

  • 这将删除属于该对象的所有元数据。而是使用其密钥名称显式删除每个密钥。

要求

执行此模块的主机需要满足以下要求。

参数

参数

注释

key

字符串 / 必需

元数据键的名称

object_name

字符串

对象的名称。如果 object_type 为 system，则不使用

object_type

字符串 / 必需

对象类型

选择

  • "cluster"

  • "fs"

  • "fs-snap"

  • "host"

  • "pool"

  • "system"

  • "vol"

  • "vol-snap"

password

字符串 / 必需

Infinibox 用户密码。

state

字符串

存在时创建/修改元数据，不存在时删除。

选择

  • "stat"

  • "present" ←（默认）

  • "absent"

system

字符串 / 必需

Infinibox 主机名或 IPv4 地址。

user

字符串 / 必需

具有足够权限的 Infinibox 用户用户名（请参阅注释）。

value

字符串

元数据键的值

注意

注意

  • 此模块需要 infinisdk python 库

  • 如果未将 user 和 password 参数直接传递给模块，则必须设置 INFINIBOX_USER 和 INFINIBOX_PASSWORD 环境变量

  • 如果没有提供凭据，Ansible 将使用 infinisdk 配置文件 ~/.infinidat/infinisdk.ini。请参阅 http://infinisdk.readthedocs.io/en/latest/getting_started.html

  • 所有 Infinidat 模块都支持检查模式 (–check)。但是，如果未满足任务的资源依赖关系，则创建资源的 dryrun 可能会失败。例如，考虑一个在池中创建卷的任务。如果池不存在，则卷创建任务将失败。即使 playbook 中有先前的任务会创建池，但由于池创建也是 dry run 的一部分而没有创建，也会失败。

示例

- name: Create new metadata key foo with value bar
  infini_metadata:
    name: foo
    key: bar
    state: present
    user: admin
    password: secret
    system: ibox001
- name: Stat metadata key named foo
  infini_metadata:
    name: foo
    state: stat
    user: admin
    password: secret
    system: ibox001
- name: Remove metadata keyn named foo
  infini_vol:
    name: foo_snap
    state: absent
    user: admin
    password: secret
    system: ibox001

作者

  • David Ohlemacher (@ohlemacher)