qumulo_s3_settings (Resource)

Manages S3 server settings on a Qumulo cluster.

This is a singleton resource (one per cluster). It configures the global S3 server settings including enabling the S3 service, setting the base path for buckets, and configuring multipart upload behavior.

Example Usage

Installation

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

Basic Settings

resource "qumulo_s3_settings" "main" {
  connection_profile = "prod"

  enabled   = true
  base_path = "/s3-buckets"
}

Settings with Custom Expiry

resource "qumulo_s3_settings" "main" {
  connection_profile = "prod"

  enabled                           = true
  base_path                         = "/data/s3"
  multipart_upload_expiry_interval  = "5days"
  secure                            = true
}

Multi-Cluster with for_each

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

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

  connection_profile = each.value

  enabled   = true
  base_path = "/s3-buckets"
}

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
    }
  ]
}

Optional

• base_path (String) The default bucket directory prefix for all S3 buckets created without an explicitly specified path. Must be an absolute path.
• enabled (Boolean) When enabled, allows the cluster to accept S3 connections. Defaults to false.
• multipart_upload_expiry_interval (String) The time period during which multipart uploads can remain unmodified before being automatically cleaned up. Format: (e.g., '5days', '2weeks'). Use 'never' to disable automatic cleanup. Defaults to '7days'.
• secure (Boolean) If true, the S3 server accepts only HTTPS connections. By default, the S3 server accepts both HTTP and HTTPS. Defaults to false.