purestorage.flashblade.purefb_apiclient 模块 – 管理 FlashBlade API 客户端

注意

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

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

要安装它，请使用：ansible-galaxy collection install purestorage.flashblade。您需要其他要求才能使用此模块，请参阅 要求 了解详情。

要在 playbook 中使用它，请指定：purestorage.flashblade.purefb_apiclient。

purestorage.flashblade 1.6.0 中的新增功能

概要

  • 启用或禁用 FlashBlade API 客户端

要求

在执行此模块的主机上需要以下要求。

  • python >= 3.9

  • py-pure-client

  • purity_fb >= 1.12.2

  • netaddr

  • datetime

  • pytz

  • distro

  • pycountry

  • urllib3

参数

参数

注释

api_token

字符串

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

disable_warnings

布尔值

在 purestorage.flashblade 1.18.0 中添加

禁用不安全的证书警告

选项

  • false ← (默认)

  • true

enabled

布尔值

API 客户端密钥的状态

选项

  • false

  • true ← (默认)

fb_url

字符串

FlashBlade 管理 IP 地址或主机名。

issuer

字符串

将为该 API 客户端颁发 ID 令牌的身份提供程序的名称

如果未指定，则默认为 API 客户端名称 *name*。

name

字符串 / 必需

API 客户端的名称

public_key

字符串

API 客户端的 PEM 格式（Base64 编码）RSA 公钥。

包含 *—–BEGIN PUBLIC KEY—–* 和 *—–END PUBLIC KEY—–* 行

role

字符串

此 API 客户端颁发的 ID 令牌允许的最大角色

选项

  • "readonly"

  • "ops_admin"

  • "storage_admin"

  • "array_admin"

state

字符串

定义 API 客户端是否存在。

选项

  • "absent"

  • "present" ← (默认)

token_ttl

整数

交换的访问令牌的生存时间（以秒为单位）

范围为 1 秒到 1 天（86400 秒）

默认值： 86400

备注

注意

  • 此模块需要 purity_fb Python 库

  • 如果 *fb_url* 和 *api_token* 参数未直接传递到模块，则必须设置 PUREFB_URL 和 PUREFB_API 环境变量

示例

- name: Create API token ansible-token
  purestorage.flashblade.purefb_apiclient:
    name: ansible_token
    issuer: "Pure_Storage"
    token_ttl: 3000
    role: array_admin
    public_key: "{{lookup('file', 'public_pem_file') }}"
    fb_url: 10.10.10.2
    api_token: T-68618f31-0c9e-4e57-aa44-5306a2cf10e3

- name: Disable API CLient
  purestorage.flashblade.purefb_apiclient:
    name: ansible_token
    enabled: false
    fb_url: 10.10.10.2
    api_token: T-68618f31-0c9e-4e57-aa44-5306a2cf10e3

- name: Enable API CLient
  purestorage.flashblade.purefb_apiclient:
    name: ansible_token
    enabled: true
    fb_url: 10.10.10.2
    api_token: T-68618f31-0c9e-4e57-aa44-5306a2cf10e3

- name: Delete API Client
  purestorage.flashblade.purefb_apiclient:
    state: absent
    name: ansible_token
    fb_url: 10.10.10.2
    api_token: T-68618f31-0c9e-4e57-aa44-5306a2cf10e3

作者

  • Pure Storage Ansible 团队 (@sdodsley)