1. Packages
  2. HashiCorp Nomad
  3. API Docs
  4. CsiVolume
Nomad v2.0.0 published on Wednesday, Sep 13, 2023 by Pulumi

nomad.CsiVolume

Explore with Pulumi AI

nomad logo
Nomad v2.0.0 published on Wednesday, Sep 13, 2023 by Pulumi

    Example Usage

    Creating a volume

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Nomad = Pulumi.Nomad;
    
    return await Deployment.RunAsync(() => 
    {
        var ebs = Nomad.GetPlugin.Invoke(new()
        {
            PluginId = "aws-ebs0",
            WaitForHealthy = true,
        });
    
        var mysqlVolume = new Nomad.CsiVolume("mysqlVolume", new()
        {
            PluginId = "aws-ebs0",
            VolumeId = "mysql_volume",
            CapacityMin = "10GiB",
            CapacityMax = "20GiB",
            Capabilities = new[]
            {
                new Nomad.Inputs.CsiVolumeCapabilityArgs
                {
                    AccessMode = "single-node-writer",
                    AttachmentMode = "file-system",
                },
            },
            MountOptions = new Nomad.Inputs.CsiVolumeMountOptionsArgs
            {
                FsType = "ext4",
            },
            TopologyRequest = new Nomad.Inputs.CsiVolumeTopologyRequestArgs
            {
                Required = new Nomad.Inputs.CsiVolumeTopologyRequestRequiredArgs
                {
                    Topologies = new[]
                    {
                        new Nomad.Inputs.CsiVolumeTopologyRequestRequiredTopologyArgs
                        {
                            Segments = 
                            {
                                { "rack", "R1" },
                                { "zone", "us-east-1a" },
                            },
                        },
                        new Nomad.Inputs.CsiVolumeTopologyRequestRequiredTopologyArgs
                        {
                            Segments = 
                            {
                                { "rack", "R2" },
                            },
                        },
                    },
                },
            },
        }, new CustomResourceOptions
        {
            DependsOn = new[]
            {
                ebs,
            },
        });
    
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-nomad/sdk/v2/go/nomad"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		ebs, err := nomad.GetPlugin(ctx, &nomad.GetPluginArgs{
    			PluginId:       "aws-ebs0",
    			WaitForHealthy: pulumi.BoolRef(true),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		_, err = nomad.NewCsiVolume(ctx, "mysqlVolume", &nomad.CsiVolumeArgs{
    			PluginId:    pulumi.String("aws-ebs0"),
    			VolumeId:    pulumi.String("mysql_volume"),
    			CapacityMin: pulumi.String("10GiB"),
    			CapacityMax: pulumi.String("20GiB"),
    			Capabilities: nomad.CsiVolumeCapabilityArray{
    				&nomad.CsiVolumeCapabilityArgs{
    					AccessMode:     pulumi.String("single-node-writer"),
    					AttachmentMode: pulumi.String("file-system"),
    				},
    			},
    			MountOptions: &nomad.CsiVolumeMountOptionsArgs{
    				FsType: pulumi.String("ext4"),
    			},
    			TopologyRequest: &nomad.CsiVolumeTopologyRequestArgs{
    				Required: &nomad.CsiVolumeTopologyRequestRequiredArgs{
    					Topologies: nomad.CsiVolumeTopologyRequestRequiredTopologyArray{
    						&nomad.CsiVolumeTopologyRequestRequiredTopologyArgs{
    							Segments: pulumi.StringMap{
    								"rack": pulumi.String("R1"),
    								"zone": pulumi.String("us-east-1a"),
    							},
    						},
    						&nomad.CsiVolumeTopologyRequestRequiredTopologyArgs{
    							Segments: pulumi.StringMap{
    								"rack": pulumi.String("R2"),
    							},
    						},
    					},
    				},
    			},
    		}, pulumi.DependsOn([]pulumi.Resource{
    			ebs,
    		}))
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.nomad.NomadFunctions;
    import com.pulumi.nomad.inputs.GetPluginArgs;
    import com.pulumi.nomad.CsiVolume;
    import com.pulumi.nomad.CsiVolumeArgs;
    import com.pulumi.nomad.inputs.CsiVolumeCapabilityArgs;
    import com.pulumi.nomad.inputs.CsiVolumeMountOptionsArgs;
    import com.pulumi.nomad.inputs.CsiVolumeTopologyRequestArgs;
    import com.pulumi.nomad.inputs.CsiVolumeTopologyRequestRequiredArgs;
    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 ebs = NomadFunctions.getPlugin(GetPluginArgs.builder()
                .pluginId("aws-ebs0")
                .waitForHealthy(true)
                .build());
    
            var mysqlVolume = new CsiVolume("mysqlVolume", CsiVolumeArgs.builder()        
                .pluginId("aws-ebs0")
                .volumeId("mysql_volume")
                .capacityMin("10GiB")
                .capacityMax("20GiB")
                .capabilities(CsiVolumeCapabilityArgs.builder()
                    .accessMode("single-node-writer")
                    .attachmentMode("file-system")
                    .build())
                .mountOptions(CsiVolumeMountOptionsArgs.builder()
                    .fsType("ext4")
                    .build())
                .topologyRequest(CsiVolumeTopologyRequestArgs.builder()
                    .required(CsiVolumeTopologyRequestRequiredArgs.builder()
                        .topologies(                    
                            CsiVolumeTopologyRequestRequiredTopologyArgs.builder()
                                .segments(Map.ofEntries(
                                    Map.entry("rack", "R1"),
                                    Map.entry("zone", "us-east-1a")
                                ))
                                .build(),
                            CsiVolumeTopologyRequestRequiredTopologyArgs.builder()
                                .segments(Map.of("rack", "R2"))
                                .build())
                        .build())
                    .build())
                .build(), CustomResourceOptions.builder()
                    .dependsOn(ebs.applyValue(getPluginResult -> getPluginResult))
                    .build());
    
        }
    }
    
    import pulumi
    import pulumi_nomad as nomad
    
    ebs = nomad.get_plugin(plugin_id="aws-ebs0",
        wait_for_healthy=True)
    mysql_volume = nomad.CsiVolume("mysqlVolume",
        plugin_id="aws-ebs0",
        volume_id="mysql_volume",
        capacity_min="10GiB",
        capacity_max="20GiB",
        capabilities=[nomad.CsiVolumeCapabilityArgs(
            access_mode="single-node-writer",
            attachment_mode="file-system",
        )],
        mount_options=nomad.CsiVolumeMountOptionsArgs(
            fs_type="ext4",
        ),
        topology_request=nomad.CsiVolumeTopologyRequestArgs(
            required=nomad.CsiVolumeTopologyRequestRequiredArgs(
                topologies=[
                    nomad.CsiVolumeTopologyRequestRequiredTopologyArgs(
                        segments={
                            "rack": "R1",
                            "zone": "us-east-1a",
                        },
                    ),
                    nomad.CsiVolumeTopologyRequestRequiredTopologyArgs(
                        segments={
                            "rack": "R2",
                        },
                    ),
                ],
            ),
        ),
        opts=pulumi.ResourceOptions(depends_on=[ebs]))
    
    import * as pulumi from "@pulumi/pulumi";
    import * as nomad from "@pulumi/nomad";
    
    const ebs = nomad.getPlugin({
        pluginId: "aws-ebs0",
        waitForHealthy: true,
    });
    const mysqlVolume = new nomad.CsiVolume("mysqlVolume", {
        pluginId: "aws-ebs0",
        volumeId: "mysql_volume",
        capacityMin: "10GiB",
        capacityMax: "20GiB",
        capabilities: [{
            accessMode: "single-node-writer",
            attachmentMode: "file-system",
        }],
        mountOptions: {
            fsType: "ext4",
        },
        topologyRequest: {
            required: {
                topologies: [
                    {
                        segments: {
                            rack: "R1",
                            zone: "us-east-1a",
                        },
                    },
                    {
                        segments: {
                            rack: "R2",
                        },
                    },
                ],
            },
        },
    }, {
        dependsOn: [ebs],
    });
    
    resources:
      mysqlVolume:
        type: nomad:CsiVolume
        properties:
          pluginId: aws-ebs0
          volumeId: mysql_volume
          capacityMin: 10GiB
          capacityMax: 20GiB
          capabilities:
            - accessMode: single-node-writer
              attachmentMode: file-system
          mountOptions:
            fsType: ext4
          topologyRequest:
            required:
              topologies:
                - segments:
                    rack: R1
                    zone: us-east-1a
                - segments:
                    rack: R2
        options:
          dependson:
            - ${ebs}
    variables:
      ebs:
        fn::invoke:
          Function: nomad:getPlugin
          Arguments:
            pluginId: aws-ebs0
            waitForHealthy: true
    

    Create CsiVolume Resource

    new CsiVolume(name: string, args: CsiVolumeArgs, opts?: CustomResourceOptions);
    @overload
    def CsiVolume(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  capabilities: Optional[Sequence[CsiVolumeCapabilityArgs]] = None,
                  capacity_max: Optional[str] = None,
                  capacity_min: Optional[str] = None,
                  clone_id: Optional[str] = None,
                  mount_options: Optional[CsiVolumeMountOptionsArgs] = None,
                  name: Optional[str] = None,
                  namespace: Optional[str] = None,
                  parameters: Optional[Mapping[str, str]] = None,
                  plugin_id: Optional[str] = None,
                  secrets: Optional[Mapping[str, str]] = None,
                  snapshot_id: Optional[str] = None,
                  topology_request: Optional[CsiVolumeTopologyRequestArgs] = None,
                  volume_id: Optional[str] = None)
    @overload
    def CsiVolume(resource_name: str,
                  args: CsiVolumeArgs,
                  opts: Optional[ResourceOptions] = None)
    func NewCsiVolume(ctx *Context, name string, args CsiVolumeArgs, opts ...ResourceOption) (*CsiVolume, error)
    public CsiVolume(string name, CsiVolumeArgs args, CustomResourceOptions? opts = null)
    public CsiVolume(String name, CsiVolumeArgs args)
    public CsiVolume(String name, CsiVolumeArgs args, CustomResourceOptions options)
    
    type: nomad:CsiVolume
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    name string
    The unique name of the resource.
    args CsiVolumeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args CsiVolumeArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args CsiVolumeArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CsiVolumeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CsiVolumeArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    CsiVolume Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The CsiVolume resource accepts the following input properties:

    Capabilities List<CsiVolumeCapability>

    (``Capability``: <required>) - Options for validating the capability of a volume.

    PluginId string

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    VolumeId string

    (string: <required>) - The unique ID of the volume.

    CapacityMax string

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    CapacityMin string

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    CloneId string

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    MountOptions CsiVolumeMountOptions

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    Name string

    (string: <required>) - The display name for the volume.

    Namespace string

    (string: "default") - The namespace in which to register the volume.

    Parameters Dictionary<string, string>

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    Secrets Dictionary<string, string>

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    SnapshotId string

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    TopologyRequest CsiVolumeTopologyRequest

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    Capabilities []CsiVolumeCapabilityArgs

    (``Capability``: <required>) - Options for validating the capability of a volume.

    PluginId string

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    VolumeId string

    (string: <required>) - The unique ID of the volume.

    CapacityMax string

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    CapacityMin string

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    CloneId string

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    MountOptions CsiVolumeMountOptionsArgs

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    Name string

    (string: <required>) - The display name for the volume.

    Namespace string

    (string: "default") - The namespace in which to register the volume.

    Parameters map[string]string

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    Secrets map[string]string

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    SnapshotId string

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    TopologyRequest CsiVolumeTopologyRequestArgs

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    capabilities List<CsiVolumeCapability>

    (``Capability``: <required>) - Options for validating the capability of a volume.

    pluginId String

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    volumeId String

    (string: <required>) - The unique ID of the volume.

    capacityMax String

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    capacityMin String

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    cloneId String

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    mountOptions CsiVolumeMountOptions

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    name String

    (string: <required>) - The display name for the volume.

    namespace String

    (string: "default") - The namespace in which to register the volume.

    parameters Map<String,String>

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    secrets Map<String,String>

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    snapshotId String

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    topologyRequest CsiVolumeTopologyRequest

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    capabilities CsiVolumeCapability[]

    (``Capability``: <required>) - Options for validating the capability of a volume.

    pluginId string

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    volumeId string

    (string: <required>) - The unique ID of the volume.

    capacityMax string

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    capacityMin string

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    cloneId string

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    mountOptions CsiVolumeMountOptions

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    name string

    (string: <required>) - The display name for the volume.

    namespace string

    (string: "default") - The namespace in which to register the volume.

    parameters {[key: string]: string}

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    secrets {[key: string]: string}

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    snapshotId string

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    topologyRequest CsiVolumeTopologyRequest

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    capabilities Sequence[CsiVolumeCapabilityArgs]

    (``Capability``: <required>) - Options for validating the capability of a volume.

    plugin_id str

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    volume_id str

    (string: <required>) - The unique ID of the volume.

    capacity_max str

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    capacity_min str

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    clone_id str

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    mount_options CsiVolumeMountOptionsArgs

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    name str

    (string: <required>) - The display name for the volume.

    namespace str

    (string: "default") - The namespace in which to register the volume.

    parameters Mapping[str, str]

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    secrets Mapping[str, str]

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    snapshot_id str

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    topology_request CsiVolumeTopologyRequestArgs

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    capabilities List<Property Map>

    (``Capability``: <required>) - Options for validating the capability of a volume.

    pluginId String

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    volumeId String

    (string: <required>) - The unique ID of the volume.

    capacityMax String

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    capacityMin String

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    cloneId String

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    mountOptions Property Map

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    name String

    (string: <required>) - The display name for the volume.

    namespace String

    (string: "default") - The namespace in which to register the volume.

    parameters Map<String>

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    secrets Map<String>

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    snapshotId String

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    topologyRequest Property Map

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the CsiVolume resource produces the following output properties:

    ControllerRequired bool

    (boolean)

    ControllersExpected int

    (integer)

    ControllersHealthy int

    (integer)

    Id string

    The provider-assigned unique ID for this managed resource.

    NodesExpected int

    (integer)

    NodesHealthy int

    (integer)

    PluginProvider string

    (string)

    PluginProviderVersion string

    (string)

    Schedulable bool

    (boolean)

    Topologies List<CsiVolumeTopology>

    (List of topologies)

    ControllerRequired bool

    (boolean)

    ControllersExpected int

    (integer)

    ControllersHealthy int

    (integer)

    Id string

    The provider-assigned unique ID for this managed resource.

    NodesExpected int

    (integer)

    NodesHealthy int

    (integer)

    PluginProvider string

    (string)

    PluginProviderVersion string

    (string)

    Schedulable bool

    (boolean)

    Topologies []CsiVolumeTopology

    (List of topologies)

    controllerRequired Boolean

    (boolean)

    controllersExpected Integer

    (integer)

    controllersHealthy Integer

    (integer)

    id String

    The provider-assigned unique ID for this managed resource.

    nodesExpected Integer

    (integer)

    nodesHealthy Integer

    (integer)

    pluginProvider String

    (string)

    pluginProviderVersion String

    (string)

    schedulable Boolean

    (boolean)

    topologies List<CsiVolumeTopology>

    (List of topologies)

    controllerRequired boolean

    (boolean)

    controllersExpected number

    (integer)

    controllersHealthy number

    (integer)

    id string

    The provider-assigned unique ID for this managed resource.

    nodesExpected number

    (integer)

    nodesHealthy number

    (integer)

    pluginProvider string

    (string)

    pluginProviderVersion string

    (string)

    schedulable boolean

    (boolean)

    topologies CsiVolumeTopology[]

    (List of topologies)

    controller_required bool

    (boolean)

    controllers_expected int

    (integer)

    controllers_healthy int

    (integer)

    id str

    The provider-assigned unique ID for this managed resource.

    nodes_expected int

    (integer)

    nodes_healthy int

    (integer)

    plugin_provider str

    (string)

    plugin_provider_version str

    (string)

    schedulable bool

    (boolean)

    topologies Sequence[CsiVolumeTopology]

    (List of topologies)

    controllerRequired Boolean

    (boolean)

    controllersExpected Number

    (integer)

    controllersHealthy Number

    (integer)

    id String

    The provider-assigned unique ID for this managed resource.

    nodesExpected Number

    (integer)

    nodesHealthy Number

    (integer)

    pluginProvider String

    (string)

    pluginProviderVersion String

    (string)

    schedulable Boolean

    (boolean)

    topologies List<Property Map>

    (List of topologies)

    Look up Existing CsiVolume Resource

    Get an existing CsiVolume resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: CsiVolumeState, opts?: CustomResourceOptions): CsiVolume
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            capabilities: Optional[Sequence[CsiVolumeCapabilityArgs]] = None,
            capacity_max: Optional[str] = None,
            capacity_min: Optional[str] = None,
            clone_id: Optional[str] = None,
            controller_required: Optional[bool] = None,
            controllers_expected: Optional[int] = None,
            controllers_healthy: Optional[int] = None,
            mount_options: Optional[CsiVolumeMountOptionsArgs] = None,
            name: Optional[str] = None,
            namespace: Optional[str] = None,
            nodes_expected: Optional[int] = None,
            nodes_healthy: Optional[int] = None,
            parameters: Optional[Mapping[str, str]] = None,
            plugin_id: Optional[str] = None,
            plugin_provider: Optional[str] = None,
            plugin_provider_version: Optional[str] = None,
            schedulable: Optional[bool] = None,
            secrets: Optional[Mapping[str, str]] = None,
            snapshot_id: Optional[str] = None,
            topologies: Optional[Sequence[CsiVolumeTopologyArgs]] = None,
            topology_request: Optional[CsiVolumeTopologyRequestArgs] = None,
            volume_id: Optional[str] = None) -> CsiVolume
    func GetCsiVolume(ctx *Context, name string, id IDInput, state *CsiVolumeState, opts ...ResourceOption) (*CsiVolume, error)
    public static CsiVolume Get(string name, Input<string> id, CsiVolumeState? state, CustomResourceOptions? opts = null)
    public static CsiVolume get(String name, Output<String> id, CsiVolumeState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Capabilities List<CsiVolumeCapability>

    (``Capability``: <required>) - Options for validating the capability of a volume.

    CapacityMax string

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    CapacityMin string

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    CloneId string

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    ControllerRequired bool

    (boolean)

    ControllersExpected int

    (integer)

    ControllersHealthy int

    (integer)

    MountOptions CsiVolumeMountOptions

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    Name string

    (string: <required>) - The display name for the volume.

    Namespace string

    (string: "default") - The namespace in which to register the volume.

    NodesExpected int

    (integer)

    NodesHealthy int

    (integer)

    Parameters Dictionary<string, string>

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    PluginId string

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    PluginProvider string

    (string)

    PluginProviderVersion string

    (string)

    Schedulable bool

    (boolean)

    Secrets Dictionary<string, string>

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    SnapshotId string

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    Topologies List<CsiVolumeTopology>

    (List of topologies)

    TopologyRequest CsiVolumeTopologyRequest

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    VolumeId string

    (string: <required>) - The unique ID of the volume.

    Capabilities []CsiVolumeCapabilityArgs

    (``Capability``: <required>) - Options for validating the capability of a volume.

    CapacityMax string

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    CapacityMin string

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    CloneId string

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    ControllerRequired bool

    (boolean)

    ControllersExpected int

    (integer)

    ControllersHealthy int

    (integer)

    MountOptions CsiVolumeMountOptionsArgs

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    Name string

    (string: <required>) - The display name for the volume.

    Namespace string

    (string: "default") - The namespace in which to register the volume.

    NodesExpected int

    (integer)

    NodesHealthy int

    (integer)

    Parameters map[string]string

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    PluginId string

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    PluginProvider string

    (string)

    PluginProviderVersion string

    (string)

    Schedulable bool

    (boolean)

    Secrets map[string]string

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    SnapshotId string

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    Topologies []CsiVolumeTopologyArgs

    (List of topologies)

    TopologyRequest CsiVolumeTopologyRequestArgs

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    VolumeId string

    (string: <required>) - The unique ID of the volume.

    capabilities List<CsiVolumeCapability>

    (``Capability``: <required>) - Options for validating the capability of a volume.

    capacityMax String

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    capacityMin String

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    cloneId String

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    controllerRequired Boolean

    (boolean)

    controllersExpected Integer

    (integer)

    controllersHealthy Integer

    (integer)

    mountOptions CsiVolumeMountOptions

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    name String

    (string: <required>) - The display name for the volume.

    namespace String

    (string: "default") - The namespace in which to register the volume.

    nodesExpected Integer

    (integer)

    nodesHealthy Integer

    (integer)

    parameters Map<String,String>

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    pluginId String

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    pluginProvider String

    (string)

    pluginProviderVersion String

    (string)

    schedulable Boolean

    (boolean)

    secrets Map<String,String>

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    snapshotId String

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    topologies List<CsiVolumeTopology>

    (List of topologies)

    topologyRequest CsiVolumeTopologyRequest

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    volumeId String

    (string: <required>) - The unique ID of the volume.

    capabilities CsiVolumeCapability[]

    (``Capability``: <required>) - Options for validating the capability of a volume.

    capacityMax string

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    capacityMin string

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    cloneId string

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    controllerRequired boolean

    (boolean)

    controllersExpected number

    (integer)

    controllersHealthy number

    (integer)

    mountOptions CsiVolumeMountOptions

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    name string

    (string: <required>) - The display name for the volume.

    namespace string

    (string: "default") - The namespace in which to register the volume.

    nodesExpected number

    (integer)

    nodesHealthy number

    (integer)

    parameters {[key: string]: string}

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    pluginId string

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    pluginProvider string

    (string)

    pluginProviderVersion string

    (string)

    schedulable boolean

    (boolean)

    secrets {[key: string]: string}

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    snapshotId string

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    topologies CsiVolumeTopology[]

    (List of topologies)

    topologyRequest CsiVolumeTopologyRequest

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    volumeId string

    (string: <required>) - The unique ID of the volume.

    capabilities Sequence[CsiVolumeCapabilityArgs]

    (``Capability``: <required>) - Options for validating the capability of a volume.

    capacity_max str

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    capacity_min str

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    clone_id str

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    controller_required bool

    (boolean)

    controllers_expected int

    (integer)

    controllers_healthy int

    (integer)

    mount_options CsiVolumeMountOptionsArgs

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    name str

    (string: <required>) - The display name for the volume.

    namespace str

    (string: "default") - The namespace in which to register the volume.

    nodes_expected int

    (integer)

    nodes_healthy int

    (integer)

    parameters Mapping[str, str]

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    plugin_id str

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    plugin_provider str

    (string)

    plugin_provider_version str

    (string)

    schedulable bool

    (boolean)

    secrets Mapping[str, str]

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    snapshot_id str

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    topologies Sequence[CsiVolumeTopologyArgs]

    (List of topologies)

    topology_request CsiVolumeTopologyRequestArgs

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    volume_id str

    (string: <required>) - The unique ID of the volume.

    capabilities List<Property Map>

    (``Capability``: <required>) - Options for validating the capability of a volume.

    capacityMax String

    (string: <optional>) - Option to signal a maximum volume size. This may not be supported by all storage providers.

    capacityMin String

    (string: <optional>) - Option to signal a minimum volume size. This may not be supported by all storage providers.

    cloneId String

    (string: <optional>) - The external ID of an existing volume to restore. If ommited, the volume will be created from scratch. Conflicts with snapshot_id.

    controllerRequired Boolean

    (boolean)

    controllersExpected Number

    (integer)

    controllersHealthy Number

    (integer)

    mountOptions Property Map

    (block: optional) Options for mounting block-device volumes without a pre-formatted file system.

    name String

    (string: <required>) - The display name for the volume.

    namespace String

    (string: "default") - The namespace in which to register the volume.

    nodesExpected Number

    (integer)

    nodesHealthy Number

    (integer)

    parameters Map<String>

    (map[string]string: optional) An optional key-value map of strings passed directly to the CSI plugin to configure the volume.

    pluginId String

    (string: <required>) - The ID of the Nomad plugin for registering this volume.

    pluginProvider String

    (string)

    pluginProviderVersion String

    (string)

    schedulable Boolean

    (boolean)

    secrets Map<String>

    (map[string]string: optional) An optional key-value map of strings used as credentials for publishing and unpublishing volumes.

    snapshotId String

    (string: <optional>) - The external ID of a snapshot to restore. If ommited, the volume will be created from scratch. Conflicts with clone_id.

    topologies List<Property Map>

    (List of topologies)

    topologyRequest Property Map

    (``TopologyRequest``: <optional>) - Specify locations (region, zone, rack, etc.) where the provisioned volume is accessible from.

    volumeId String

    (string: <required>) - The unique ID of the volume.

    Supporting Types

    CsiVolumeCapability, CsiVolumeCapabilityArgs

    AccessMode string

    (string: <required>) - Defines whether a volume should be available concurrently. Possible values are:

    • single-node-reader-only
    • single-node-writer
    • multi-node-reader-only
    • multi-node-single-writer
    • multi-node-multi-writer
    AttachmentMode string

    (string: <required>) - The storage API that will be used by the volume. Possible values are:

    • block-device
    • file-system
    AccessMode string

    (string: <required>) - Defines whether a volume should be available concurrently. Possible values are:

    • single-node-reader-only
    • single-node-writer
    • multi-node-reader-only
    • multi-node-single-writer
    • multi-node-multi-writer
    AttachmentMode string

    (string: <required>) - The storage API that will be used by the volume. Possible values are:

    • block-device
    • file-system
    accessMode String

    (string: <required>) - Defines whether a volume should be available concurrently. Possible values are:

    • single-node-reader-only
    • single-node-writer
    • multi-node-reader-only
    • multi-node-single-writer
    • multi-node-multi-writer
    attachmentMode String

    (string: <required>) - The storage API that will be used by the volume. Possible values are:

    • block-device
    • file-system
    accessMode string

    (string: <required>) - Defines whether a volume should be available concurrently. Possible values are:

    • single-node-reader-only
    • single-node-writer
    • multi-node-reader-only
    • multi-node-single-writer
    • multi-node-multi-writer
    attachmentMode string

    (string: <required>) - The storage API that will be used by the volume. Possible values are:

    • block-device
    • file-system
    access_mode str

    (string: <required>) - Defines whether a volume should be available concurrently. Possible values are:

    • single-node-reader-only
    • single-node-writer
    • multi-node-reader-only
    • multi-node-single-writer
    • multi-node-multi-writer
    attachment_mode str

    (string: <required>) - The storage API that will be used by the volume. Possible values are:

    • block-device
    • file-system
    accessMode String

    (string: <required>) - Defines whether a volume should be available concurrently. Possible values are:

    • single-node-reader-only
    • single-node-writer
    • multi-node-reader-only
    • multi-node-single-writer
    • multi-node-multi-writer
    attachmentMode String

    (string: <required>) - The storage API that will be used by the volume. Possible values are:

    • block-device
    • file-system

    CsiVolumeMountOptions, CsiVolumeMountOptionsArgs

    FsType string

    (string: optional) - The file system type.

    MountFlags List<string>

    []string: optional - The flags passed to mount.

    FsType string

    (string: optional) - The file system type.

    MountFlags []string

    []string: optional - The flags passed to mount.

    fsType String

    (string: optional) - The file system type.

    mountFlags List<String>

    []string: optional - The flags passed to mount.

    fsType string

    (string: optional) - The file system type.

    mountFlags string[]

    []string: optional - The flags passed to mount.

    fs_type str

    (string: optional) - The file system type.

    mount_flags Sequence[str]

    []string: optional - The flags passed to mount.

    fsType String

    (string: optional) - The file system type.

    mountFlags List<String>

    []string: optional - The flags passed to mount.

    CsiVolumeTopology, CsiVolumeTopologyArgs

    Segments Dictionary<string, string>

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    Segments map[string]string

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments Map<String,String>

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments {[key: string]: string}

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments Mapping[str, str]

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments Map<String>

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    CsiVolumeTopologyRequest, CsiVolumeTopologyRequestArgs

    Preferred CsiVolumeTopologyRequestPreferred

    (``Topology``: <optional>) - Preferred topologies indicate that the volume should be created in a location accessible from some of the listed topologies.

    Required CsiVolumeTopologyRequestRequired

    (``Topology``: <optional>) - Required topologies indicate that the volume must be created in a location accessible from all the listed topologies.

    Preferred CsiVolumeTopologyRequestPreferred

    (``Topology``: <optional>) - Preferred topologies indicate that the volume should be created in a location accessible from some of the listed topologies.

    Required CsiVolumeTopologyRequestRequired

    (``Topology``: <optional>) - Required topologies indicate that the volume must be created in a location accessible from all the listed topologies.

    preferred CsiVolumeTopologyRequestPreferred

    (``Topology``: <optional>) - Preferred topologies indicate that the volume should be created in a location accessible from some of the listed topologies.

    required CsiVolumeTopologyRequestRequired

    (``Topology``: <optional>) - Required topologies indicate that the volume must be created in a location accessible from all the listed topologies.

    preferred CsiVolumeTopologyRequestPreferred

    (``Topology``: <optional>) - Preferred topologies indicate that the volume should be created in a location accessible from some of the listed topologies.

    required CsiVolumeTopologyRequestRequired

    (``Topology``: <optional>) - Required topologies indicate that the volume must be created in a location accessible from all the listed topologies.

    preferred CsiVolumeTopologyRequestPreferred

    (``Topology``: <optional>) - Preferred topologies indicate that the volume should be created in a location accessible from some of the listed topologies.

    required CsiVolumeTopologyRequestRequired

    (``Topology``: <optional>) - Required topologies indicate that the volume must be created in a location accessible from all the listed topologies.

    preferred Property Map

    (``Topology``: <optional>) - Preferred topologies indicate that the volume should be created in a location accessible from some of the listed topologies.

    required Property Map

    (``Topology``: <optional>) - Required topologies indicate that the volume must be created in a location accessible from all the listed topologies.

    CsiVolumeTopologyRequestPreferred, CsiVolumeTopologyRequestPreferredArgs

    CsiVolumeTopologyRequestPreferredTopology, CsiVolumeTopologyRequestPreferredTopologyArgs

    Segments Dictionary<string, string>

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    Segments map[string]string

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments Map<String,String>

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments {[key: string]: string}

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments Mapping[str, str]

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments Map<String>

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    CsiVolumeTopologyRequestRequired, CsiVolumeTopologyRequestRequiredArgs

    CsiVolumeTopologyRequestRequiredTopology, CsiVolumeTopologyRequestRequiredTopologyArgs

    Segments Dictionary<string, string>

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    Segments map[string]string

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments Map<String,String>

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments {[key: string]: string}

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments Mapping[str, str]

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    segments Map<String>

    (map[string]string) - Define the attributes for the topology request.

    In addition to the above arguments, the following attributes are exported and can be referenced:

    Package Details

    Repository
    HashiCorp Nomad pulumi/pulumi-nomad
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the nomad Terraform Provider.

    nomad logo
    Nomad v2.0.0 published on Wednesday, Sep 13, 2023 by Pulumi