netapp.storagegrid.na_sg_org_group 模块 – NetApp StorageGRID 管理租户内的组。

注意

此模块是 netapp.storagegrid 集合 (版本 21.13.0) 的一部分。

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

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

要在 playbook 中使用它，请指定： netapp.storagegrid.na_sg_org_group。

netapp.storagegrid 20.6.0 中的新增功能

概要

  • 在 NetApp StorageGRID 租户中创建、更新、删除组。

参数

参数

注释

api_url

字符串 / 必需

StorageGRID 管理节点 REST API 的 URL。

auth_token

字符串 / 必需

API 请求的授权令牌

display_name

字符串

组的名称。

创建操作必需。

management_policy

字典

授予组在租户内的管理访问控制。

manage_all_containers

布尔值

允许用户管理租户帐户中所有 S3 存储桶的设置，而不管 S3 存储桶或组策略如何。

选项

  • false

  • true

manage_endpoints

布尔值

允许用户使用租户管理器或租户管理 API 创建或编辑端点。

端点用作 StorageGRID 平台服务的目的地。

选项

  • false

  • true

manage_own_s3_credentials

布尔值

允许用户创建和删除他们自己的 S3 访问密钥。

没有此权限的用户将看不到 S3 > 我的凭据菜单选项。

选项

  • false

  • true

root_access

布尔值

提供对租户管理器和租户管理 API 的完全访问权限。

选项

  • false

  • true

s3_policy

JSON

StorageGRID S3 组策略。

state

字符串

指定组是否存在。

选项

  • "present" ← (默认)

  • "absent"

unique_name

字符串 / 必需

组的唯一名称。必须以 group/ 或 federated-group/ 开头。

创建、修改或删除操作必需。

validate_certs

布尔值

是否应验证 https 证书？

选项

  • false

  • true ← (默认)

备注

注意

  • 以 na_sg 开头的模块用于管理 NetApp StorageGRID。

示例

- name: create a group
  netapp.storagegrid.na_sg_org_group:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    display_name: ansiblegroup1
    unique_name: group/ansiblegroup1
    management_policy:
      manage_all_containers: true
      manage_endpoints: true
      manage_own_s3_credentials: false
      root_access: false
    s3_policy: {"Statement":[{"Effect":"Deny","Action":"s3:*","Resource":"arn:aws:s3:::*"}]}

返回值

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

键

描述

resp

字典

返回有关 StorageGRID 租户组属性的信息。

返回：成功

示例： {"accountId": "12345678901234567890", "displayName": "Example Group", "federated": false, "groupURN": "urn:sgws:identity::12345678901234567890:group/examplegroup", "id": "00000000-0000-0000-0000-000000000000", "policies": {"management": {"manageAllContainers": true, "manageEndpoints": true, "manageOwnS3Credentials": true, "rootAccess": true}, "s3": {"...": null}, "swift": {"...": null}}, "uniqueName": "group/examplegroup"}

作者

  • NetApp Ansible 团队 (@joshedmonds)