purestorage.flasharray.purefa_endpoint 模块 – 管理 Pure Storage FlashArrays 上的 VMware 协议端点

注意

此模块是 purestorage.flasharray 集合（版本 1.32.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install purestorage.flasharray。您需要其他要求才能使用此模块，请参阅 要求 获取详细信息。

要在剧本中使用它，请指定：purestorage.flasharray.purefa_endpoint。

purestorage.flasharray 1.0.0 中的新增功能

概要

  • 在 Pure Storage FlashArray 上创建、删除或清除端点。

要求

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

  • python >= 3.3

  • purestorage >= 1.19

  • py-pure-client >= 1.26.0

  • netaddr

  • requests

  • pycountry

  • urllib3

参数

参数

说明

api_token

字符串

具有管理员权限的用户的 FlashArray API 令牌。

disable_warnings

布尔值

在 purestorage.flasharray 1.29.0 中添加

在调试日志中禁用不安全证书警告

选项

  • false ← (默认)

  • true

eradicate

布尔值

定义是否在删除时清除端点或将其留在回收站中。

选项

  • false ← (默认)

  • true

fa_url

字符串

FlashArray 管理 IPv4 地址或主机名。

hgroup

字符串

要将端点附加到的主机组的名称

host

字符串

要将端点附加到的主机的名称

name

字符串 / 必需

端点的名称。

rename

字符串

将指定的端点重命名为的值。

重命名仅适用于当前端点所在的容器。

state

字符串

定义端点是否应该存在。

选项

  • "absent"（不存在）

  • "present" ← (默认)

说明

注意

  • 此模块需要 purestorage 和 py-pure-client Python 库

  • 特定模块可能需要额外的 Python 库。

  • 如果未直接将 fa_url 和 api_token 参数传递给模块，则必须设置 PUREFA_URL 和 PUREFA_API 环境变量

示例

- name: Create new endpoint named foo
  purestorage.flasharray.purefa_endpoint:
    name: test-endpoint
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: present

- name: Delete and eradicate endpoint named foo
  purestorage.flasharray.purefa_endpoint:
    name: foo
    eradicate: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Rename endpoint foor to bar
  purestorage.flasharray.purefa_endpoint:
    name: foo
    rename: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

返回值

常见的返回值记录在此处，以下是此模块独有的字段

键

描述

volume

字典

描述已更改卷的字典。只有以下一些属性会随各种操作一起返回。

已返回： 成功

created

字符串

卷创建时间

已返回： 成功

示例： "2019-03-13T22:49:24Z"

name

字符串

卷名称

已返回： 成功

serial

字符串

卷序列号

已返回： 成功

示例： "361019ECACE43D83000120A4"

source

字符串

用于卷复制的源卷的卷名称

已返回： 成功

作者

  • Pure Storage Ansible 团队 (@sdodsley)