powerscale_user_group (Data Source)

This datasource is used to query the existing User Groups from PowerScale array. The information fetched from this datasource can be used for getting the details or for further processing in resource block. PowerScale User Group allows you to do operations on a set of users, groups and well-knowns.

Example Usage

/*
Copyright (c) 2023-2024 Dell Inc., or its subsidiaries. All Rights Reserved.

Licensed under the Mozilla Public License Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://mozilla.org/MPL/2.0/


Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

# PowerScale User Group allows you to do operations on a set of users, groups and well-knowns.

# Returns a list of PowerScale User Groups based on gid or name in names filter block. 
data "powerscale_user_group" "test_user_group" {
  filter {
    # Optional list of names to filter upon
    names = [
      # {
      #   gid = 0
      # },
      # {
      #   name = "Administrators"
      # },
      {
        name = "tfaccUserGroupDatasource"
        gid  = 10000
      }
    ]

    # Optional query parameters.
    cached      = false
    name_prefix = "tfacc"
    # domain = "testDomain"
    # zone = "testZone"
    # provider = "testProvider"
  }
}

# Output value of above block by executing 'terraform output' command.
# The user can use the fetched information by the variable data.powerscale_user_group.test_user_group
output "powerscale_user_group_filter" {
  value = data.powerscale_user_group.test_user_group
}

# After the successful execution of above said block, We can see the output value by executing 'terraform output' command.

Schema

Optional

filter (Block, Optional) (see below for nested schema)

Read-Only

id (String) Unique identifier of the user group instance.
user_groups (Attributes List) List of user groups. (see below for nested schema)

Nested Schema for `filter`

Optional:

cached (Boolean) If true, only return cached objects.
domain (String) Filter user groups by domain.
name_prefix (String) Filter user groups by name prefix.
names (Attributes List) List of user group identity. (see below for nested schema)
provider (String) Filter user groups by provider.
zone (String) Filter user groups by zone.

Nested Schema for `filter.names`

Optional:

gid (Number) Specifies a numeric user group identifier.
name (String) Specifies a user group name.

Nested Schema for `user_groups`

Read-Only:

dn (String) Specifies the distinguished name for the user group.
dns_domain (String) Specifies the DNS domain.
domain (String) Specifies the domain that the object is part of.
generated_gid (Boolean) If true, the GID was generated.
gid (String) Specifies a user group identifier.
id (String) Specifies the user group ID.
members (Attributes List) List of members of group. Group Member can be user or group. (see below for nested schema)
name (String) Specifies a user group name.
provider (String) Specifies the authentication provider that the object belongs to.
roles (List of String) List of roles.
sam_account_name (String) Specifies a user group name.
sid (String) Specifies a security identifier.
type (String) Specifies the object type.

Nested Schema for `user_groups.members`