qumulo_local_group (Resource)

Manages a local group on a Qumulo cluster.

Local groups are used to organize users and control access to files and directories. Groups can be referenced by NFS exports and SMB shares for access control.

Example Usage

Basic Group

resource "qumulo_local_group" "developers" {
  connection_profile = "prod"

  name = "developers"
}

Group with Custom GID

resource "qumulo_local_group" "admins" {
  connection_profile = "prod"

  name = "admins"
  gid  = "1000"
}

Multi-Cluster with for_each

variable "clusters" {
  type = set(string)
  default = ["prod", "dr"]
}

resource "qumulo_local_group" "developers" {
  for_each = var.clusters

  connection_profile = each.value

  name = "developers"
}

Import

Local groups can be imported using the format connection_profile,group_name:

terraform import qumulo_local_group.example prod,developers

~> Note: Deleting a group will fail if any users have it set as their primary group. Change those users' primary groups first before deleting.

Schema

Required

• connection_profile (String) Name of a connection profile from the provider block. See the provider reference for how to define profiles.
• name (String) The name of the local group. Must be unique on the cluster.

Optional

• gid (String) The NFS group ID (GID). If not specified, one will be auto-assigned by the cluster.

Read-Only

• id (String) The unique ID of the local group assigned by the cluster.
• sid (String) The Windows Security Identifier (SID) for the group.