gcp.filestore.Instance
Explore with Pulumi AI
A Google Cloud Filestore instance.
To get more information about Instance, see:
Example Usage
Filestore Instance Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const instance = new gcp.filestore.Instance("instance", {
    name: "test-instance",
    location: "us-central1-b",
    tier: "BASIC_HDD",
    fileShares: {
        capacityGb: 1024,
        name: "share1",
    },
    networks: [{
        network: "default",
        modes: ["MODE_IPV4"],
    }],
});
import pulumi
import pulumi_gcp as gcp
instance = gcp.filestore.Instance("instance",
    name="test-instance",
    location="us-central1-b",
    tier="BASIC_HDD",
    file_shares={
        "capacity_gb": 1024,
        "name": "share1",
    },
    networks=[{
        "network": "default",
        "modes": ["MODE_IPV4"],
    }])
package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/filestore"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := filestore.NewInstance(ctx, "instance", &filestore.InstanceArgs{
			Name:     pulumi.String("test-instance"),
			Location: pulumi.String("us-central1-b"),
			Tier:     pulumi.String("BASIC_HDD"),
			FileShares: &filestore.InstanceFileSharesArgs{
				CapacityGb: pulumi.Int(1024),
				Name:       pulumi.String("share1"),
			},
			Networks: filestore.InstanceNetworkArray{
				&filestore.InstanceNetworkArgs{
					Network: pulumi.String("default"),
					Modes: pulumi.StringArray{
						pulumi.String("MODE_IPV4"),
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() => 
{
    var instance = new Gcp.Filestore.Instance("instance", new()
    {
        Name = "test-instance",
        Location = "us-central1-b",
        Tier = "BASIC_HDD",
        FileShares = new Gcp.Filestore.Inputs.InstanceFileSharesArgs
        {
            CapacityGb = 1024,
            Name = "share1",
        },
        Networks = new[]
        {
            new Gcp.Filestore.Inputs.InstanceNetworkArgs
            {
                Network = "default",
                Modes = new[]
                {
                    "MODE_IPV4",
                },
            },
        },
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.filestore.Instance;
import com.pulumi.gcp.filestore.InstanceArgs;
import com.pulumi.gcp.filestore.inputs.InstanceFileSharesArgs;
import com.pulumi.gcp.filestore.inputs.InstanceNetworkArgs;
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) {
        var instance = new Instance("instance", InstanceArgs.builder()
            .name("test-instance")
            .location("us-central1-b")
            .tier("BASIC_HDD")
            .fileShares(InstanceFileSharesArgs.builder()
                .capacityGb(1024)
                .name("share1")
                .build())
            .networks(InstanceNetworkArgs.builder()
                .network("default")
                .modes("MODE_IPV4")
                .build())
            .build());
    }
}
resources:
  instance:
    type: gcp:filestore:Instance
    properties:
      name: test-instance
      location: us-central1-b
      tier: BASIC_HDD
      fileShares:
        capacityGb: 1024
        name: share1
      networks:
        - network: default
          modes:
            - MODE_IPV4
Filestore Instance Full
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const instance = new gcp.filestore.Instance("instance", {
    name: "test-instance",
    location: "us-central1-b",
    tier: "BASIC_SSD",
    fileShares: {
        capacityGb: 2560,
        name: "share1",
        nfsExportOptions: [
            {
                ipRanges: ["10.0.0.0/24"],
                accessMode: "READ_WRITE",
                squashMode: "NO_ROOT_SQUASH",
            },
            {
                ipRanges: ["10.10.0.0/24"],
                accessMode: "READ_ONLY",
                squashMode: "ROOT_SQUASH",
                anonUid: 123,
                anonGid: 456,
            },
        ],
    },
    networks: [{
        network: "default",
        modes: ["MODE_IPV4"],
        connectMode: "DIRECT_PEERING",
    }],
});
import pulumi
import pulumi_gcp as gcp
instance = gcp.filestore.Instance("instance",
    name="test-instance",
    location="us-central1-b",
    tier="BASIC_SSD",
    file_shares={
        "capacity_gb": 2560,
        "name": "share1",
        "nfs_export_options": [
            {
                "ip_ranges": ["10.0.0.0/24"],
                "access_mode": "READ_WRITE",
                "squash_mode": "NO_ROOT_SQUASH",
            },
            {
                "ip_ranges": ["10.10.0.0/24"],
                "access_mode": "READ_ONLY",
                "squash_mode": "ROOT_SQUASH",
                "anon_uid": 123,
                "anon_gid": 456,
            },
        ],
    },
    networks=[{
        "network": "default",
        "modes": ["MODE_IPV4"],
        "connect_mode": "DIRECT_PEERING",
    }])
package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/filestore"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := filestore.NewInstance(ctx, "instance", &filestore.InstanceArgs{
			Name:     pulumi.String("test-instance"),
			Location: pulumi.String("us-central1-b"),
			Tier:     pulumi.String("BASIC_SSD"),
			FileShares: &filestore.InstanceFileSharesArgs{
				CapacityGb: pulumi.Int(2560),
				Name:       pulumi.String("share1"),
				NfsExportOptions: filestore.InstanceFileSharesNfsExportOptionArray{
					&filestore.InstanceFileSharesNfsExportOptionArgs{
						IpRanges: pulumi.StringArray{
							pulumi.String("10.0.0.0/24"),
						},
						AccessMode: pulumi.String("READ_WRITE"),
						SquashMode: pulumi.String("NO_ROOT_SQUASH"),
					},
					&filestore.InstanceFileSharesNfsExportOptionArgs{
						IpRanges: pulumi.StringArray{
							pulumi.String("10.10.0.0/24"),
						},
						AccessMode: pulumi.String("READ_ONLY"),
						SquashMode: pulumi.String("ROOT_SQUASH"),
						AnonUid:    pulumi.Int(123),
						AnonGid:    pulumi.Int(456),
					},
				},
			},
			Networks: filestore.InstanceNetworkArray{
				&filestore.InstanceNetworkArgs{
					Network: pulumi.String("default"),
					Modes: pulumi.StringArray{
						pulumi.String("MODE_IPV4"),
					},
					ConnectMode: pulumi.String("DIRECT_PEERING"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() => 
{
    var instance = new Gcp.Filestore.Instance("instance", new()
    {
        Name = "test-instance",
        Location = "us-central1-b",
        Tier = "BASIC_SSD",
        FileShares = new Gcp.Filestore.Inputs.InstanceFileSharesArgs
        {
            CapacityGb = 2560,
            Name = "share1",
            NfsExportOptions = new[]
            {
                new Gcp.Filestore.Inputs.InstanceFileSharesNfsExportOptionArgs
                {
                    IpRanges = new[]
                    {
                        "10.0.0.0/24",
                    },
                    AccessMode = "READ_WRITE",
                    SquashMode = "NO_ROOT_SQUASH",
                },
                new Gcp.Filestore.Inputs.InstanceFileSharesNfsExportOptionArgs
                {
                    IpRanges = new[]
                    {
                        "10.10.0.0/24",
                    },
                    AccessMode = "READ_ONLY",
                    SquashMode = "ROOT_SQUASH",
                    AnonUid = 123,
                    AnonGid = 456,
                },
            },
        },
        Networks = new[]
        {
            new Gcp.Filestore.Inputs.InstanceNetworkArgs
            {
                Network = "default",
                Modes = new[]
                {
                    "MODE_IPV4",
                },
                ConnectMode = "DIRECT_PEERING",
            },
        },
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.filestore.Instance;
import com.pulumi.gcp.filestore.InstanceArgs;
import com.pulumi.gcp.filestore.inputs.InstanceFileSharesArgs;
import com.pulumi.gcp.filestore.inputs.InstanceNetworkArgs;
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) {
        var instance = new Instance("instance", InstanceArgs.builder()
            .name("test-instance")
            .location("us-central1-b")
            .tier("BASIC_SSD")
            .fileShares(InstanceFileSharesArgs.builder()
                .capacityGb(2560)
                .name("share1")
                .nfsExportOptions(                
                    InstanceFileSharesNfsExportOptionArgs.builder()
                        .ipRanges("10.0.0.0/24")
                        .accessMode("READ_WRITE")
                        .squashMode("NO_ROOT_SQUASH")
                        .build(),
                    InstanceFileSharesNfsExportOptionArgs.builder()
                        .ipRanges("10.10.0.0/24")
                        .accessMode("READ_ONLY")
                        .squashMode("ROOT_SQUASH")
                        .anonUid(123)
                        .anonGid(456)
                        .build())
                .build())
            .networks(InstanceNetworkArgs.builder()
                .network("default")
                .modes("MODE_IPV4")
                .connectMode("DIRECT_PEERING")
                .build())
            .build());
    }
}
resources:
  instance:
    type: gcp:filestore:Instance
    properties:
      name: test-instance
      location: us-central1-b
      tier: BASIC_SSD
      fileShares:
        capacityGb: 2560
        name: share1
        nfsExportOptions:
          - ipRanges:
              - 10.0.0.0/24
            accessMode: READ_WRITE
            squashMode: NO_ROOT_SQUASH
          - ipRanges:
              - 10.10.0.0/24
            accessMode: READ_ONLY
            squashMode: ROOT_SQUASH
            anonUid: 123
            anonGid: 456
      networks:
        - network: default
          modes:
            - MODE_IPV4
          connectMode: DIRECT_PEERING
Filestore Instance Protocol
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const instance = new gcp.filestore.Instance("instance", {
    name: "test-instance",
    location: "us-central1",
    tier: "ENTERPRISE",
    protocol: "NFS_V4_1",
    fileShares: {
        capacityGb: 1024,
        name: "share1",
    },
    networks: [{
        network: "default",
        modes: ["MODE_IPV4"],
    }],
});
import pulumi
import pulumi_gcp as gcp
instance = gcp.filestore.Instance("instance",
    name="test-instance",
    location="us-central1",
    tier="ENTERPRISE",
    protocol="NFS_V4_1",
    file_shares={
        "capacity_gb": 1024,
        "name": "share1",
    },
    networks=[{
        "network": "default",
        "modes": ["MODE_IPV4"],
    }])
package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/filestore"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := filestore.NewInstance(ctx, "instance", &filestore.InstanceArgs{
			Name:     pulumi.String("test-instance"),
			Location: pulumi.String("us-central1"),
			Tier:     pulumi.String("ENTERPRISE"),
			Protocol: pulumi.String("NFS_V4_1"),
			FileShares: &filestore.InstanceFileSharesArgs{
				CapacityGb: pulumi.Int(1024),
				Name:       pulumi.String("share1"),
			},
			Networks: filestore.InstanceNetworkArray{
				&filestore.InstanceNetworkArgs{
					Network: pulumi.String("default"),
					Modes: pulumi.StringArray{
						pulumi.String("MODE_IPV4"),
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() => 
{
    var instance = new Gcp.Filestore.Instance("instance", new()
    {
        Name = "test-instance",
        Location = "us-central1",
        Tier = "ENTERPRISE",
        Protocol = "NFS_V4_1",
        FileShares = new Gcp.Filestore.Inputs.InstanceFileSharesArgs
        {
            CapacityGb = 1024,
            Name = "share1",
        },
        Networks = new[]
        {
            new Gcp.Filestore.Inputs.InstanceNetworkArgs
            {
                Network = "default",
                Modes = new[]
                {
                    "MODE_IPV4",
                },
            },
        },
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.filestore.Instance;
import com.pulumi.gcp.filestore.InstanceArgs;
import com.pulumi.gcp.filestore.inputs.InstanceFileSharesArgs;
import com.pulumi.gcp.filestore.inputs.InstanceNetworkArgs;
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) {
        var instance = new Instance("instance", InstanceArgs.builder()
            .name("test-instance")
            .location("us-central1")
            .tier("ENTERPRISE")
            .protocol("NFS_V4_1")
            .fileShares(InstanceFileSharesArgs.builder()
                .capacityGb(1024)
                .name("share1")
                .build())
            .networks(InstanceNetworkArgs.builder()
                .network("default")
                .modes("MODE_IPV4")
                .build())
            .build());
    }
}
resources:
  instance:
    type: gcp:filestore:Instance
    properties:
      name: test-instance
      location: us-central1
      tier: ENTERPRISE
      protocol: NFS_V4_1
      fileShares:
        capacityGb: 1024
        name: share1
      networks:
        - network: default
          modes:
            - MODE_IPV4
Filestore Instance Enterprise
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const filestoreKeyring = new gcp.kms.KeyRing("filestore_keyring", {
    name: "filestore-keyring",
    location: "us-central1",
});
const filestoreKey = new gcp.kms.CryptoKey("filestore_key", {
    name: "filestore-key",
    keyRing: filestoreKeyring.id,
});
const instance = new gcp.filestore.Instance("instance", {
    name: "test-instance",
    location: "us-central1",
    tier: "ENTERPRISE",
    fileShares: {
        capacityGb: 1024,
        name: "share1",
    },
    networks: [{
        network: "default",
        modes: ["MODE_IPV4"],
    }],
    kmsKeyName: filestoreKey.id,
});
import pulumi
import pulumi_gcp as gcp
filestore_keyring = gcp.kms.KeyRing("filestore_keyring",
    name="filestore-keyring",
    location="us-central1")
filestore_key = gcp.kms.CryptoKey("filestore_key",
    name="filestore-key",
    key_ring=filestore_keyring.id)
instance = gcp.filestore.Instance("instance",
    name="test-instance",
    location="us-central1",
    tier="ENTERPRISE",
    file_shares={
        "capacity_gb": 1024,
        "name": "share1",
    },
    networks=[{
        "network": "default",
        "modes": ["MODE_IPV4"],
    }],
    kms_key_name=filestore_key.id)
package main
import (
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/filestore"
	"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/kms"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		filestoreKeyring, err := kms.NewKeyRing(ctx, "filestore_keyring", &kms.KeyRingArgs{
			Name:     pulumi.String("filestore-keyring"),
			Location: pulumi.String("us-central1"),
		})
		if err != nil {
			return err
		}
		filestoreKey, err := kms.NewCryptoKey(ctx, "filestore_key", &kms.CryptoKeyArgs{
			Name:    pulumi.String("filestore-key"),
			KeyRing: filestoreKeyring.ID(),
		})
		if err != nil {
			return err
		}
		_, err = filestore.NewInstance(ctx, "instance", &filestore.InstanceArgs{
			Name:     pulumi.String("test-instance"),
			Location: pulumi.String("us-central1"),
			Tier:     pulumi.String("ENTERPRISE"),
			FileShares: &filestore.InstanceFileSharesArgs{
				CapacityGb: pulumi.Int(1024),
				Name:       pulumi.String("share1"),
			},
			Networks: filestore.InstanceNetworkArray{
				&filestore.InstanceNetworkArgs{
					Network: pulumi.String("default"),
					Modes: pulumi.StringArray{
						pulumi.String("MODE_IPV4"),
					},
				},
			},
			KmsKeyName: filestoreKey.ID(),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() => 
{
    var filestoreKeyring = new Gcp.Kms.KeyRing("filestore_keyring", new()
    {
        Name = "filestore-keyring",
        Location = "us-central1",
    });
    var filestoreKey = new Gcp.Kms.CryptoKey("filestore_key", new()
    {
        Name = "filestore-key",
        KeyRing = filestoreKeyring.Id,
    });
    var instance = new Gcp.Filestore.Instance("instance", new()
    {
        Name = "test-instance",
        Location = "us-central1",
        Tier = "ENTERPRISE",
        FileShares = new Gcp.Filestore.Inputs.InstanceFileSharesArgs
        {
            CapacityGb = 1024,
            Name = "share1",
        },
        Networks = new[]
        {
            new Gcp.Filestore.Inputs.InstanceNetworkArgs
            {
                Network = "default",
                Modes = new[]
                {
                    "MODE_IPV4",
                },
            },
        },
        KmsKeyName = filestoreKey.Id,
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.kms.KeyRing;
import com.pulumi.gcp.kms.KeyRingArgs;
import com.pulumi.gcp.kms.CryptoKey;
import com.pulumi.gcp.kms.CryptoKeyArgs;
import com.pulumi.gcp.filestore.Instance;
import com.pulumi.gcp.filestore.InstanceArgs;
import com.pulumi.gcp.filestore.inputs.InstanceFileSharesArgs;
import com.pulumi.gcp.filestore.inputs.InstanceNetworkArgs;
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) {
        var filestoreKeyring = new KeyRing("filestoreKeyring", KeyRingArgs.builder()
            .name("filestore-keyring")
            .location("us-central1")
            .build());
        var filestoreKey = new CryptoKey("filestoreKey", CryptoKeyArgs.builder()
            .name("filestore-key")
            .keyRing(filestoreKeyring.id())
            .build());
        var instance = new Instance("instance", InstanceArgs.builder()
            .name("test-instance")
            .location("us-central1")
            .tier("ENTERPRISE")
            .fileShares(InstanceFileSharesArgs.builder()
                .capacityGb(1024)
                .name("share1")
                .build())
            .networks(InstanceNetworkArgs.builder()
                .network("default")
                .modes("MODE_IPV4")
                .build())
            .kmsKeyName(filestoreKey.id())
            .build());
    }
}
resources:
  instance:
    type: gcp:filestore:Instance
    properties:
      name: test-instance
      location: us-central1
      tier: ENTERPRISE
      fileShares:
        capacityGb: 1024
        name: share1
      networks:
        - network: default
          modes:
            - MODE_IPV4
      kmsKeyName: ${filestoreKey.id}
  filestoreKeyring:
    type: gcp:kms:KeyRing
    name: filestore_keyring
    properties:
      name: filestore-keyring
      location: us-central1
  filestoreKey:
    type: gcp:kms:CryptoKey
    name: filestore_key
    properties:
      name: filestore-key
      keyRing: ${filestoreKeyring.id}
Create Instance Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Instance(name: string, args: InstanceArgs, opts?: CustomResourceOptions);@overload
def Instance(resource_name: str,
             args: InstanceArgs,
             opts: Optional[ResourceOptions] = None)
@overload
def Instance(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             file_shares: Optional[InstanceFileSharesArgs] = None,
             tier: Optional[str] = None,
             networks: Optional[Sequence[InstanceNetworkArgs]] = None,
             name: Optional[str] = None,
             initial_replication: Optional[InstanceInitialReplicationArgs] = None,
             kms_key_name: Optional[str] = None,
             labels: Optional[Mapping[str, str]] = None,
             location: Optional[str] = None,
             deletion_protection_enabled: Optional[bool] = None,
             description: Optional[str] = None,
             performance_config: Optional[InstancePerformanceConfigArgs] = None,
             project: Optional[str] = None,
             protocol: Optional[str] = None,
             tags: Optional[Mapping[str, str]] = None,
             deletion_protection_reason: Optional[str] = None,
             zone: Optional[str] = None)func NewInstance(ctx *Context, name string, args InstanceArgs, opts ...ResourceOption) (*Instance, error)public Instance(string name, InstanceArgs args, CustomResourceOptions? opts = null)
public Instance(String name, InstanceArgs args)
public Instance(String name, InstanceArgs args, CustomResourceOptions options)
type: gcp:filestore:Instance
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args InstanceArgs
- 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 InstanceArgs
- 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 InstanceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var exampleinstanceResourceResourceFromFilestoreinstance = new Gcp.Filestore.Instance("exampleinstanceResourceResourceFromFilestoreinstance", new()
{
    FileShares = new Gcp.Filestore.Inputs.InstanceFileSharesArgs
    {
        CapacityGb = 0,
        Name = "string",
        NfsExportOptions = new[]
        {
            new Gcp.Filestore.Inputs.InstanceFileSharesNfsExportOptionArgs
            {
                AccessMode = "string",
                AnonGid = 0,
                AnonUid = 0,
                IpRanges = new[]
                {
                    "string",
                },
                SquashMode = "string",
            },
        },
        SourceBackup = "string",
    },
    Tier = "string",
    Networks = new[]
    {
        new Gcp.Filestore.Inputs.InstanceNetworkArgs
        {
            Modes = new[]
            {
                "string",
            },
            Network = "string",
            ConnectMode = "string",
            IpAddresses = new[]
            {
                "string",
            },
            ReservedIpRange = "string",
        },
    },
    Name = "string",
    InitialReplication = new Gcp.Filestore.Inputs.InstanceInitialReplicationArgs
    {
        Replicas = new[]
        {
            new Gcp.Filestore.Inputs.InstanceInitialReplicationReplicaArgs
            {
                PeerInstance = "string",
            },
        },
        Role = "string",
    },
    KmsKeyName = "string",
    Labels = 
    {
        { "string", "string" },
    },
    Location = "string",
    DeletionProtectionEnabled = false,
    Description = "string",
    PerformanceConfig = new Gcp.Filestore.Inputs.InstancePerformanceConfigArgs
    {
        FixedIops = new Gcp.Filestore.Inputs.InstancePerformanceConfigFixedIopsArgs
        {
            MaxIops = 0,
        },
        IopsPerTb = new Gcp.Filestore.Inputs.InstancePerformanceConfigIopsPerTbArgs
        {
            MaxIopsPerTb = 0,
        },
    },
    Project = "string",
    Protocol = "string",
    Tags = 
    {
        { "string", "string" },
    },
    DeletionProtectionReason = "string",
});
example, err := filestore.NewInstance(ctx, "exampleinstanceResourceResourceFromFilestoreinstance", &filestore.InstanceArgs{
	FileShares: &filestore.InstanceFileSharesArgs{
		CapacityGb: pulumi.Int(0),
		Name:       pulumi.String("string"),
		NfsExportOptions: filestore.InstanceFileSharesNfsExportOptionArray{
			&filestore.InstanceFileSharesNfsExportOptionArgs{
				AccessMode: pulumi.String("string"),
				AnonGid:    pulumi.Int(0),
				AnonUid:    pulumi.Int(0),
				IpRanges: pulumi.StringArray{
					pulumi.String("string"),
				},
				SquashMode: pulumi.String("string"),
			},
		},
		SourceBackup: pulumi.String("string"),
	},
	Tier: pulumi.String("string"),
	Networks: filestore.InstanceNetworkArray{
		&filestore.InstanceNetworkArgs{
			Modes: pulumi.StringArray{
				pulumi.String("string"),
			},
			Network:     pulumi.String("string"),
			ConnectMode: pulumi.String("string"),
			IpAddresses: pulumi.StringArray{
				pulumi.String("string"),
			},
			ReservedIpRange: pulumi.String("string"),
		},
	},
	Name: pulumi.String("string"),
	InitialReplication: &filestore.InstanceInitialReplicationArgs{
		Replicas: filestore.InstanceInitialReplicationReplicaArray{
			&filestore.InstanceInitialReplicationReplicaArgs{
				PeerInstance: pulumi.String("string"),
			},
		},
		Role: pulumi.String("string"),
	},
	KmsKeyName: pulumi.String("string"),
	Labels: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Location:                  pulumi.String("string"),
	DeletionProtectionEnabled: pulumi.Bool(false),
	Description:               pulumi.String("string"),
	PerformanceConfig: &filestore.InstancePerformanceConfigArgs{
		FixedIops: &filestore.InstancePerformanceConfigFixedIopsArgs{
			MaxIops: pulumi.Int(0),
		},
		IopsPerTb: &filestore.InstancePerformanceConfigIopsPerTbArgs{
			MaxIopsPerTb: pulumi.Int(0),
		},
	},
	Project:  pulumi.String("string"),
	Protocol: pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	DeletionProtectionReason: pulumi.String("string"),
})
var exampleinstanceResourceResourceFromFilestoreinstance = new Instance("exampleinstanceResourceResourceFromFilestoreinstance", InstanceArgs.builder()
    .fileShares(InstanceFileSharesArgs.builder()
        .capacityGb(0)
        .name("string")
        .nfsExportOptions(InstanceFileSharesNfsExportOptionArgs.builder()
            .accessMode("string")
            .anonGid(0)
            .anonUid(0)
            .ipRanges("string")
            .squashMode("string")
            .build())
        .sourceBackup("string")
        .build())
    .tier("string")
    .networks(InstanceNetworkArgs.builder()
        .modes("string")
        .network("string")
        .connectMode("string")
        .ipAddresses("string")
        .reservedIpRange("string")
        .build())
    .name("string")
    .initialReplication(InstanceInitialReplicationArgs.builder()
        .replicas(InstanceInitialReplicationReplicaArgs.builder()
            .peerInstance("string")
            .build())
        .role("string")
        .build())
    .kmsKeyName("string")
    .labels(Map.of("string", "string"))
    .location("string")
    .deletionProtectionEnabled(false)
    .description("string")
    .performanceConfig(InstancePerformanceConfigArgs.builder()
        .fixedIops(InstancePerformanceConfigFixedIopsArgs.builder()
            .maxIops(0)
            .build())
        .iopsPerTb(InstancePerformanceConfigIopsPerTbArgs.builder()
            .maxIopsPerTb(0)
            .build())
        .build())
    .project("string")
    .protocol("string")
    .tags(Map.of("string", "string"))
    .deletionProtectionReason("string")
    .build());
exampleinstance_resource_resource_from_filestoreinstance = gcp.filestore.Instance("exampleinstanceResourceResourceFromFilestoreinstance",
    file_shares={
        "capacity_gb": 0,
        "name": "string",
        "nfs_export_options": [{
            "access_mode": "string",
            "anon_gid": 0,
            "anon_uid": 0,
            "ip_ranges": ["string"],
            "squash_mode": "string",
        }],
        "source_backup": "string",
    },
    tier="string",
    networks=[{
        "modes": ["string"],
        "network": "string",
        "connect_mode": "string",
        "ip_addresses": ["string"],
        "reserved_ip_range": "string",
    }],
    name="string",
    initial_replication={
        "replicas": [{
            "peer_instance": "string",
        }],
        "role": "string",
    },
    kms_key_name="string",
    labels={
        "string": "string",
    },
    location="string",
    deletion_protection_enabled=False,
    description="string",
    performance_config={
        "fixed_iops": {
            "max_iops": 0,
        },
        "iops_per_tb": {
            "max_iops_per_tb": 0,
        },
    },
    project="string",
    protocol="string",
    tags={
        "string": "string",
    },
    deletion_protection_reason="string")
const exampleinstanceResourceResourceFromFilestoreinstance = new gcp.filestore.Instance("exampleinstanceResourceResourceFromFilestoreinstance", {
    fileShares: {
        capacityGb: 0,
        name: "string",
        nfsExportOptions: [{
            accessMode: "string",
            anonGid: 0,
            anonUid: 0,
            ipRanges: ["string"],
            squashMode: "string",
        }],
        sourceBackup: "string",
    },
    tier: "string",
    networks: [{
        modes: ["string"],
        network: "string",
        connectMode: "string",
        ipAddresses: ["string"],
        reservedIpRange: "string",
    }],
    name: "string",
    initialReplication: {
        replicas: [{
            peerInstance: "string",
        }],
        role: "string",
    },
    kmsKeyName: "string",
    labels: {
        string: "string",
    },
    location: "string",
    deletionProtectionEnabled: false,
    description: "string",
    performanceConfig: {
        fixedIops: {
            maxIops: 0,
        },
        iopsPerTb: {
            maxIopsPerTb: 0,
        },
    },
    project: "string",
    protocol: "string",
    tags: {
        string: "string",
    },
    deletionProtectionReason: "string",
});
type: gcp:filestore:Instance
properties:
    deletionProtectionEnabled: false
    deletionProtectionReason: string
    description: string
    fileShares:
        capacityGb: 0
        name: string
        nfsExportOptions:
            - accessMode: string
              anonGid: 0
              anonUid: 0
              ipRanges:
                - string
              squashMode: string
        sourceBackup: string
    initialReplication:
        replicas:
            - peerInstance: string
        role: string
    kmsKeyName: string
    labels:
        string: string
    location: string
    name: string
    networks:
        - connectMode: string
          ipAddresses:
            - string
          modes:
            - string
          network: string
          reservedIpRange: string
    performanceConfig:
        fixedIops:
            maxIops: 0
        iopsPerTb:
            maxIopsPerTb: 0
    project: string
    protocol: string
    tags:
        string: string
    tier: string
Instance Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Instance resource accepts the following input properties:
- 
InstanceFile Shares 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- Networks
List<InstanceNetwork> 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- Tier string
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- DeletionProtection boolEnabled 
- Indicates whether the instance is protected against deletion.
- DeletionProtection stringReason 
- The reason for enabling deletion protection.
- Description string
- A description of the instance.
- InitialReplication InstanceInitial Replication 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- KmsKey stringName 
- KMS key name used for data encryption.
- Labels Dictionary<string, string>
- Resource labels to represent user-provided metadata. 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.
- Location string
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- Name string
- The resource name of the instance.
- PerformanceConfig InstancePerformance Config 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- Project string
- Protocol string
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- Dictionary<string, string>
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- Zone string
- The name of the Filestore zone of the instance.
- 
InstanceFile Shares Args 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- Networks
[]InstanceNetwork Args 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- Tier string
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- DeletionProtection boolEnabled 
- Indicates whether the instance is protected against deletion.
- DeletionProtection stringReason 
- The reason for enabling deletion protection.
- Description string
- A description of the instance.
- InitialReplication InstanceInitial Replication Args 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- KmsKey stringName 
- KMS key name used for data encryption.
- Labels map[string]string
- Resource labels to represent user-provided metadata. 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.
- Location string
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- Name string
- The resource name of the instance.
- PerformanceConfig InstancePerformance Config Args 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- Project string
- Protocol string
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- map[string]string
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- Zone string
- The name of the Filestore zone of the instance.
- 
InstanceFile Shares 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- networks
List<InstanceNetwork> 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- tier String
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- deletionProtection BooleanEnabled 
- Indicates whether the instance is protected against deletion.
- deletionProtection StringReason 
- The reason for enabling deletion protection.
- description String
- A description of the instance.
- initialReplication InstanceInitial Replication 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- kmsKey StringName 
- KMS key name used for data encryption.
- labels Map<String,String>
- Resource labels to represent user-provided metadata. 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.
- location String
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- name String
- The resource name of the instance.
- performanceConfig InstancePerformance Config 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- project String
- protocol String
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- Map<String,String>
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- zone String
- The name of the Filestore zone of the instance.
- 
InstanceFile Shares 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- networks
InstanceNetwork[] 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- tier string
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- deletionProtection booleanEnabled 
- Indicates whether the instance is protected against deletion.
- deletionProtection stringReason 
- The reason for enabling deletion protection.
- description string
- A description of the instance.
- initialReplication InstanceInitial Replication 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- kmsKey stringName 
- KMS key name used for data encryption.
- labels {[key: string]: string}
- Resource labels to represent user-provided metadata. 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.
- location string
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- name string
- The resource name of the instance.
- performanceConfig InstancePerformance Config 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- project string
- protocol string
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- {[key: string]: string}
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- zone string
- The name of the Filestore zone of the instance.
- 
InstanceFile Shares Args 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- networks
Sequence[InstanceNetwork Args] 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- tier str
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- deletion_protection_ boolenabled 
- Indicates whether the instance is protected against deletion.
- deletion_protection_ strreason 
- The reason for enabling deletion protection.
- description str
- A description of the instance.
- initial_replication InstanceInitial Replication Args 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- kms_key_ strname 
- KMS key name used for data encryption.
- labels Mapping[str, str]
- Resource labels to represent user-provided metadata. 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.
- location str
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- name str
- The resource name of the instance.
- performance_config InstancePerformance Config Args 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- project str
- protocol str
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- Mapping[str, str]
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- zone str
- The name of the Filestore zone of the instance.
- Property Map
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- networks List<Property Map>
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- tier String
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- deletionProtection BooleanEnabled 
- Indicates whether the instance is protected against deletion.
- deletionProtection StringReason 
- The reason for enabling deletion protection.
- description String
- A description of the instance.
- initialReplication Property Map
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- kmsKey StringName 
- KMS key name used for data encryption.
- labels Map<String>
- Resource labels to represent user-provided metadata. 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.
- location String
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- name String
- The resource name of the instance.
- performanceConfig Property Map
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- project String
- protocol String
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- Map<String>
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- zone String
- The name of the Filestore zone of the instance.
Outputs
All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:
- CreateTime string
- Creation timestamp in RFC3339 text format.
- EffectiveLabels Dictionary<string, string>
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- EffectiveReplications List<InstanceEffective Replication> 
- Output only fields for replication configuration. Structure is documented below.
- Etag string
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- Id string
- The provider-assigned unique ID for this managed resource.
- PulumiLabels Dictionary<string, string>
- The combination of labels configured directly on the resource and default labels configured on the provider.
- CreateTime string
- Creation timestamp in RFC3339 text format.
- EffectiveLabels map[string]string
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- EffectiveReplications []InstanceEffective Replication 
- Output only fields for replication configuration. Structure is documented below.
- Etag string
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- Id string
- The provider-assigned unique ID for this managed resource.
- PulumiLabels map[string]string
- The combination of labels configured directly on the resource and default labels configured on the provider.
- createTime String
- Creation timestamp in RFC3339 text format.
- effectiveLabels Map<String,String>
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- effectiveReplications List<InstanceEffective Replication> 
- Output only fields for replication configuration. Structure is documented below.
- etag String
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- id String
- The provider-assigned unique ID for this managed resource.
- pulumiLabels Map<String,String>
- The combination of labels configured directly on the resource and default labels configured on the provider.
- createTime string
- Creation timestamp in RFC3339 text format.
- effectiveLabels {[key: string]: string}
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- effectiveReplications InstanceEffective Replication[] 
- Output only fields for replication configuration. Structure is documented below.
- etag string
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- id string
- The provider-assigned unique ID for this managed resource.
- pulumiLabels {[key: string]: string}
- The combination of labels configured directly on the resource and default labels configured on the provider.
- create_time str
- Creation timestamp in RFC3339 text format.
- effective_labels Mapping[str, str]
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- effective_replications Sequence[InstanceEffective Replication] 
- Output only fields for replication configuration. Structure is documented below.
- etag str
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- id str
- The provider-assigned unique ID for this managed resource.
- pulumi_labels Mapping[str, str]
- The combination of labels configured directly on the resource and default labels configured on the provider.
- createTime String
- Creation timestamp in RFC3339 text format.
- effectiveLabels Map<String>
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- effectiveReplications List<Property Map>
- Output only fields for replication configuration. Structure is documented below.
- etag String
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- id String
- The provider-assigned unique ID for this managed resource.
- pulumiLabels Map<String>
- The combination of labels configured directly on the resource and default labels configured on the provider.
Look up Existing Instance Resource
Get an existing Instance 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?: InstanceState, opts?: CustomResourceOptions): Instance@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        create_time: Optional[str] = None,
        deletion_protection_enabled: Optional[bool] = None,
        deletion_protection_reason: Optional[str] = None,
        description: Optional[str] = None,
        effective_labels: Optional[Mapping[str, str]] = None,
        effective_replications: Optional[Sequence[InstanceEffectiveReplicationArgs]] = None,
        etag: Optional[str] = None,
        file_shares: Optional[InstanceFileSharesArgs] = None,
        initial_replication: Optional[InstanceInitialReplicationArgs] = None,
        kms_key_name: Optional[str] = None,
        labels: Optional[Mapping[str, str]] = None,
        location: Optional[str] = None,
        name: Optional[str] = None,
        networks: Optional[Sequence[InstanceNetworkArgs]] = None,
        performance_config: Optional[InstancePerformanceConfigArgs] = None,
        project: Optional[str] = None,
        protocol: Optional[str] = None,
        pulumi_labels: Optional[Mapping[str, str]] = None,
        tags: Optional[Mapping[str, str]] = None,
        tier: Optional[str] = None,
        zone: Optional[str] = None) -> Instancefunc GetInstance(ctx *Context, name string, id IDInput, state *InstanceState, opts ...ResourceOption) (*Instance, error)public static Instance Get(string name, Input<string> id, InstanceState? state, CustomResourceOptions? opts = null)public static Instance get(String name, Output<String> id, InstanceState state, CustomResourceOptions options)resources:  _:    type: gcp:filestore:Instance    get:      id: ${id}- 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.
- CreateTime string
- Creation timestamp in RFC3339 text format.
- DeletionProtection boolEnabled 
- Indicates whether the instance is protected against deletion.
- DeletionProtection stringReason 
- The reason for enabling deletion protection.
- Description string
- A description of the instance.
- EffectiveLabels Dictionary<string, string>
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- EffectiveReplications List<InstanceEffective Replication> 
- Output only fields for replication configuration. Structure is documented below.
- Etag string
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- 
InstanceFile Shares 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- InitialReplication InstanceInitial Replication 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- KmsKey stringName 
- KMS key name used for data encryption.
- Labels Dictionary<string, string>
- Resource labels to represent user-provided metadata. 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.
- Location string
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- Name string
- The resource name of the instance.
- Networks
List<InstanceNetwork> 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- PerformanceConfig InstancePerformance Config 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- Project string
- Protocol string
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- PulumiLabels Dictionary<string, string>
- The combination of labels configured directly on the resource and default labels configured on the provider.
- Dictionary<string, string>
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- Tier string
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- Zone string
- The name of the Filestore zone of the instance.
- CreateTime string
- Creation timestamp in RFC3339 text format.
- DeletionProtection boolEnabled 
- Indicates whether the instance is protected against deletion.
- DeletionProtection stringReason 
- The reason for enabling deletion protection.
- Description string
- A description of the instance.
- EffectiveLabels map[string]string
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- EffectiveReplications []InstanceEffective Replication Args 
- Output only fields for replication configuration. Structure is documented below.
- Etag string
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- 
InstanceFile Shares Args 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- InitialReplication InstanceInitial Replication Args 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- KmsKey stringName 
- KMS key name used for data encryption.
- Labels map[string]string
- Resource labels to represent user-provided metadata. 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.
- Location string
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- Name string
- The resource name of the instance.
- Networks
[]InstanceNetwork Args 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- PerformanceConfig InstancePerformance Config Args 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- Project string
- Protocol string
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- PulumiLabels map[string]string
- The combination of labels configured directly on the resource and default labels configured on the provider.
- map[string]string
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- Tier string
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- Zone string
- The name of the Filestore zone of the instance.
- createTime String
- Creation timestamp in RFC3339 text format.
- deletionProtection BooleanEnabled 
- Indicates whether the instance is protected against deletion.
- deletionProtection StringReason 
- The reason for enabling deletion protection.
- description String
- A description of the instance.
- effectiveLabels Map<String,String>
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- effectiveReplications List<InstanceEffective Replication> 
- Output only fields for replication configuration. Structure is documented below.
- etag String
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- 
InstanceFile Shares 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- initialReplication InstanceInitial Replication 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- kmsKey StringName 
- KMS key name used for data encryption.
- labels Map<String,String>
- Resource labels to represent user-provided metadata. 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.
- location String
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- name String
- The resource name of the instance.
- networks
List<InstanceNetwork> 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- performanceConfig InstancePerformance Config 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- project String
- protocol String
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- pulumiLabels Map<String,String>
- The combination of labels configured directly on the resource and default labels configured on the provider.
- Map<String,String>
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- tier String
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- zone String
- The name of the Filestore zone of the instance.
- createTime string
- Creation timestamp in RFC3339 text format.
- deletionProtection booleanEnabled 
- Indicates whether the instance is protected against deletion.
- deletionProtection stringReason 
- The reason for enabling deletion protection.
- description string
- A description of the instance.
- effectiveLabels {[key: string]: string}
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- effectiveReplications InstanceEffective Replication[] 
- Output only fields for replication configuration. Structure is documented below.
- etag string
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- 
InstanceFile Shares 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- initialReplication InstanceInitial Replication 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- kmsKey stringName 
- KMS key name used for data encryption.
- labels {[key: string]: string}
- Resource labels to represent user-provided metadata. 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.
- location string
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- name string
- The resource name of the instance.
- networks
InstanceNetwork[] 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- performanceConfig InstancePerformance Config 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- project string
- protocol string
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- pulumiLabels {[key: string]: string}
- The combination of labels configured directly on the resource and default labels configured on the provider.
- {[key: string]: string}
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- tier string
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- zone string
- The name of the Filestore zone of the instance.
- create_time str
- Creation timestamp in RFC3339 text format.
- deletion_protection_ boolenabled 
- Indicates whether the instance is protected against deletion.
- deletion_protection_ strreason 
- The reason for enabling deletion protection.
- description str
- A description of the instance.
- effective_labels Mapping[str, str]
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- effective_replications Sequence[InstanceEffective Replication Args] 
- Output only fields for replication configuration. Structure is documented below.
- etag str
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- 
InstanceFile Shares Args 
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- initial_replication InstanceInitial Replication Args 
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- kms_key_ strname 
- KMS key name used for data encryption.
- labels Mapping[str, str]
- Resource labels to represent user-provided metadata. 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.
- location str
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- name str
- The resource name of the instance.
- networks
Sequence[InstanceNetwork Args] 
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- performance_config InstancePerformance Config Args 
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- project str
- protocol str
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- pulumi_labels Mapping[str, str]
- The combination of labels configured directly on the resource and default labels configured on the provider.
- Mapping[str, str]
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- tier str
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- zone str
- The name of the Filestore zone of the instance.
- createTime String
- Creation timestamp in RFC3339 text format.
- deletionProtection BooleanEnabled 
- Indicates whether the instance is protected against deletion.
- deletionProtection StringReason 
- The reason for enabling deletion protection.
- description String
- A description of the instance.
- effectiveLabels Map<String>
- All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
- effectiveReplications List<Property Map>
- Output only fields for replication configuration. Structure is documented below.
- etag String
- Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.
- Property Map
- File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.
- initialReplication Property Map
- Replication configuration, once set, this cannot be updated. Addtionally this should be specified on the replica instance only, indicating the active as the peer_instance
- kmsKey StringName 
- KMS key name used for data encryption.
- labels Map<String>
- Resource labels to represent user-provided metadata. 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.
- location String
- The name of the location of the instance. This can be a region for ENTERPRISE tier instances.
- name String
- The resource name of the instance.
- networks List<Property Map>
- VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.
- performanceConfig Property Map
- Performance configuration for the instance. If not provided, the default performance settings will be used.
- project String
- protocol String
- Either NFSv3, for using NFS version 3 as file sharing protocol, or NFSv4.1, for using NFS version 4.1 as file sharing protocol. NFSv4.1 can be used with HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE. The default is NFSv3. Default value: "NFS_V3" Possible values: ["NFS_V3", "NFS_V4_1"]
- pulumiLabels Map<String>
- The combination of labels configured directly on the resource and default labels configured on the provider.
- Map<String>
- A map of resource manager tags. Resource manager tag keys and values have the same definition as resource manager tags. Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456. The field is ignored when empty. The field is immutable and causes resource replacement when mutated. This field is only set at create time and modifying this field after creation will trigger recreation. To apply tags to an existing resource, see the 'google_tags_tag_value' resource.
- tier String
- The service tier of the instance. Possible values include: STANDARD, PREMIUM, BASIC_HDD, BASIC_SSD, HIGH_SCALE_SSD, ZONAL, REGIONAL and ENTERPRISE
- zone String
- The name of the Filestore zone of the instance.
Supporting Types
InstanceEffectiveReplication, InstanceEffectiveReplicationArgs      
- Replicas
List<InstanceEffective Replication Replica> 
- The replication role. Structure is documented below.
- Replicas
[]InstanceEffective Replication Replica 
- The replication role. Structure is documented below.
- replicas
List<InstanceEffective Replication Replica> 
- The replication role. Structure is documented below.
- replicas
InstanceEffective Replication Replica[] 
- The replication role. Structure is documented below.
- replicas
Sequence[InstanceEffective Replication Replica] 
- The replication role. Structure is documented below.
- replicas List<Property Map>
- The replication role. Structure is documented below.
InstanceEffectiveReplicationReplica, InstanceEffectiveReplicationReplicaArgs        
- LastActive stringSync Time 
- (Output) Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z"
- State string
- (Output) Output only. The replica state
- StateReasons List<string>
- (Output) Output only. Additional information about the replication state, if available.
- LastActive stringSync Time 
- (Output) Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z"
- State string
- (Output) Output only. The replica state
- StateReasons []string
- (Output) Output only. Additional information about the replication state, if available.
- lastActive StringSync Time 
- (Output) Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z"
- state String
- (Output) Output only. The replica state
- stateReasons List<String>
- (Output) Output only. Additional information about the replication state, if available.
- lastActive stringSync Time 
- (Output) Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z"
- state string
- (Output) Output only. The replica state
- stateReasons string[]
- (Output) Output only. Additional information about the replication state, if available.
- last_active_ strsync_ time 
- (Output) Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z"
- state str
- (Output) Output only. The replica state
- state_reasons Sequence[str]
- (Output) Output only. Additional information about the replication state, if available.
- lastActive StringSync Time 
- (Output) Output only. The timestamp of the latest replication snapshot taken on the active instance and is already replicated safely. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z"
- state String
- (Output) Output only. The replica state
- stateReasons List<String>
- (Output) Output only. Additional information about the replication state, if available.
InstanceFileShares, InstanceFileSharesArgs      
- CapacityGb int
- File share capacity in GiB. This must be at least 1024 GiB for the standard tier, or 2560 GiB for the premium tier.
- Name string
- The name of the fileshare (16 characters or less)
- NfsExport List<InstanceOptions File Shares Nfs Export Option> 
- Nfs Export Options. There is a limit of 10 export options per file share. Structure is documented below.
- SourceBackup string
- The resource name of the backup, in the format projects/{projectId}/locations/{locationId}/backups/{backupId}, that this file share has been restored from.
- CapacityGb int
- File share capacity in GiB. This must be at least 1024 GiB for the standard tier, or 2560 GiB for the premium tier.
- Name string
- The name of the fileshare (16 characters or less)
- NfsExport []InstanceOptions File Shares Nfs Export Option 
- Nfs Export Options. There is a limit of 10 export options per file share. Structure is documented below.
- SourceBackup string
- The resource name of the backup, in the format projects/{projectId}/locations/{locationId}/backups/{backupId}, that this file share has been restored from.
- capacityGb Integer
- File share capacity in GiB. This must be at least 1024 GiB for the standard tier, or 2560 GiB for the premium tier.
- name String
- The name of the fileshare (16 characters or less)
- nfsExport List<InstanceOptions File Shares Nfs Export Option> 
- Nfs Export Options. There is a limit of 10 export options per file share. Structure is documented below.
- sourceBackup String
- The resource name of the backup, in the format projects/{projectId}/locations/{locationId}/backups/{backupId}, that this file share has been restored from.
- capacityGb number
- File share capacity in GiB. This must be at least 1024 GiB for the standard tier, or 2560 GiB for the premium tier.
- name string
- The name of the fileshare (16 characters or less)
- nfsExport InstanceOptions File Shares Nfs Export Option[] 
- Nfs Export Options. There is a limit of 10 export options per file share. Structure is documented below.
- sourceBackup string
- The resource name of the backup, in the format projects/{projectId}/locations/{locationId}/backups/{backupId}, that this file share has been restored from.
- capacity_gb int
- File share capacity in GiB. This must be at least 1024 GiB for the standard tier, or 2560 GiB for the premium tier.
- name str
- The name of the fileshare (16 characters or less)
- nfs_export_ Sequence[Instanceoptions File Shares Nfs Export Option] 
- Nfs Export Options. There is a limit of 10 export options per file share. Structure is documented below.
- source_backup str
- The resource name of the backup, in the format projects/{projectId}/locations/{locationId}/backups/{backupId}, that this file share has been restored from.
- capacityGb Number
- File share capacity in GiB. This must be at least 1024 GiB for the standard tier, or 2560 GiB for the premium tier.
- name String
- The name of the fileshare (16 characters or less)
- nfsExport List<Property Map>Options 
- Nfs Export Options. There is a limit of 10 export options per file share. Structure is documented below.
- sourceBackup String
- The resource name of the backup, in the format projects/{projectId}/locations/{locationId}/backups/{backupId}, that this file share has been restored from.
InstanceFileSharesNfsExportOption, InstanceFileSharesNfsExportOptionArgs            
- AccessMode string
- Either READ_ONLY, for allowing only read requests on the exported directory,
or READ_WRITE, for allowing both read and write requests. The default is READ_WRITE.
Default value is READ_WRITE. Possible values are:READ_ONLY,READ_WRITE.
- AnonGid int
- An integer representing the anonymous group id with a default value of 65534. Anon_gid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- AnonUid int
- An integer representing the anonymous user id with a default value of 65534. Anon_uid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- IpRanges List<string>
- List of either IPv4 addresses, or ranges in CIDR notation which may mount the file share. Overlapping IP ranges are not allowed, both within and across NfsExportOptions. An error will be returned. The limit is 64 IP ranges/addresses for each FileShareConfig among all NfsExportOptions.
- SquashMode string
- Either NO_ROOT_SQUASH, for allowing root access on the exported directory, or ROOT_SQUASH,
for not allowing root access. The default is NO_ROOT_SQUASH.
Default value is NO_ROOT_SQUASH. Possible values are:NO_ROOT_SQUASH,ROOT_SQUASH.
- AccessMode string
- Either READ_ONLY, for allowing only read requests on the exported directory,
or READ_WRITE, for allowing both read and write requests. The default is READ_WRITE.
Default value is READ_WRITE. Possible values are:READ_ONLY,READ_WRITE.
- AnonGid int
- An integer representing the anonymous group id with a default value of 65534. Anon_gid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- AnonUid int
- An integer representing the anonymous user id with a default value of 65534. Anon_uid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- IpRanges []string
- List of either IPv4 addresses, or ranges in CIDR notation which may mount the file share. Overlapping IP ranges are not allowed, both within and across NfsExportOptions. An error will be returned. The limit is 64 IP ranges/addresses for each FileShareConfig among all NfsExportOptions.
- SquashMode string
- Either NO_ROOT_SQUASH, for allowing root access on the exported directory, or ROOT_SQUASH,
for not allowing root access. The default is NO_ROOT_SQUASH.
Default value is NO_ROOT_SQUASH. Possible values are:NO_ROOT_SQUASH,ROOT_SQUASH.
- accessMode String
- Either READ_ONLY, for allowing only read requests on the exported directory,
or READ_WRITE, for allowing both read and write requests. The default is READ_WRITE.
Default value is READ_WRITE. Possible values are:READ_ONLY,READ_WRITE.
- anonGid Integer
- An integer representing the anonymous group id with a default value of 65534. Anon_gid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- anonUid Integer
- An integer representing the anonymous user id with a default value of 65534. Anon_uid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- ipRanges List<String>
- List of either IPv4 addresses, or ranges in CIDR notation which may mount the file share. Overlapping IP ranges are not allowed, both within and across NfsExportOptions. An error will be returned. The limit is 64 IP ranges/addresses for each FileShareConfig among all NfsExportOptions.
- squashMode String
- Either NO_ROOT_SQUASH, for allowing root access on the exported directory, or ROOT_SQUASH,
for not allowing root access. The default is NO_ROOT_SQUASH.
Default value is NO_ROOT_SQUASH. Possible values are:NO_ROOT_SQUASH,ROOT_SQUASH.
- accessMode string
- Either READ_ONLY, for allowing only read requests on the exported directory,
or READ_WRITE, for allowing both read and write requests. The default is READ_WRITE.
Default value is READ_WRITE. Possible values are:READ_ONLY,READ_WRITE.
- anonGid number
- An integer representing the anonymous group id with a default value of 65534. Anon_gid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- anonUid number
- An integer representing the anonymous user id with a default value of 65534. Anon_uid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- ipRanges string[]
- List of either IPv4 addresses, or ranges in CIDR notation which may mount the file share. Overlapping IP ranges are not allowed, both within and across NfsExportOptions. An error will be returned. The limit is 64 IP ranges/addresses for each FileShareConfig among all NfsExportOptions.
- squashMode string
- Either NO_ROOT_SQUASH, for allowing root access on the exported directory, or ROOT_SQUASH,
for not allowing root access. The default is NO_ROOT_SQUASH.
Default value is NO_ROOT_SQUASH. Possible values are:NO_ROOT_SQUASH,ROOT_SQUASH.
- access_mode str
- Either READ_ONLY, for allowing only read requests on the exported directory,
or READ_WRITE, for allowing both read and write requests. The default is READ_WRITE.
Default value is READ_WRITE. Possible values are:READ_ONLY,READ_WRITE.
- anon_gid int
- An integer representing the anonymous group id with a default value of 65534. Anon_gid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- anon_uid int
- An integer representing the anonymous user id with a default value of 65534. Anon_uid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- ip_ranges Sequence[str]
- List of either IPv4 addresses, or ranges in CIDR notation which may mount the file share. Overlapping IP ranges are not allowed, both within and across NfsExportOptions. An error will be returned. The limit is 64 IP ranges/addresses for each FileShareConfig among all NfsExportOptions.
- squash_mode str
- Either NO_ROOT_SQUASH, for allowing root access on the exported directory, or ROOT_SQUASH,
for not allowing root access. The default is NO_ROOT_SQUASH.
Default value is NO_ROOT_SQUASH. Possible values are:NO_ROOT_SQUASH,ROOT_SQUASH.
- accessMode String
- Either READ_ONLY, for allowing only read requests on the exported directory,
or READ_WRITE, for allowing both read and write requests. The default is READ_WRITE.
Default value is READ_WRITE. Possible values are:READ_ONLY,READ_WRITE.
- anonGid Number
- An integer representing the anonymous group id with a default value of 65534. Anon_gid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- anonUid Number
- An integer representing the anonymous user id with a default value of 65534. Anon_uid may only be set with squashMode of ROOT_SQUASH. An error will be returned if this field is specified for other squashMode settings.
- ipRanges List<String>
- List of either IPv4 addresses, or ranges in CIDR notation which may mount the file share. Overlapping IP ranges are not allowed, both within and across NfsExportOptions. An error will be returned. The limit is 64 IP ranges/addresses for each FileShareConfig among all NfsExportOptions.
- squashMode String
- Either NO_ROOT_SQUASH, for allowing root access on the exported directory, or ROOT_SQUASH,
for not allowing root access. The default is NO_ROOT_SQUASH.
Default value is NO_ROOT_SQUASH. Possible values are:NO_ROOT_SQUASH,ROOT_SQUASH.
InstanceInitialReplication, InstanceInitialReplicationArgs      
- Replicas
List<InstanceInitial Replication Replica> 
- The replication role. Structure is documented below.
- Role string
- The replication role.
Default value is STANDBY. Possible values are:ROLE_UNSPECIFIED,ACTIVE,STANDBY.
- Replicas
[]InstanceInitial Replication Replica 
- The replication role. Structure is documented below.
- Role string
- The replication role.
Default value is STANDBY. Possible values are:ROLE_UNSPECIFIED,ACTIVE,STANDBY.
- replicas
List<InstanceInitial Replication Replica> 
- The replication role. Structure is documented below.
- role String
- The replication role.
Default value is STANDBY. Possible values are:ROLE_UNSPECIFIED,ACTIVE,STANDBY.
- replicas
InstanceInitial Replication Replica[] 
- The replication role. Structure is documented below.
- role string
- The replication role.
Default value is STANDBY. Possible values are:ROLE_UNSPECIFIED,ACTIVE,STANDBY.
- replicas
Sequence[InstanceInitial Replication Replica] 
- The replication role. Structure is documented below.
- role str
- The replication role.
Default value is STANDBY. Possible values are:ROLE_UNSPECIFIED,ACTIVE,STANDBY.
- replicas List<Property Map>
- The replication role. Structure is documented below.
- role String
- The replication role.
Default value is STANDBY. Possible values are:ROLE_UNSPECIFIED,ACTIVE,STANDBY.
InstanceInitialReplicationReplica, InstanceInitialReplicationReplicaArgs        
- PeerInstance string
- The peer instance.
- PeerInstance string
- The peer instance.
- peerInstance String
- The peer instance.
- peerInstance string
- The peer instance.
- peer_instance str
- The peer instance.
- peerInstance String
- The peer instance.
InstanceNetwork, InstanceNetworkArgs    
- Modes List<string>
- IP versions for which the instance has
IP addresses assigned.
Each value may be one of: ADDRESS_MODE_UNSPECIFIED,MODE_IPV4,MODE_IPV6.
- Network string
- The name of the GCE VPC network to which the instance is connected.
- ConnectMode string
- The network connect mode of the Filestore instance.
If not provided, the connect mode defaults to
DIRECT_PEERING.
Default value is DIRECT_PEERING. Possible values are:DIRECT_PEERING,PRIVATE_SERVICE_ACCESS.
- IpAddresses List<string>
- (Output) A list of IPv4 or IPv6 addresses.
- ReservedIp stringRange 
- A /29 CIDR block that identifies the range of IP addresses reserved for this instance.
- Modes []string
- IP versions for which the instance has
IP addresses assigned.
Each value may be one of: ADDRESS_MODE_UNSPECIFIED,MODE_IPV4,MODE_IPV6.
- Network string
- The name of the GCE VPC network to which the instance is connected.
- ConnectMode string
- The network connect mode of the Filestore instance.
If not provided, the connect mode defaults to
DIRECT_PEERING.
Default value is DIRECT_PEERING. Possible values are:DIRECT_PEERING,PRIVATE_SERVICE_ACCESS.
- IpAddresses []string
- (Output) A list of IPv4 or IPv6 addresses.
- ReservedIp stringRange 
- A /29 CIDR block that identifies the range of IP addresses reserved for this instance.
- modes List<String>
- IP versions for which the instance has
IP addresses assigned.
Each value may be one of: ADDRESS_MODE_UNSPECIFIED,MODE_IPV4,MODE_IPV6.
- network String
- The name of the GCE VPC network to which the instance is connected.
- connectMode String
- The network connect mode of the Filestore instance.
If not provided, the connect mode defaults to
DIRECT_PEERING.
Default value is DIRECT_PEERING. Possible values are:DIRECT_PEERING,PRIVATE_SERVICE_ACCESS.
- ipAddresses List<String>
- (Output) A list of IPv4 or IPv6 addresses.
- reservedIp StringRange 
- A /29 CIDR block that identifies the range of IP addresses reserved for this instance.
- modes string[]
- IP versions for which the instance has
IP addresses assigned.
Each value may be one of: ADDRESS_MODE_UNSPECIFIED,MODE_IPV4,MODE_IPV6.
- network string
- The name of the GCE VPC network to which the instance is connected.
- connectMode string
- The network connect mode of the Filestore instance.
If not provided, the connect mode defaults to
DIRECT_PEERING.
Default value is DIRECT_PEERING. Possible values are:DIRECT_PEERING,PRIVATE_SERVICE_ACCESS.
- ipAddresses string[]
- (Output) A list of IPv4 or IPv6 addresses.
- reservedIp stringRange 
- A /29 CIDR block that identifies the range of IP addresses reserved for this instance.
- modes Sequence[str]
- IP versions for which the instance has
IP addresses assigned.
Each value may be one of: ADDRESS_MODE_UNSPECIFIED,MODE_IPV4,MODE_IPV6.
- network str
- The name of the GCE VPC network to which the instance is connected.
- connect_mode str
- The network connect mode of the Filestore instance.
If not provided, the connect mode defaults to
DIRECT_PEERING.
Default value is DIRECT_PEERING. Possible values are:DIRECT_PEERING,PRIVATE_SERVICE_ACCESS.
- ip_addresses Sequence[str]
- (Output) A list of IPv4 or IPv6 addresses.
- reserved_ip_ strrange 
- A /29 CIDR block that identifies the range of IP addresses reserved for this instance.
- modes List<String>
- IP versions for which the instance has
IP addresses assigned.
Each value may be one of: ADDRESS_MODE_UNSPECIFIED,MODE_IPV4,MODE_IPV6.
- network String
- The name of the GCE VPC network to which the instance is connected.
- connectMode String
- The network connect mode of the Filestore instance.
If not provided, the connect mode defaults to
DIRECT_PEERING.
Default value is DIRECT_PEERING. Possible values are:DIRECT_PEERING,PRIVATE_SERVICE_ACCESS.
- ipAddresses List<String>
- (Output) A list of IPv4 or IPv6 addresses.
- reservedIp StringRange 
- A /29 CIDR block that identifies the range of IP addresses reserved for this instance.
InstancePerformanceConfig, InstancePerformanceConfigArgs      
- FixedIops InstancePerformance Config Fixed Iops 
- The instance will have a fixed provisioned IOPS value, which will remain constant regardless of instance capacity. Structure is documented below.
- IopsPer InstanceTb Performance Config Iops Per Tb 
- The instance provisioned IOPS will change dynamically based on the capacity of the instance. Structure is documented below.
- FixedIops InstancePerformance Config Fixed Iops 
- The instance will have a fixed provisioned IOPS value, which will remain constant regardless of instance capacity. Structure is documented below.
- IopsPer InstanceTb Performance Config Iops Per Tb 
- The instance provisioned IOPS will change dynamically based on the capacity of the instance. Structure is documented below.
- fixedIops InstancePerformance Config Fixed Iops 
- The instance will have a fixed provisioned IOPS value, which will remain constant regardless of instance capacity. Structure is documented below.
- iopsPer InstanceTb Performance Config Iops Per Tb 
- The instance provisioned IOPS will change dynamically based on the capacity of the instance. Structure is documented below.
- fixedIops InstancePerformance Config Fixed Iops 
- The instance will have a fixed provisioned IOPS value, which will remain constant regardless of instance capacity. Structure is documented below.
- iopsPer InstanceTb Performance Config Iops Per Tb 
- The instance provisioned IOPS will change dynamically based on the capacity of the instance. Structure is documented below.
- fixed_iops InstancePerformance Config Fixed Iops 
- The instance will have a fixed provisioned IOPS value, which will remain constant regardless of instance capacity. Structure is documented below.
- iops_per_ Instancetb Performance Config Iops Per Tb 
- The instance provisioned IOPS will change dynamically based on the capacity of the instance. Structure is documented below.
- fixedIops Property Map
- The instance will have a fixed provisioned IOPS value, which will remain constant regardless of instance capacity. Structure is documented below.
- iopsPer Property MapTb 
- The instance provisioned IOPS will change dynamically based on the capacity of the instance. Structure is documented below.
InstancePerformanceConfigFixedIops, InstancePerformanceConfigFixedIopsArgs          
- MaxIops int
- The number of IOPS to provision for the instance. max_iops must be in multiple of 1000.
- MaxIops int
- The number of IOPS to provision for the instance. max_iops must be in multiple of 1000.
- maxIops Integer
- The number of IOPS to provision for the instance. max_iops must be in multiple of 1000.
- maxIops number
- The number of IOPS to provision for the instance. max_iops must be in multiple of 1000.
- max_iops int
- The number of IOPS to provision for the instance. max_iops must be in multiple of 1000.
- maxIops Number
- The number of IOPS to provision for the instance. max_iops must be in multiple of 1000.
InstancePerformanceConfigIopsPerTb, InstancePerformanceConfigIopsPerTbArgs            
- MaxIops intPer Tb 
- The instance max IOPS will be calculated by multiplying the capacity of the instance (TB) by max_iops_per_tb, and rounding to the nearest 1000. The instance max IOPS will be changed dynamically based on the instance capacity.
- MaxIops intPer Tb 
- The instance max IOPS will be calculated by multiplying the capacity of the instance (TB) by max_iops_per_tb, and rounding to the nearest 1000. The instance max IOPS will be changed dynamically based on the instance capacity.
- maxIops IntegerPer Tb 
- The instance max IOPS will be calculated by multiplying the capacity of the instance (TB) by max_iops_per_tb, and rounding to the nearest 1000. The instance max IOPS will be changed dynamically based on the instance capacity.
- maxIops numberPer Tb 
- The instance max IOPS will be calculated by multiplying the capacity of the instance (TB) by max_iops_per_tb, and rounding to the nearest 1000. The instance max IOPS will be changed dynamically based on the instance capacity.
- max_iops_ intper_ tb 
- The instance max IOPS will be calculated by multiplying the capacity of the instance (TB) by max_iops_per_tb, and rounding to the nearest 1000. The instance max IOPS will be changed dynamically based on the instance capacity.
- maxIops NumberPer Tb 
- The instance max IOPS will be calculated by multiplying the capacity of the instance (TB) by max_iops_per_tb, and rounding to the nearest 1000. The instance max IOPS will be changed dynamically based on the instance capacity.
Import
Instance can be imported using any of these accepted formats:
- projects/{{project}}/locations/{{location}}/instances/{{name}}
- {{project}}/{{location}}/{{name}}
- {{location}}/{{name}}
When using the pulumi import command, Instance can be imported using one of the formats above. For example:
$ pulumi import gcp:filestore/instance:Instance default projects/{{project}}/locations/{{location}}/instances/{{name}}
$ pulumi import gcp:filestore/instance:Instance default {{project}}/{{location}}/{{name}}
$ pulumi import gcp:filestore/instance:Instance default {{location}}/{{name}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the google-betaTerraform Provider.