Skip to content

qumulo_replication_target_relationship (Resource)

Authorizes a replication target relationship on a Qumulo cluster.

A target relationship represents the receiving side of replication. After a source relationship is created on the source cluster, the target cluster must authorize it to begin replication.

Important: This resource does not create a new relationship. It authorizes an existing relationship that was created by the source cluster. Use depends_on to ensure the source relationship is created first.

Example Usage

Installation

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

Basic Authorization

# First, create the source relationship
resource "qumulo_replication_source_relationship" "primary" {
  connection_profile = "source"

  target_address   = "10.0.0.200"
  target_root_path = "/replica"
  source_root_path = "/data"
}

# Then authorize on the target cluster
resource "qumulo_replication_target_relationship" "replica" {
  depends_on = [qumulo_replication_source_relationship.primary]

  connection_profile = "target"

  id = qumulo_replication_source_relationship.primary.id
}

With Path Creation

resource "qumulo_replication_target_relationship" "replica" {
  depends_on = [qumulo_replication_source_relationship.primary]

  connection_profile = "target"

  id                   = qumulo_replication_source_relationship.primary.id
  allow_fs_path_create = true
}

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
    }
  ]
}
- id (String) The unique ID of the replication relationship. This is the same ID as the source relationship.

Optional

  • allow_fs_path_create (Boolean) Allow the target directory to be created if it doesn't exist. Defaults to false.
  • allow_non_empty_directory (Boolean) Allow authorization even if the target directory is not empty. Existing data will be overwritten or deleted. Defaults to false.

Read-Only

  • job_state (String) The current state of the replication job. Possible values: REPLICATION_NOT_RUNNING, REPLICATION_RUNNING.
  • replication_enabled (Boolean) Whether automatic replication is enabled.
  • source_address (String) The IP address of the source cluster.
  • source_cluster_name (String) The name of the source cluster.
  • source_cluster_uuid (String) The UUID of the source cluster.
  • source_port (Number) The replication port on the source cluster.
  • source_root_path (String) The path on the source cluster being replicated.
  • source_root_read_only (Boolean) Whether the source directory is read-only.
  • state (String) The current state of the replication relationship. Possible values: AWAITING_AUTHORIZATION, ESTABLISHED, DISCONNECTED, etc.
  • target_cluster_name (String) The name of this (target) cluster.
  • target_cluster_uuid (String) The UUID of this (target) cluster.
  • target_root_id (String) The file ID of the target directory.
  • target_root_path (String) The path on this cluster where data is replicated to.
  • target_root_read_only (Boolean) Whether the target directory is read-only.