1. Packages
  2. AWS Classic
  3. API Docs
  4. neptune
  5. ClusterInstance

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.13.2 published on Thursday, Dec 7, 2023 by Pulumi

aws.neptune.ClusterInstance

Explore with Pulumi AI

aws logo

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.13.2 published on Thursday, Dec 7, 2023 by Pulumi

    A Cluster Instance Resource defines attributes that are specific to a single instance in a Neptune Cluster.

    You can simply add neptune instances and Neptune manages the replication. You can use the count meta-parameter to make multiple instances and join them all to the same Neptune Cluster, or you may specify different Cluster Instance resources with various instance_class sizes.

    Example Usage

    The following example will create a neptune cluster with two neptune instances(one writer and one reader).

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var @default = new Aws.Neptune.Cluster("default", new()
        {
            ClusterIdentifier = "neptune-cluster-demo",
            Engine = "neptune",
            BackupRetentionPeriod = 5,
            PreferredBackupWindow = "07:00-09:00",
            SkipFinalSnapshot = true,
            IamDatabaseAuthenticationEnabled = true,
            ApplyImmediately = true,
        });
    
        var example = new List<Aws.Neptune.ClusterInstance>();
        for (var rangeIndex = 0; rangeIndex < 2; rangeIndex++)
        {
            var range = new { Value = rangeIndex };
            example.Add(new Aws.Neptune.ClusterInstance($"example-{range.Value}", new()
            {
                ClusterIdentifier = @default.Id,
                Engine = "neptune",
                InstanceClass = "db.r4.large",
                ApplyImmediately = true,
            }));
        }
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/neptune"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := neptune.NewCluster(ctx, "default", &neptune.ClusterArgs{
    			ClusterIdentifier:                pulumi.String("neptune-cluster-demo"),
    			Engine:                           pulumi.String("neptune"),
    			BackupRetentionPeriod:            pulumi.Int(5),
    			PreferredBackupWindow:            pulumi.String("07:00-09:00"),
    			SkipFinalSnapshot:                pulumi.Bool(true),
    			IamDatabaseAuthenticationEnabled: pulumi.Bool(true),
    			ApplyImmediately:                 pulumi.Bool(true),
    		})
    		if err != nil {
    			return err
    		}
    		var example []*neptune.ClusterInstance
    		for index := 0; index < 2; index++ {
    			key0 := index
    			_ := index
    			__res, err := neptune.NewClusterInstance(ctx, fmt.Sprintf("example-%v", key0), &neptune.ClusterInstanceArgs{
    				ClusterIdentifier: _default.ID(),
    				Engine:            pulumi.String("neptune"),
    				InstanceClass:     pulumi.String("db.r4.large"),
    				ApplyImmediately:  pulumi.Bool(true),
    			})
    			if err != nil {
    				return err
    			}
    			example = append(example, __res)
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.neptune.Cluster;
    import com.pulumi.aws.neptune.ClusterArgs;
    import com.pulumi.aws.neptune.ClusterInstance;
    import com.pulumi.aws.neptune.ClusterInstanceArgs;
    import com.pulumi.codegen.internal.KeyedValue;
    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 default_ = new Cluster("default", ClusterArgs.builder()        
                .clusterIdentifier("neptune-cluster-demo")
                .engine("neptune")
                .backupRetentionPeriod(5)
                .preferredBackupWindow("07:00-09:00")
                .skipFinalSnapshot(true)
                .iamDatabaseAuthenticationEnabled(true)
                .applyImmediately(true)
                .build());
    
            for (var i = 0; i < 2; i++) {
                new ClusterInstance("example-" + i, ClusterInstanceArgs.builder()            
                    .clusterIdentifier(default_.id())
                    .engine("neptune")
                    .instanceClass("db.r4.large")
                    .applyImmediately(true)
                    .build());
    
            
    }
        }
    }
    
    import pulumi
    import pulumi_aws as aws
    
    default = aws.neptune.Cluster("default",
        cluster_identifier="neptune-cluster-demo",
        engine="neptune",
        backup_retention_period=5,
        preferred_backup_window="07:00-09:00",
        skip_final_snapshot=True,
        iam_database_authentication_enabled=True,
        apply_immediately=True)
    example = []
    for range in [{"value": i} for i in range(0, 2)]:
        example.append(aws.neptune.ClusterInstance(f"example-{range['value']}",
            cluster_identifier=default.id,
            engine="neptune",
            instance_class="db.r4.large",
            apply_immediately=True))
    
    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const _default = new aws.neptune.Cluster("default", {
        clusterIdentifier: "neptune-cluster-demo",
        engine: "neptune",
        backupRetentionPeriod: 5,
        preferredBackupWindow: "07:00-09:00",
        skipFinalSnapshot: true,
        iamDatabaseAuthenticationEnabled: true,
        applyImmediately: true,
    });
    const example: aws.neptune.ClusterInstance[] = [];
    for (const range = {value: 0}; range.value < 2; range.value++) {
        example.push(new aws.neptune.ClusterInstance(`example-${range.value}`, {
            clusterIdentifier: _default.id,
            engine: "neptune",
            instanceClass: "db.r4.large",
            applyImmediately: true,
        }));
    }
    
    resources:
      default:
        type: aws:neptune:Cluster
        properties:
          clusterIdentifier: neptune-cluster-demo
          engine: neptune
          backupRetentionPeriod: 5
          preferredBackupWindow: 07:00-09:00
          skipFinalSnapshot: true
          iamDatabaseAuthenticationEnabled: true
          applyImmediately: true
      example:
        type: aws:neptune:ClusterInstance
        properties:
          clusterIdentifier: ${default.id}
          engine: neptune
          instanceClass: db.r4.large
          applyImmediately: true
        options: {}
    

    Create ClusterInstance Resource

    new ClusterInstance(name: string, args: ClusterInstanceArgs, opts?: CustomResourceOptions);
    @overload
    def ClusterInstance(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        apply_immediately: Optional[bool] = None,
                        auto_minor_version_upgrade: Optional[bool] = None,
                        availability_zone: Optional[str] = None,
                        cluster_identifier: Optional[str] = None,
                        engine: Optional[str] = None,
                        engine_version: Optional[str] = None,
                        identifier: Optional[str] = None,
                        identifier_prefix: Optional[str] = None,
                        instance_class: Optional[str] = None,
                        neptune_parameter_group_name: Optional[str] = None,
                        neptune_subnet_group_name: Optional[str] = None,
                        port: Optional[int] = None,
                        preferred_backup_window: Optional[str] = None,
                        preferred_maintenance_window: Optional[str] = None,
                        promotion_tier: Optional[int] = None,
                        publicly_accessible: Optional[bool] = None,
                        tags: Optional[Mapping[str, str]] = None)
    @overload
    def ClusterInstance(resource_name: str,
                        args: ClusterInstanceArgs,
                        opts: Optional[ResourceOptions] = None)
    func NewClusterInstance(ctx *Context, name string, args ClusterInstanceArgs, opts ...ResourceOption) (*ClusterInstance, error)
    public ClusterInstance(string name, ClusterInstanceArgs args, CustomResourceOptions? opts = null)
    public ClusterInstance(String name, ClusterInstanceArgs args)
    public ClusterInstance(String name, ClusterInstanceArgs args, CustomResourceOptions options)
    
    type: aws:neptune:ClusterInstance
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    name string
    The unique name of the resource.
    args ClusterInstanceArgs
    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 ClusterInstanceArgs
    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 ClusterInstanceArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ClusterInstanceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ClusterInstanceArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    ClusterInstance Resource Properties

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

    Inputs

    The ClusterInstance resource accepts the following input properties:

    ClusterIdentifier string

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    InstanceClass string

    The instance class to use.

    ApplyImmediately bool

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    AutoMinorVersionUpgrade bool

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    AvailabilityZone string

    The EC2 Availability Zone that the neptune instance is created in.

    Engine string

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    EngineVersion string

    The neptune engine version. Currently configuring this argumnet has no effect.

    Identifier string

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    IdentifierPrefix string

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    NeptuneParameterGroupName string

    The name of the neptune parameter group to associate with this instance.

    NeptuneSubnetGroupName string

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    Port int

    The port on which the DB accepts connections. Defaults to 8182.

    PreferredBackupWindow string

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    PreferredMaintenanceWindow string

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    PromotionTier int

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    PubliclyAccessible bool

    Bool to control if instance is publicly accessible. Default is false.

    Tags Dictionary<string, string>

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    ClusterIdentifier string

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    InstanceClass string

    The instance class to use.

    ApplyImmediately bool

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    AutoMinorVersionUpgrade bool

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    AvailabilityZone string

    The EC2 Availability Zone that the neptune instance is created in.

    Engine string

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    EngineVersion string

    The neptune engine version. Currently configuring this argumnet has no effect.

    Identifier string

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    IdentifierPrefix string

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    NeptuneParameterGroupName string

    The name of the neptune parameter group to associate with this instance.

    NeptuneSubnetGroupName string

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    Port int

    The port on which the DB accepts connections. Defaults to 8182.

    PreferredBackupWindow string

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    PreferredMaintenanceWindow string

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    PromotionTier int

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    PubliclyAccessible bool

    Bool to control if instance is publicly accessible. Default is false.

    Tags map[string]string

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    clusterIdentifier String

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    instanceClass String

    The instance class to use.

    applyImmediately Boolean

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    autoMinorVersionUpgrade Boolean

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    availabilityZone String

    The EC2 Availability Zone that the neptune instance is created in.

    engine String

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    engineVersion String

    The neptune engine version. Currently configuring this argumnet has no effect.

    identifier String

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    identifierPrefix String

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    neptuneParameterGroupName String

    The name of the neptune parameter group to associate with this instance.

    neptuneSubnetGroupName String

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    port Integer

    The port on which the DB accepts connections. Defaults to 8182.

    preferredBackupWindow String

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    preferredMaintenanceWindow String

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    promotionTier Integer

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    publiclyAccessible Boolean

    Bool to control if instance is publicly accessible. Default is false.

    tags Map<String,String>

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    clusterIdentifier string

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    instanceClass string

    The instance class to use.

    applyImmediately boolean

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    autoMinorVersionUpgrade boolean

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    availabilityZone string

    The EC2 Availability Zone that the neptune instance is created in.

    engine string

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    engineVersion string

    The neptune engine version. Currently configuring this argumnet has no effect.

    identifier string

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    identifierPrefix string

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    neptuneParameterGroupName string

    The name of the neptune parameter group to associate with this instance.

    neptuneSubnetGroupName string

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    port number

    The port on which the DB accepts connections. Defaults to 8182.

    preferredBackupWindow string

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    preferredMaintenanceWindow string

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    promotionTier number

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    publiclyAccessible boolean

    Bool to control if instance is publicly accessible. Default is false.

    tags {[key: string]: string}

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    cluster_identifier str

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    instance_class str

    The instance class to use.

    apply_immediately bool

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    auto_minor_version_upgrade bool

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    availability_zone str

    The EC2 Availability Zone that the neptune instance is created in.

    engine str

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    engine_version str

    The neptune engine version. Currently configuring this argumnet has no effect.

    identifier str

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    identifier_prefix str

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    neptune_parameter_group_name str

    The name of the neptune parameter group to associate with this instance.

    neptune_subnet_group_name str

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    port int

    The port on which the DB accepts connections. Defaults to 8182.

    preferred_backup_window str

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    preferred_maintenance_window str

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    promotion_tier int

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    publicly_accessible bool

    Bool to control if instance is publicly accessible. Default is false.

    tags Mapping[str, str]

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    clusterIdentifier String

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    instanceClass String

    The instance class to use.

    applyImmediately Boolean

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    autoMinorVersionUpgrade Boolean

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    availabilityZone String

    The EC2 Availability Zone that the neptune instance is created in.

    engine String

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    engineVersion String

    The neptune engine version. Currently configuring this argumnet has no effect.

    identifier String

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    identifierPrefix String

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    neptuneParameterGroupName String

    The name of the neptune parameter group to associate with this instance.

    neptuneSubnetGroupName String

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    port Number

    The port on which the DB accepts connections. Defaults to 8182.

    preferredBackupWindow String

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    preferredMaintenanceWindow String

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    promotionTier Number

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    publiclyAccessible Boolean

    Bool to control if instance is publicly accessible. Default is false.

    tags Map<String>

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    Outputs

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

    Address string

    The hostname of the instance. See also endpoint and port.

    Arn string

    Amazon Resource Name (ARN) of neptune instance

    DbiResourceId string

    The region-unique, immutable identifier for the neptune instance.

    Endpoint string

    The connection endpoint in address:port format.

    Id string

    The provider-assigned unique ID for this managed resource.

    KmsKeyArn string

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    StorageEncrypted bool

    Specifies whether the neptune cluster is encrypted.

    TagsAll Dictionary<string, string>

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    Writer bool

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    Address string

    The hostname of the instance. See also endpoint and port.

    Arn string

    Amazon Resource Name (ARN) of neptune instance

    DbiResourceId string

    The region-unique, immutable identifier for the neptune instance.

    Endpoint string

    The connection endpoint in address:port format.

    Id string

    The provider-assigned unique ID for this managed resource.

    KmsKeyArn string

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    StorageEncrypted bool

    Specifies whether the neptune cluster is encrypted.

    TagsAll map[string]string

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    Writer bool

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    address String

    The hostname of the instance. See also endpoint and port.

    arn String

    Amazon Resource Name (ARN) of neptune instance

    dbiResourceId String

    The region-unique, immutable identifier for the neptune instance.

    endpoint String

    The connection endpoint in address:port format.

    id String

    The provider-assigned unique ID for this managed resource.

    kmsKeyArn String

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    storageEncrypted Boolean

    Specifies whether the neptune cluster is encrypted.

    tagsAll Map<String,String>

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    writer Boolean

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    address string

    The hostname of the instance. See also endpoint and port.

    arn string

    Amazon Resource Name (ARN) of neptune instance

    dbiResourceId string

    The region-unique, immutable identifier for the neptune instance.

    endpoint string

    The connection endpoint in address:port format.

    id string

    The provider-assigned unique ID for this managed resource.

    kmsKeyArn string

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    storageEncrypted boolean

    Specifies whether the neptune cluster is encrypted.

    tagsAll {[key: string]: string}

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    writer boolean

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    address str

    The hostname of the instance. See also endpoint and port.

    arn str

    Amazon Resource Name (ARN) of neptune instance

    dbi_resource_id str

    The region-unique, immutable identifier for the neptune instance.

    endpoint str

    The connection endpoint in address:port format.

    id str

    The provider-assigned unique ID for this managed resource.

    kms_key_arn str

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    storage_encrypted bool

    Specifies whether the neptune cluster is encrypted.

    tags_all Mapping[str, str]

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    writer bool

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    address String

    The hostname of the instance. See also endpoint and port.

    arn String

    Amazon Resource Name (ARN) of neptune instance

    dbiResourceId String

    The region-unique, immutable identifier for the neptune instance.

    endpoint String

    The connection endpoint in address:port format.

    id String

    The provider-assigned unique ID for this managed resource.

    kmsKeyArn String

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    storageEncrypted Boolean

    Specifies whether the neptune cluster is encrypted.

    tagsAll Map<String>

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    writer Boolean

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    Look up Existing ClusterInstance Resource

    Get an existing ClusterInstance 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?: ClusterInstanceState, opts?: CustomResourceOptions): ClusterInstance
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            address: Optional[str] = None,
            apply_immediately: Optional[bool] = None,
            arn: Optional[str] = None,
            auto_minor_version_upgrade: Optional[bool] = None,
            availability_zone: Optional[str] = None,
            cluster_identifier: Optional[str] = None,
            dbi_resource_id: Optional[str] = None,
            endpoint: Optional[str] = None,
            engine: Optional[str] = None,
            engine_version: Optional[str] = None,
            identifier: Optional[str] = None,
            identifier_prefix: Optional[str] = None,
            instance_class: Optional[str] = None,
            kms_key_arn: Optional[str] = None,
            neptune_parameter_group_name: Optional[str] = None,
            neptune_subnet_group_name: Optional[str] = None,
            port: Optional[int] = None,
            preferred_backup_window: Optional[str] = None,
            preferred_maintenance_window: Optional[str] = None,
            promotion_tier: Optional[int] = None,
            publicly_accessible: Optional[bool] = None,
            storage_encrypted: Optional[bool] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_all: Optional[Mapping[str, str]] = None,
            writer: Optional[bool] = None) -> ClusterInstance
    func GetClusterInstance(ctx *Context, name string, id IDInput, state *ClusterInstanceState, opts ...ResourceOption) (*ClusterInstance, error)
    public static ClusterInstance Get(string name, Input<string> id, ClusterInstanceState? state, CustomResourceOptions? opts = null)
    public static ClusterInstance get(String name, Output<String> id, ClusterInstanceState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Address string

    The hostname of the instance. See also endpoint and port.

    ApplyImmediately bool

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    Arn string

    Amazon Resource Name (ARN) of neptune instance

    AutoMinorVersionUpgrade bool

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    AvailabilityZone string

    The EC2 Availability Zone that the neptune instance is created in.

    ClusterIdentifier string

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    DbiResourceId string

    The region-unique, immutable identifier for the neptune instance.

    Endpoint string

    The connection endpoint in address:port format.

    Engine string

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    EngineVersion string

    The neptune engine version. Currently configuring this argumnet has no effect.

    Identifier string

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    IdentifierPrefix string

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    InstanceClass string

    The instance class to use.

    KmsKeyArn string

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    NeptuneParameterGroupName string

    The name of the neptune parameter group to associate with this instance.

    NeptuneSubnetGroupName string

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    Port int

    The port on which the DB accepts connections. Defaults to 8182.

    PreferredBackupWindow string

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    PreferredMaintenanceWindow string

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    PromotionTier int

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    PubliclyAccessible bool

    Bool to control if instance is publicly accessible. Default is false.

    StorageEncrypted bool

    Specifies whether the neptune cluster is encrypted.

    Tags Dictionary<string, string>

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    TagsAll Dictionary<string, string>

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    Writer bool

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    Address string

    The hostname of the instance. See also endpoint and port.

    ApplyImmediately bool

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    Arn string

    Amazon Resource Name (ARN) of neptune instance

    AutoMinorVersionUpgrade bool

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    AvailabilityZone string

    The EC2 Availability Zone that the neptune instance is created in.

    ClusterIdentifier string

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    DbiResourceId string

    The region-unique, immutable identifier for the neptune instance.

    Endpoint string

    The connection endpoint in address:port format.

    Engine string

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    EngineVersion string

    The neptune engine version. Currently configuring this argumnet has no effect.

    Identifier string

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    IdentifierPrefix string

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    InstanceClass string

    The instance class to use.

    KmsKeyArn string

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    NeptuneParameterGroupName string

    The name of the neptune parameter group to associate with this instance.

    NeptuneSubnetGroupName string

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    Port int

    The port on which the DB accepts connections. Defaults to 8182.

    PreferredBackupWindow string

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    PreferredMaintenanceWindow string

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    PromotionTier int

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    PubliclyAccessible bool

    Bool to control if instance is publicly accessible. Default is false.

    StorageEncrypted bool

    Specifies whether the neptune cluster is encrypted.

    Tags map[string]string

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    TagsAll map[string]string

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    Writer bool

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    address String

    The hostname of the instance. See also endpoint and port.

    applyImmediately Boolean

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    arn String

    Amazon Resource Name (ARN) of neptune instance

    autoMinorVersionUpgrade Boolean

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    availabilityZone String

    The EC2 Availability Zone that the neptune instance is created in.

    clusterIdentifier String

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    dbiResourceId String

    The region-unique, immutable identifier for the neptune instance.

    endpoint String

    The connection endpoint in address:port format.

    engine String

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    engineVersion String

    The neptune engine version. Currently configuring this argumnet has no effect.

    identifier String

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    identifierPrefix String

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    instanceClass String

    The instance class to use.

    kmsKeyArn String

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    neptuneParameterGroupName String

    The name of the neptune parameter group to associate with this instance.

    neptuneSubnetGroupName String

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    port Integer

    The port on which the DB accepts connections. Defaults to 8182.

    preferredBackupWindow String

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    preferredMaintenanceWindow String

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    promotionTier Integer

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    publiclyAccessible Boolean

    Bool to control if instance is publicly accessible. Default is false.

    storageEncrypted Boolean

    Specifies whether the neptune cluster is encrypted.

    tags Map<String,String>

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    tagsAll Map<String,String>

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    writer Boolean

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    address string

    The hostname of the instance. See also endpoint and port.

    applyImmediately boolean

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    arn string

    Amazon Resource Name (ARN) of neptune instance

    autoMinorVersionUpgrade boolean

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    availabilityZone string

    The EC2 Availability Zone that the neptune instance is created in.

    clusterIdentifier string

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    dbiResourceId string

    The region-unique, immutable identifier for the neptune instance.

    endpoint string

    The connection endpoint in address:port format.

    engine string

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    engineVersion string

    The neptune engine version. Currently configuring this argumnet has no effect.

    identifier string

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    identifierPrefix string

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    instanceClass string

    The instance class to use.

    kmsKeyArn string

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    neptuneParameterGroupName string

    The name of the neptune parameter group to associate with this instance.

    neptuneSubnetGroupName string

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    port number

    The port on which the DB accepts connections. Defaults to 8182.

    preferredBackupWindow string

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    preferredMaintenanceWindow string

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    promotionTier number

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    publiclyAccessible boolean

    Bool to control if instance is publicly accessible. Default is false.

    storageEncrypted boolean

    Specifies whether the neptune cluster is encrypted.

    tags {[key: string]: string}

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    tagsAll {[key: string]: string}

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    writer boolean

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    address str

    The hostname of the instance. See also endpoint and port.

    apply_immediately bool

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    arn str

    Amazon Resource Name (ARN) of neptune instance

    auto_minor_version_upgrade bool

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    availability_zone str

    The EC2 Availability Zone that the neptune instance is created in.

    cluster_identifier str

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    dbi_resource_id str

    The region-unique, immutable identifier for the neptune instance.

    endpoint str

    The connection endpoint in address:port format.

    engine str

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    engine_version str

    The neptune engine version. Currently configuring this argumnet has no effect.

    identifier str

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    identifier_prefix str

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    instance_class str

    The instance class to use.

    kms_key_arn str

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    neptune_parameter_group_name str

    The name of the neptune parameter group to associate with this instance.

    neptune_subnet_group_name str

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    port int

    The port on which the DB accepts connections. Defaults to 8182.

    preferred_backup_window str

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    preferred_maintenance_window str

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    promotion_tier int

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    publicly_accessible bool

    Bool to control if instance is publicly accessible. Default is false.

    storage_encrypted bool

    Specifies whether the neptune cluster is encrypted.

    tags Mapping[str, str]

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    tags_all Mapping[str, str]

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    writer bool

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    address String

    The hostname of the instance. See also endpoint and port.

    applyImmediately Boolean

    Specifies whether any instance modifications are applied immediately, or during the next maintenance window. Default isfalse.

    arn String

    Amazon Resource Name (ARN) of neptune instance

    autoMinorVersionUpgrade Boolean

    Indicates that minor engine upgrades will be applied automatically to the instance during the maintenance window. Default is true.

    availabilityZone String

    The EC2 Availability Zone that the neptune instance is created in.

    clusterIdentifier String

    The identifier of the aws.neptune.Cluster in which to launch this instance.

    dbiResourceId String

    The region-unique, immutable identifier for the neptune instance.

    endpoint String

    The connection endpoint in address:port format.

    engine String

    The name of the database engine to be used for the neptune instance. Defaults to neptune. Valid Values: neptune.

    engineVersion String

    The neptune engine version. Currently configuring this argumnet has no effect.

    identifier String

    The identifier for the neptune instance, if omitted, this provider will assign a random, unique identifier.

    identifierPrefix String

    Creates a unique identifier beginning with the specified prefix. Conflicts with identifier.

    instanceClass String

    The instance class to use.

    kmsKeyArn String

    The ARN for the KMS encryption key if one is set to the neptune cluster.

    neptuneParameterGroupName String

    The name of the neptune parameter group to associate with this instance.

    neptuneSubnetGroupName String

    A subnet group to associate with this neptune instance. NOTE: This must match the neptune_subnet_group_name of the attached aws.neptune.Cluster.

    port Number

    The port on which the DB accepts connections. Defaults to 8182.

    preferredBackupWindow String

    The daily time range during which automated backups are created if automated backups are enabled. Eg: "04:00-09:00"

    preferredMaintenanceWindow String

    The window to perform maintenance in. Syntax: "ddd:hh24:mi-ddd:hh24:mi". Eg: "Mon:00:00-Mon:03:00".

    promotionTier Number

    Default 0. Failover Priority setting on instance level. The reader who has lower tier has higher priority to get promoter to writer.

    publiclyAccessible Boolean

    Bool to control if instance is publicly accessible. Default is false.

    storageEncrypted Boolean

    Specifies whether the neptune cluster is encrypted.

    tags Map<String>

    A map of tags to assign to the instance. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    tagsAll Map<String>

    A map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated:

    Please use tags instead.

    writer Boolean

    Boolean indicating if this instance is writable. False indicates this instance is a read replica.

    Import

    Using pulumi import, import aws_neptune_cluster_instance using the instance identifier. For example:

     $ pulumi import aws:neptune/clusterInstance:ClusterInstance example my-instance
    

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the aws Terraform Provider.

    aws logo

    Try AWS Native preview for resources not in the classic version.

    AWS Classic v6.13.2 published on Thursday, Dec 7, 2023 by Pulumi