netapp.storagegrid.na_sg_grid_group module – NetApp StorageGRID manage groups.

Note

This module is part of the netapp.storagegrid collection (version 21.11.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install netapp.storagegrid.

To use it in a playbook, specify: netapp.storagegrid.na_sg_grid_group.

New in version 20.6.0: of netapp.storagegrid

Synopsis

  • Create, Update, Delete Administration Groups within NetApp StorageGRID.

Parameters

Parameter

Comments

api_url

string / required

The url to the StorageGRID Admin Node REST API.

auth_token

string / required

The authorization token for the API request

display_name

string

Name of the group.

Required for create operation

management_policy

dictionary

Management access controls granted to the group within the tenancy.

activate_features

boolean

Users in this group will have permissions to reactivate features.

Choices:

  • no

  • yes

alarm_acknowledgement

boolean

Group members can have permission to acknowledge alarms.

Choices:

  • no

  • yes

change_tenant_root_password

boolean

Users in this group will have permissions to change tenant password.

Choices:

  • no

  • yes

grid_topology_page_configuration

boolean

Users in this group will have permissions to change grid topology.

Choices:

  • no

  • yes

ilm

boolean

Users in this group will have permissions to manage ILM rules on StorageGRID.

Choices:

  • no

  • yes

maintenance

boolean

Users in this group will have permissions to run maintenance tasks on StorageGRID.

Choices:

  • no

  • yes

metrics_query

boolean

Users in this group will have permissions to query metrics on StorageGRID.

Choices:

  • no

  • yes

object_metadata

boolean

Users in this group will have permissions to manage object metadata.

Choices:

  • no

  • yes

other_grid_configuration

boolean

Need to investigate.

Choices:

  • no

  • yes

root_access

boolean

Users in this group will have root access.

Choices:

  • no

  • yes

tenant_accounts

boolean

Users in this group will have permissions to manage tenant accounts.

Choices:

  • no

  • yes

state

string

Whether the specified group should exist or not.

Choices:

  • present ← (default)

  • absent

unique_name

string / required

Unique Name for the group. Must begin with group/ or federated-group/

Required for create, modify or delete operation.

validate_certs

boolean

Should https certificates be validated?

Choices:

  • no

  • yes ← (default)

Notes

Note

  • The modules prefixed with na_sg are built to manage NetApp StorageGRID.

Examples

- name: create a StorageGRID group
  netapp.storagegrid.na_sg_grid_group:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    display_name: ansiblegroup100
    unique_name: group/ansiblegroup100
    management_policy:
      tenant_accounts: true
      maintenance: true
      root_access: false

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

resp

dictionary

Returns information about the StorageGRID group attributes.

Returned: success

Sample: {“accountId”: “12345678901234567890”, “displayName”: “Example Group”, “federated”: false, “groupURN”: “urn:sgws:identity::12345678901234567890:group/examplegroup”, “id”: “00000000-0000-0000-0000-000000000000”, “policies”: {“management”: {“activateFeatures”: false, “alarmAcknowledgment”: true, “changeTenantRootPassword”: true, “gridTopologyPageConfiguration”: true, “ilm”: true, “maintenance”: true, “manageAlerts”: true, “metricsQuery”: true, “objectMetadata”: true, “otherGridConfiguration”: true, “rootAccess”: true, “storageAdmin”: true, “tenantAccounts”: true}}, “uniqueName”: “group/examplegroup”}

Authors

  • NetApp Ansible Team (@joshedmonds)