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¶

Installation¶

terraform {
  required_providers {
    qumulo = {
      source  = "qumulo-terraform-registry.s3.us-east-1.amazonaws.com/qumulo/qumulo"
      version = "~> 1.0"
    }
  }
}

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 defined in the provider block.

Connection profiles centralize cluster credentials at the provider level. Define profiles in the provider block:

provider "qumulo" {
  connection_profiles = [
    {
      name                 = "prod"
      endpoint             = "https://cluster.example.com:8000"
      username             = "admin"
      password             = var.cluster_password
      insecure_skip_verify = true  # For self-signed certificates
    }
  ]
}

- 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.