netapp.storagegrid.na_sg_grid_info module – NetApp StorageGRID Grid information gatherer.

Note

This module is part of the netapp.storagegrid collection (version 21.12.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_info.

New in netapp.storagegrid 20.11.0

Synopsis 

This module allows you to gather various information about StorageGRID Grid configuration.

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
gather_subset list / elements=string	When supplied, this argument will restrict the information collected to a given subset. Either the info name or the REST API can be given. Possible values for this argument include `grid_accounts_info` or `grid/accounts` `grid_alarms_info` or `grid/alarms` `grid_audit_info` or `grid/audit` `grid_compliance_global_info` or `grid/compliance-global` `grid_config_info` or `grid/config` `grid_config_management_info` or `grid/config/management` `grid_config_product_version_info` or `grid/config/product-version` `grid_deactivated_features_info` or `grid/deactivated-features` `grid_dns_servers_info` or `grid/dns-servers` `grid_domain_names_info` or `grid/domain-names` `grid_ec_profiles_info` or `grid/ec-profiles` `grid_expansion_info` or `grid/expansion` `grid_expansion_nodes_info` or `grid/expansion/nodes` `grid_expansion_sites_info` or `grid/expansion/sites` `grid_grid_networks_info` or `grid/grid-networks` `grid_groups_info` or `grid/groups` `grid_health_info` or `grid/health` `grid_health_topology_info` or `grid/health/topology` `grid_identity_source_info` or `grid/identity-source` `grid_ilm_criteria_info` or `grid/ilm-criteria` `grid_ilm_policies_info` or `grid/ilm-policies` `grid_ilm_rules_info` or `grid/ilm-rules` `grid_license_info` or `grid/license` `grid_management_certificate_info` or `grid/management-certificate` `grid_ntp_servers_info` or `grid/ntp-servers` `grid_recovery_available_nodes_info` or `grid/recovery/available-nodes` `grid_recovery_info` or `grid/recovery` `grid_regions_info` or `grid/regions` `grid_schemes_info` or `grid/schemes` `grid_snmp_info` or `grid/snmp` `grid_storage_api_certificate_info` or `grid/storage-api-certificate` `grid_untrusted_client_network_info` or `grid/untrusted-client-network` `grid_users_info` or `grid/users` `grid_users_root_info` or `grid/users/root` `versions_info` or `versions` Can specify a list of values to include a larger subset. Default: `["all"]`
parameters dictionary	Allows for any rest option to be passed in.
validate_certs boolean	Should https certificates be validated? Choices: `false` `true` ← (default)

Notes 

Note

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

Examples 

- name: Gather StorageGRID Grid info
  netapp.storagegrid.na_sg_grid_info:
    api_url: "https://1.2.3.4/"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
  register: sg_grid_info

- name: Gather StorageGRID Grid info for grid/accounts and grid/config subsets
  netapp.storagegrid.na_sg_grid_info:
    api_url: "https://1.2.3.4/"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    gather_subset:
      - grid_accounts_info
      - grid/config
  register: sg_grid_info

- name: Gather StorageGRID Grid info for all subsets
  netapp.storagegrid.na_sg_grid_info:
    api_url: "https://1.2.3.4/"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    gather_subset:
      - all
  register: sg_grid_info

- name: Gather StorageGRID Grid info for grid/accounts and grid/users subsets, limit to 5 results for each subset
  netapp.storagegrid.na_sg_grid_info:
    api_url: "https://1.2.3.4/"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    gather_subset:
      - grid/accounts
      - grid/users
    parameters:
      limit: 5
  register: sg_grid_info

Return Values 

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

Key

Description

sg_info

dictionary

Returns various information about the StorageGRID Grid configuration.

Returned: always

Sample: {"grid/accounts": {"...": null}, "grid/alarms": {"...": null}, "grid/audit": {"...": null}, "grid/compliance-global": {"...": null}, "grid/config": {"...": null}, "grid/config/management": {"...": null}, "grid/config/product-version": {"...": null}, "grid/deactivated-features": {"...": null}, "grid/dns-servers": {"...": null}, "grid/domain-names": {"...": null}, "grid/ec-profiles": {"...": null}, "grid/expansion": {"...": null}, "grid/expansion/nodes": {"...": null}, "grid/expansion/sites": {"...": null}, "grid/groups": {"...": null}, "grid/health": {"...": null}, "grid/health/topology": {"...": null}, "grid/identity-source": {"...": null}, "grid/ilm-criteria": {"...": null}, "grid/ilm-policies": {"...": null}, "grid/ilm-rules": {"...": null}, "grid/license": {"...": null}, "grid/management-certificate": {"...": null}, "grid/networks": {"...": null}, "grid/ntp-servers": {"...": null}, "grid/recovery": {"...": null}, "grid/recovery/available-nodes": {"...": null}, "grid/regions": {"...": null}, "grid/schemes": {"...": null}, "grid/snmp": {"...": null}, "grid/storage-api-certificate": {"...": null}, "grid/untrusted-client-network": {"...": null}, "grid/users": {"...": null}, "grid/users/root": {"...": null}, "grid/versions": {"...": null}}

Authors

NetApp Ansible Team (@jasonl4)

netapp.storagegrid.na_sg_grid_info module – NetApp StorageGRID Grid information gatherer.

Synopsis

Parameters

Notes

Examples

Return Values