Skip to content

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

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 from the provider block. See the provider reference for how to define profiles.

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.