pulumi-gcp-kotlin/com.pulumi.gcp.netapp.kotlin/VolumeReplicationArgs

VolumeReplicationArgs

data class VolumeReplicationArgs(val deleteDestinationVolume: Output<Boolean>? = null, val description: Output<String>? = null, val destinationVolumeParameters: Output<VolumeReplicationDestinationVolumeParametersArgs>? = null, val forceStopping: Output<Boolean>? = null, val labels: Output<Map<String, String>>? = null, val location: Output<String>? = null, val name: Output<String>? = null, val project: Output<String>? = null, val replicationEnabled: Output<Boolean>? = null, val replicationSchedule: Output<String>? = null, val volumeName: Output<String>? = null, val waitForMirror: Output<Boolean>? = null) : ConvertibleToJava<VolumeReplicationArgs>

Example Usage

Netapp Volume Replication Create

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const default = gcp.compute.getNetwork({
    name: "test-network",
});
const sourcePool = new gcp.netapp.StoragePool("source_pool", {
    name: "source-pool",
    location: "us-central1",
    serviceLevel: "PREMIUM",
    capacityGib: "2048",
    network: _default.then(_default => _default.id),
});
const destinationPool = new gcp.netapp.StoragePool("destination_pool", {
    name: "destination-pool",
    location: "us-west2",
    serviceLevel: "PREMIUM",
    capacityGib: "2048",
    network: _default.then(_default => _default.id),
});
const sourceVolume = new gcp.netapp.Volume("source_volume", {
    location: sourcePool.location,
    name: "source-volume",
    capacityGib: "100",
    shareName: "source-volume",
    storagePool: sourcePool.name,
    protocols: ["NFSV3"],
    deletionPolicy: "FORCE",
});
const testReplication = new gcp.netapp.VolumeReplication("test_replication", {
    location: sourceVolume.location,
    volumeName: sourceVolume.name,
    name: "test-replication",
    replicationSchedule: "EVERY_10_MINUTES",
    description: "This is a replication resource",
    destinationVolumeParameters: {
        storagePool: destinationPool.id,
        volumeId: "destination-volume",
        shareName: "source-volume",
        description: "This is a replicated volume",
    },
    deleteDestinationVolume: true,
    waitForMirror: true,
}, {
    dependsOn: [sourceVolume],
});
Content copied to clipboard
import pulumi
import pulumi_gcp as gcp
default = gcp.compute.get_network(name="test-network")
source_pool = gcp.netapp.StoragePool("source_pool",
    name="source-pool",
    location="us-central1",
    service_level="PREMIUM",
    capacity_gib="2048",
    network=default.id)
destination_pool = gcp.netapp.StoragePool("destination_pool",
    name="destination-pool",
    location="us-west2",
    service_level="PREMIUM",
    capacity_gib="2048",
    network=default.id)
source_volume = gcp.netapp.Volume("source_volume",
    location=source_pool.location,
    name="source-volume",
    capacity_gib="100",
    share_name="source-volume",
    storage_pool=source_pool.name,
    protocols=["NFSV3"],
    deletion_policy="FORCE")
test_replication = gcp.netapp.VolumeReplication("test_replication",
    location=source_volume.location,
    volume_name=source_volume.name,
    name="test-replication",
    replication_schedule="EVERY_10_MINUTES",
    description="This is a replication resource",
    destination_volume_parameters={
        "storage_pool": destination_pool.id,
        "volume_id": "destination-volume",
        "share_name": "source-volume",
        "description": "This is a replicated volume",
    },
    delete_destination_volume=True,
    wait_for_mirror=True,
    opts = pulumi.ResourceOptions(depends_on=[source_volume]))
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
    var @default = Gcp.Compute.GetNetwork.Invoke(new()
    {
        Name = "test-network",
    });
    var sourcePool = new Gcp.Netapp.StoragePool("source_pool", new()
    {
        Name = "source-pool",
        Location = "us-central1",
        ServiceLevel = "PREMIUM",
        CapacityGib = "2048",
        Network = @default.Apply(@default => @default.Apply(getNetworkResult => getNetworkResult.Id)),
    });
    var destinationPool = new Gcp.Netapp.StoragePool("destination_pool", new()
    {
        Name = "destination-pool",
        Location = "us-west2",
        ServiceLevel = "PREMIUM",
        CapacityGib = "2048",
        Network = @default.Apply(@default => @default.Apply(getNetworkResult => getNetworkResult.Id)),
    });
    var sourceVolume = new Gcp.Netapp.Volume("source_volume", new()
    {
        Location = sourcePool.Location,
        Name = "source-volume",
        CapacityGib = "100",
        ShareName = "source-volume",
        StoragePool = sourcePool.Name,
        Protocols = new[]
        {
            "NFSV3",
        },
        DeletionPolicy = "FORCE",
    });
    var testReplication = new Gcp.Netapp.VolumeReplication("test_replication", new()
    {
        Location = sourceVolume.Location,
        VolumeName = sourceVolume.Name,
        Name = "test-replication",
        ReplicationSchedule = "EVERY_10_MINUTES",
        Description = "This is a replication resource",
        DestinationVolumeParameters = new Gcp.Netapp.Inputs.VolumeReplicationDestinationVolumeParametersArgs
        {
            StoragePool = destinationPool.Id,
            VolumeId = "destination-volume",
            ShareName = "source-volume",
            Description = "This is a replicated volume",
        },
        DeleteDestinationVolume = true,
        WaitForMirror = true,
    }, new CustomResourceOptions
    {
        DependsOn =
        {
            sourceVolume,
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/netapp"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_default, err := compute.LookupNetwork(ctx, &compute.LookupNetworkArgs{
			Name: "test-network",
		}, nil)
		if err != nil {
			return err
		}
		sourcePool, err := netapp.NewStoragePool(ctx, "source_pool", &netapp.StoragePoolArgs{
			Name:         pulumi.String("source-pool"),
			Location:     pulumi.String("us-central1"),
			ServiceLevel: pulumi.String("PREMIUM"),
			CapacityGib:  pulumi.String("2048"),
			Network:      pulumi.String(_default.Id),
		})
		if err != nil {
			return err
		}
		destinationPool, err := netapp.NewStoragePool(ctx, "destination_pool", &netapp.StoragePoolArgs{
			Name:         pulumi.String("destination-pool"),
			Location:     pulumi.String("us-west2"),
			ServiceLevel: pulumi.String("PREMIUM"),
			CapacityGib:  pulumi.String("2048"),
			Network:      pulumi.String(_default.Id),
		})
		if err != nil {
			return err
		}
		sourceVolume, err := netapp.NewVolume(ctx, "source_volume", &netapp.VolumeArgs{
			Location:    sourcePool.Location,
			Name:        pulumi.String("source-volume"),
			CapacityGib: pulumi.String("100"),
			ShareName:   pulumi.String("source-volume"),
			StoragePool: sourcePool.Name,
			Protocols: pulumi.StringArray{
				pulumi.String("NFSV3"),
			},
			DeletionPolicy: pulumi.String("FORCE"),
		})
		if err != nil {
			return err
		}
		_, err = netapp.NewVolumeReplication(ctx, "test_replication", &netapp.VolumeReplicationArgs{
			Location:            sourceVolume.Location,
			VolumeName:          sourceVolume.Name,
			Name:                pulumi.String("test-replication"),
			ReplicationSchedule: pulumi.String("EVERY_10_MINUTES"),
			Description:         pulumi.String("This is a replication resource"),
			DestinationVolumeParameters: &netapp.VolumeReplicationDestinationVolumeParametersArgs{
				StoragePool: destinationPool.ID(),
				VolumeId:    pulumi.String("destination-volume"),
				ShareName:   pulumi.String("source-volume"),
				Description: pulumi.String("This is a replicated volume"),
			},
			DeleteDestinationVolume: pulumi.Bool(true),
			WaitForMirror:           pulumi.Bool(true),
		}, pulumi.DependsOn([]pulumi.Resource{
			sourceVolume,
		}))
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.ComputeFunctions;
import com.pulumi.gcp.compute.inputs.GetNetworkArgs;
import com.pulumi.gcp.netapp.StoragePool;
import com.pulumi.gcp.netapp.StoragePoolArgs;
import com.pulumi.gcp.netapp.Volume;
import com.pulumi.gcp.netapp.VolumeArgs;
import com.pulumi.gcp.netapp.VolumeReplication;
import com.pulumi.gcp.netapp.VolumeReplicationArgs;
import com.pulumi.gcp.netapp.inputs.VolumeReplicationDestinationVolumeParametersArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var default = ComputeFunctions.getNetwork(GetNetworkArgs.builder()
            .name("test-network")
            .build());
        var sourcePool = new StoragePool("sourcePool", StoragePoolArgs.builder()
            .name("source-pool")
            .location("us-central1")
            .serviceLevel("PREMIUM")
            .capacityGib(2048)
            .network(default_.id())
            .build());
        var destinationPool = new StoragePool("destinationPool", StoragePoolArgs.builder()
            .name("destination-pool")
            .location("us-west2")
            .serviceLevel("PREMIUM")
            .capacityGib(2048)
            .network(default_.id())
            .build());
        var sourceVolume = new Volume("sourceVolume", VolumeArgs.builder()
            .location(sourcePool.location())
            .name("source-volume")
            .capacityGib(100)
            .shareName("source-volume")
            .storagePool(sourcePool.name())
            .protocols("NFSV3")
            .deletionPolicy("FORCE")
            .build());
        var testReplication = new VolumeReplication("testReplication", VolumeReplicationArgs.builder()
            .location(sourceVolume.location())
            .volumeName(sourceVolume.name())
            .name("test-replication")
            .replicationSchedule("EVERY_10_MINUTES")
            .description("This is a replication resource")
            .destinationVolumeParameters(VolumeReplicationDestinationVolumeParametersArgs.builder()
                .storagePool(destinationPool.id())
                .volumeId("destination-volume")
                .shareName("source-volume")
                .description("This is a replicated volume")
                .build())
            .deleteDestinationVolume(true)
            .waitForMirror(true)
            .build(), CustomResourceOptions.builder()
                .dependsOn(sourceVolume)
                .build());
    }
}
Content copied to clipboard
resources:
  sourcePool:
    type: gcp:netapp:StoragePool
    name: source_pool
    properties:
      name: source-pool
      location: us-central1
      serviceLevel: PREMIUM
      capacityGib: 2048
      network: ${default.id}
  destinationPool:
    type: gcp:netapp:StoragePool
    name: destination_pool
    properties:
      name: destination-pool
      location: us-west2
      serviceLevel: PREMIUM
      capacityGib: 2048
      network: ${default.id}
  sourceVolume:
    type: gcp:netapp:Volume
    name: source_volume
    properties:
      location: ${sourcePool.location}
      name: source-volume
      capacityGib: 100
      shareName: source-volume
      storagePool: ${sourcePool.name}
      protocols:
        - NFSV3
      deletionPolicy: FORCE
  testReplication:
    type: gcp:netapp:VolumeReplication
    name: test_replication
    properties:
      location: ${sourceVolume.location}
      volumeName: ${sourceVolume.name}
      name: test-replication
      replicationSchedule: EVERY_10_MINUTES
      description: This is a replication resource
      destinationVolumeParameters:
        storagePool: ${destinationPool.id}
        volumeId: destination-volume
        shareName: source-volume
        description: This is a replicated volume
      deleteDestinationVolume: true
      waitForMirror: true
    options:
      dependson:
        - ${sourceVolume}
variables:
  default:
    fn::invoke:
      Function: gcp:compute:getNetwork
      Arguments:
        name: test-network
Content copied to clipboard

Import

VolumeReplication can be imported using any of these accepted formats:

  • projects/{{project}}/locations/{{location}}/volumes/{{volume_name}}/replications/{{name}}

  • {{project}}/{{location}}/{{volume_name}}/{{name}}

  • {{location}}/{{volume_name}}/{{name}} When using the pulumi import command, VolumeReplication can be imported using one of the formats above. For example:

$ pulumi import gcp:netapp/volumeReplication:VolumeReplication default projects/{{project}}/locations/{{location}}/volumes/{{volume_name}}/replications/{{name}}
Content copied to clipboard
$ pulumi import gcp:netapp/volumeReplication:VolumeReplication default {{project}}/{{location}}/{{volume_name}}/{{name}}
Content copied to clipboard
$ pulumi import gcp:netapp/volumeReplication:VolumeReplication default {{location}}/{{volume_name}}/{{name}}
Content copied to clipboard

Constructors

Link copied to clipboard
constructor(deleteDestinationVolume: Output<Boolean>? = null, description: Output<String>? = null, destinationVolumeParameters: Output<VolumeReplicationDestinationVolumeParametersArgs>? = null, forceStopping: Output<Boolean>? = null, labels: Output<Map<String, String>>? = null, location: Output<String>? = null, name: Output<String>? = null, project: Output<String>? = null, replicationEnabled: Output<Boolean>? = null, replicationSchedule: Output<String>? = null, volumeName: Output<String>? = null, waitForMirror: Output<Boolean>? = null)

Properties

Link copied to clipboard
val deleteDestinationVolume: Output<Boolean>? = null
Link copied to clipboard
val description: Output<String>? = null

An description of this resource.

Link copied to clipboard
val destinationVolumeParameters: Output<VolumeReplicationDestinationVolumeParametersArgs>? = null

Destination volume parameters. Structure is documented below.

Link copied to clipboard
val forceStopping: Output<Boolean>? = null

Only replications with mirror_state=MIRRORED can be stopped. A replication in mirror_state=TRANSFERRING currently receives an update and stopping the update might be undesirable. Set this parameter to true to stop anyway. All data transferred to the destination will be discarded and content of destination volume will remain at the state of the last successful update. Default is false.

Link copied to clipboard
val labels: Output<Map<String, String>>? = null

Labels as key value pairs. Example: { "owner": "Bob", "department": "finance", "purpose": "testing" } Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

Link copied to clipboard
val location: Output<String>? = null

Name of region for this resource. The resource needs to be created in the region of the destination volume.

Link copied to clipboard
val name: Output<String>? = null

The name of the replication. Needs to be unique per location.

Link copied to clipboard
val project: Output<String>? = null

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Link copied to clipboard
val replicationEnabled: Output<Boolean>? = null

Set to false to stop/break the mirror. Stopping the mirror makes the destination volume read-write and act independently from the source volume. Set to true to enable/resume the mirror. WARNING: Resuming a mirror overwrites any changes done to the destination volume with the content of the source volume.

Link copied to clipboard
val replicationSchedule: Output<String>? = null

Specifies the replication interval. Possible values are: EVERY_10_MINUTES, HOURLY, DAILY.

Link copied to clipboard
val volumeName: Output<String>? = null

The name of the existing source volume.

Link copied to clipboard
val waitForMirror: Output<Boolean>? = null

Functions

Link copied to clipboard
open override fun toJava(): VolumeReplicationArgs