qumulo_file_system_settings (Resource)¶

Manages file system settings on a Qumulo cluster.

This is a singleton resource (one per cluster). It configures global file system settings including permissions mode, access time (atime) tracking, and file system notifications.

Example Usage¶

Basic Settings¶

resource "qumulo_file_system_settings" "main" {
  connection_profile = "prod"

  permissions_mode = "CROSS_PROTOCOL"
}

Full Configuration¶

resource "qumulo_file_system_settings" "main" {
  connection_profile = "prod"

  # Permissions: NATIVE, CROSS_PROTOCOL, or _DEPRECATED_MERGED_V1
  permissions_mode = "CROSS_PROTOCOL"

  # Access time tracking
  atime_enabled     = true
  atime_granularity = "DAY"  # HOUR, DAY, or WEEK

  # File system notifications
  notify_recursive_mode = "ENABLED"  # DISABLED_ERROR, DISABLED_IGNORE, or ENABLED
}

Multi-Cluster with for_each¶

variable "clusters" {
  type = map(string)
  description = "Map of cluster key to connection profile name"
}

resource "qumulo_file_system_settings" "main" {
  for_each = var.clusters

  connection_profile = each.value

  permissions_mode      = "CROSS_PROTOCOL"
  atime_enabled         = true
  atime_granularity     = "DAY"
  notify_recursive_mode = "ENABLED"
}

Schema¶

Required¶

connection_profile (String) Name of a connection profile from the provider block. See the provider reference for how to define profiles.

Optional¶

atime_enabled (Boolean) Enable access time (atime) tracking. When enabled, file access times are updated based on the granularity setting. Defaults to false.
atime_granularity (String) Granularity for atime updates when enabled. Valid values: HOUR, DAY (default), WEEK.
notify_recursive_mode (String) File system notification recursive mode. Valid values: DISABLED_ERROR (default, returns error for recursive requests), DISABLED_IGNORE (silently ignores recursive flag), ENABLED (allows recursive notifications).
permissions_mode (String) File system permissions mode. Valid values: NATIVE (default), CROSS_PROTOCOL, _DEPRECATED_MERGED_V1.