volcengine.redis.Instance
Explore with Pulumi AI
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as volcengine from "@pulumi/volcengine";
import * as volcengine from "@volcengine/pulumi";
const fooZones = volcengine.ecs.Zones({});
const fooVpc = new volcengine.vpc.Vpc("fooVpc", {
    vpcName: "acc-test-vpc",
    cidrBlock: "172.16.0.0/16",
});
const fooSubnet = new volcengine.vpc.Subnet("fooSubnet", {
    subnetName: "acc-test-subnet",
    cidrBlock: "172.16.0.0/24",
    zoneId: fooZones.then(fooZones => fooZones.zones?.[0]?.id),
    vpcId: fooVpc.id,
});
const fooInstance = new volcengine.redis.Instance("fooInstance", {
    instanceName: "tf-test2",
    shardedCluster: 1,
    password: "1qaz!QAZ12",
    nodeNumber: 4,
    shardCapacity: 1024,
    shardNumber: 2,
    engineVersion: "5.0",
    subnetId: fooSubnet.id,
    deletionProtection: "disabled",
    vpcAuthMode: "close",
    chargeType: "PostPaid",
    port: 6381,
    projectName: "default",
    tags: [
        {
            key: "k1",
            value: "v1",
        },
        {
            key: "k3",
            value: "v3",
        },
    ],
    paramValues: [
        {
            name: "active-defrag-cycle-min",
            value: "5",
        },
        {
            name: "active-defrag-cycle-max",
            value: "28",
        },
    ],
    backupPeriods: [
        1,
        2,
        3,
    ],
    backupHour: 6,
    backupActive: true,
    createBackup: false,
    applyImmediately: true,
    multiAz: "enabled",
    configureNodes: [
        {
            az: "cn-guilin-a",
        },
        {
            az: "cn-guilin-b",
        },
        {
            az: "cn-guilin-c",
        },
        {
            az: "cn-guilin-b",
        },
    ],
});
//additional_bandwidth = 12
import pulumi
import pulumi_volcengine as volcengine
foo_zones = volcengine.ecs.zones()
foo_vpc = volcengine.vpc.Vpc("fooVpc",
    vpc_name="acc-test-vpc",
    cidr_block="172.16.0.0/16")
foo_subnet = volcengine.vpc.Subnet("fooSubnet",
    subnet_name="acc-test-subnet",
    cidr_block="172.16.0.0/24",
    zone_id=foo_zones.zones[0].id,
    vpc_id=foo_vpc.id)
foo_instance = volcengine.redis.Instance("fooInstance",
    instance_name="tf-test2",
    sharded_cluster=1,
    password="1qaz!QAZ12",
    node_number=4,
    shard_capacity=1024,
    shard_number=2,
    engine_version="5.0",
    subnet_id=foo_subnet.id,
    deletion_protection="disabled",
    vpc_auth_mode="close",
    charge_type="PostPaid",
    port=6381,
    project_name="default",
    tags=[
        volcengine.redis.InstanceTagArgs(
            key="k1",
            value="v1",
        ),
        volcengine.redis.InstanceTagArgs(
            key="k3",
            value="v3",
        ),
    ],
    param_values=[
        volcengine.redis.InstanceParamValueArgs(
            name="active-defrag-cycle-min",
            value="5",
        ),
        volcengine.redis.InstanceParamValueArgs(
            name="active-defrag-cycle-max",
            value="28",
        ),
    ],
    backup_periods=[
        1,
        2,
        3,
    ],
    backup_hour=6,
    backup_active=True,
    create_backup=False,
    apply_immediately=True,
    multi_az="enabled",
    configure_nodes=[
        volcengine.redis.InstanceConfigureNodeArgs(
            az="cn-guilin-a",
        ),
        volcengine.redis.InstanceConfigureNodeArgs(
            az="cn-guilin-b",
        ),
        volcengine.redis.InstanceConfigureNodeArgs(
            az="cn-guilin-c",
        ),
        volcengine.redis.InstanceConfigureNodeArgs(
            az="cn-guilin-b",
        ),
    ])
#additional_bandwidth = 12
package main
import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/ecs"
	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/redis"
	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/vpc"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		fooZones, err := ecs.Zones(ctx, nil, nil)
		if err != nil {
			return err
		}
		fooVpc, err := vpc.NewVpc(ctx, "fooVpc", &vpc.VpcArgs{
			VpcName:   pulumi.String("acc-test-vpc"),
			CidrBlock: pulumi.String("172.16.0.0/16"),
		})
		if err != nil {
			return err
		}
		fooSubnet, err := vpc.NewSubnet(ctx, "fooSubnet", &vpc.SubnetArgs{
			SubnetName: pulumi.String("acc-test-subnet"),
			CidrBlock:  pulumi.String("172.16.0.0/24"),
			ZoneId:     pulumi.String(fooZones.Zones[0].Id),
			VpcId:      fooVpc.ID(),
		})
		if err != nil {
			return err
		}
		_, err = redis.NewInstance(ctx, "fooInstance", &redis.InstanceArgs{
			InstanceName:       pulumi.String("tf-test2"),
			ShardedCluster:     pulumi.Int(1),
			Password:           pulumi.String("1qaz!QAZ12"),
			NodeNumber:         pulumi.Int(4),
			ShardCapacity:      pulumi.Int(1024),
			ShardNumber:        pulumi.Int(2),
			EngineVersion:      pulumi.String("5.0"),
			SubnetId:           fooSubnet.ID(),
			DeletionProtection: pulumi.String("disabled"),
			VpcAuthMode:        pulumi.String("close"),
			ChargeType:         pulumi.String("PostPaid"),
			Port:               pulumi.Int(6381),
			ProjectName:        pulumi.String("default"),
			Tags: redis.InstanceTagArray{
				&redis.InstanceTagArgs{
					Key:   pulumi.String("k1"),
					Value: pulumi.String("v1"),
				},
				&redis.InstanceTagArgs{
					Key:   pulumi.String("k3"),
					Value: pulumi.String("v3"),
				},
			},
			ParamValues: redis.InstanceParamValueArray{
				&redis.InstanceParamValueArgs{
					Name:  pulumi.String("active-defrag-cycle-min"),
					Value: pulumi.String("5"),
				},
				&redis.InstanceParamValueArgs{
					Name:  pulumi.String("active-defrag-cycle-max"),
					Value: pulumi.String("28"),
				},
			},
			BackupPeriods: pulumi.IntArray{
				pulumi.Int(1),
				pulumi.Int(2),
				pulumi.Int(3),
			},
			BackupHour:       pulumi.Int(6),
			BackupActive:     pulumi.Bool(true),
			CreateBackup:     pulumi.Bool(false),
			ApplyImmediately: pulumi.Bool(true),
			MultiAz:          pulumi.String("enabled"),
			ConfigureNodes: redis.InstanceConfigureNodeArray{
				&redis.InstanceConfigureNodeArgs{
					Az: pulumi.String("cn-guilin-a"),
				},
				&redis.InstanceConfigureNodeArgs{
					Az: pulumi.String("cn-guilin-b"),
				},
				&redis.InstanceConfigureNodeArgs{
					Az: pulumi.String("cn-guilin-c"),
				},
				&redis.InstanceConfigureNodeArgs{
					Az: pulumi.String("cn-guilin-b"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Volcengine = Pulumi.Volcengine;
return await Deployment.RunAsync(() => 
{
    var fooZones = Volcengine.Ecs.Zones.Invoke();
    var fooVpc = new Volcengine.Vpc.Vpc("fooVpc", new()
    {
        VpcName = "acc-test-vpc",
        CidrBlock = "172.16.0.0/16",
    });
    var fooSubnet = new Volcengine.Vpc.Subnet("fooSubnet", new()
    {
        SubnetName = "acc-test-subnet",
        CidrBlock = "172.16.0.0/24",
        ZoneId = fooZones.Apply(zonesResult => zonesResult.Zones[0]?.Id),
        VpcId = fooVpc.Id,
    });
    var fooInstance = new Volcengine.Redis.Instance("fooInstance", new()
    {
        InstanceName = "tf-test2",
        ShardedCluster = 1,
        Password = "1qaz!QAZ12",
        NodeNumber = 4,
        ShardCapacity = 1024,
        ShardNumber = 2,
        EngineVersion = "5.0",
        SubnetId = fooSubnet.Id,
        DeletionProtection = "disabled",
        VpcAuthMode = "close",
        ChargeType = "PostPaid",
        Port = 6381,
        ProjectName = "default",
        Tags = new[]
        {
            new Volcengine.Redis.Inputs.InstanceTagArgs
            {
                Key = "k1",
                Value = "v1",
            },
            new Volcengine.Redis.Inputs.InstanceTagArgs
            {
                Key = "k3",
                Value = "v3",
            },
        },
        ParamValues = new[]
        {
            new Volcengine.Redis.Inputs.InstanceParamValueArgs
            {
                Name = "active-defrag-cycle-min",
                Value = "5",
            },
            new Volcengine.Redis.Inputs.InstanceParamValueArgs
            {
                Name = "active-defrag-cycle-max",
                Value = "28",
            },
        },
        BackupPeriods = new[]
        {
            1,
            2,
            3,
        },
        BackupHour = 6,
        BackupActive = true,
        CreateBackup = false,
        ApplyImmediately = true,
        MultiAz = "enabled",
        ConfigureNodes = new[]
        {
            new Volcengine.Redis.Inputs.InstanceConfigureNodeArgs
            {
                Az = "cn-guilin-a",
            },
            new Volcengine.Redis.Inputs.InstanceConfigureNodeArgs
            {
                Az = "cn-guilin-b",
            },
            new Volcengine.Redis.Inputs.InstanceConfigureNodeArgs
            {
                Az = "cn-guilin-c",
            },
            new Volcengine.Redis.Inputs.InstanceConfigureNodeArgs
            {
                Az = "cn-guilin-b",
            },
        },
    });
    //additional_bandwidth = 12
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.volcengine.ecs.EcsFunctions;
import com.pulumi.volcengine.ecs.inputs.ZonesArgs;
import com.pulumi.volcengine.vpc.Vpc;
import com.pulumi.volcengine.vpc.VpcArgs;
import com.pulumi.volcengine.vpc.Subnet;
import com.pulumi.volcengine.vpc.SubnetArgs;
import com.pulumi.volcengine.redis.Instance;
import com.pulumi.volcengine.redis.InstanceArgs;
import com.pulumi.volcengine.redis.inputs.InstanceTagArgs;
import com.pulumi.volcengine.redis.inputs.InstanceParamValueArgs;
import com.pulumi.volcengine.redis.inputs.InstanceConfigureNodeArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var fooZones = EcsFunctions.Zones();
        var fooVpc = new Vpc("fooVpc", VpcArgs.builder()        
            .vpcName("acc-test-vpc")
            .cidrBlock("172.16.0.0/16")
            .build());
        var fooSubnet = new Subnet("fooSubnet", SubnetArgs.builder()        
            .subnetName("acc-test-subnet")
            .cidrBlock("172.16.0.0/24")
            .zoneId(fooZones.applyValue(zonesResult -> zonesResult.zones()[0].id()))
            .vpcId(fooVpc.id())
            .build());
        var fooInstance = new Instance("fooInstance", InstanceArgs.builder()        
            .instanceName("tf-test2")
            .shardedCluster(1)
            .password("1qaz!QAZ12")
            .nodeNumber(4)
            .shardCapacity(1024)
            .shardNumber(2)
            .engineVersion("5.0")
            .subnetId(fooSubnet.id())
            .deletionProtection("disabled")
            .vpcAuthMode("close")
            .chargeType("PostPaid")
            .port(6381)
            .projectName("default")
            .tags(            
                InstanceTagArgs.builder()
                    .key("k1")
                    .value("v1")
                    .build(),
                InstanceTagArgs.builder()
                    .key("k3")
                    .value("v3")
                    .build())
            .paramValues(            
                InstanceParamValueArgs.builder()
                    .name("active-defrag-cycle-min")
                    .value("5")
                    .build(),
                InstanceParamValueArgs.builder()
                    .name("active-defrag-cycle-max")
                    .value("28")
                    .build())
            .backupPeriods(            
                1,
                2,
                3)
            .backupHour(6)
            .backupActive(true)
            .createBackup(false)
            .applyImmediately(true)
            .multiAz("enabled")
            .configureNodes(            
                InstanceConfigureNodeArgs.builder()
                    .az("cn-guilin-a")
                    .build(),
                InstanceConfigureNodeArgs.builder()
                    .az("cn-guilin-b")
                    .build(),
                InstanceConfigureNodeArgs.builder()
                    .az("cn-guilin-c")
                    .build(),
                InstanceConfigureNodeArgs.builder()
                    .az("cn-guilin-b")
                    .build())
            .build());
        //additional_bandwidth = 12
    }
}
resources:
  fooVpc:
    type: volcengine:vpc:Vpc
    properties:
      vpcName: acc-test-vpc
      cidrBlock: 172.16.0.0/16
  fooSubnet:
    type: volcengine:vpc:Subnet
    properties:
      subnetName: acc-test-subnet
      cidrBlock: 172.16.0.0/24
      zoneId: ${fooZones.zones[0].id}
      vpcId: ${fooVpc.id}
  fooInstance:
    type: volcengine:redis:Instance
    properties:
      instanceName: tf-test2
      shardedCluster: 1
      password: 1qaz!QAZ12
      nodeNumber: 4
      shardCapacity: 1024
      shardNumber: 2
      engineVersion: '5.0'
      subnetId: ${fooSubnet.id}
      deletionProtection: disabled
      vpcAuthMode: close
      chargeType: PostPaid
      port: 6381
      projectName: default
      tags:
        - key: k1
          value: v1
        - key: k3
          value: v3
      paramValues:
        - name: active-defrag-cycle-min
          value: '5'
        - name: active-defrag-cycle-max
          value: '28'
      backupPeriods:
        - 1
        - 2
        - 3
      backupHour: 6
      backupActive: true
      createBackup: false
      applyImmediately: true
      multiAz: enabled
      configureNodes:
        - az: cn-guilin-a
        - az: cn-guilin-b
        - az: cn-guilin-c
        - az: cn-guilin-b
variables:
  fooZones:
    fn::invoke:
      Function: volcengine:ecs:Zones
      Arguments: {}
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,
             engine_version: Optional[str] = None,
             subnet_id: Optional[str] = None,
             sharded_cluster: Optional[int] = None,
             shard_capacity: Optional[int] = None,
             node_number: Optional[int] = None,
             multi_az: Optional[str] = None,
             port: Optional[int] = None,
             configure_nodes: Optional[Sequence[InstanceConfigureNodeArgs]] = None,
             create_backup: Optional[bool] = None,
             deletion_protection: Optional[str] = None,
             backup_periods: Optional[Sequence[int]] = None,
             instance_name: Optional[str] = None,
             additional_bandwidth: Optional[int] = None,
             backup_hour: Optional[int] = None,
             param_values: Optional[Sequence[InstanceParamValueArgs]] = None,
             password: Optional[str] = None,
             charge_type: Optional[str] = None,
             project_name: Optional[str] = None,
             purchase_months: Optional[int] = None,
             backup_active: Optional[bool] = None,
             shard_number: Optional[int] = None,
             auto_renew: Optional[bool] = None,
             apply_immediately: Optional[bool] = None,
             tags: Optional[Sequence[InstanceTagArgs]] = None,
             vpc_auth_mode: Optional[str] = None,
             zone_ids: Optional[Sequence[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: volcengine:redis: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 exampleinstanceResourceResourceFromRedisinstance = new Volcengine.Redis.Instance("exampleinstanceResourceResourceFromRedisinstance", new()
{
    EngineVersion = "string",
    SubnetId = "string",
    ShardedCluster = 0,
    ShardCapacity = 0,
    NodeNumber = 0,
    MultiAz = "string",
    Port = 0,
    ConfigureNodes = new[]
    {
        new Volcengine.Redis.Inputs.InstanceConfigureNodeArgs
        {
            Az = "string",
        },
    },
    CreateBackup = false,
    DeletionProtection = "string",
    BackupPeriods = new[]
    {
        0,
    },
    InstanceName = "string",
    AdditionalBandwidth = 0,
    BackupHour = 0,
    ParamValues = new[]
    {
        new Volcengine.Redis.Inputs.InstanceParamValueArgs
        {
            Name = "string",
            Value = "string",
        },
    },
    Password = "string",
    ChargeType = "string",
    ProjectName = "string",
    PurchaseMonths = 0,
    BackupActive = false,
    ShardNumber = 0,
    AutoRenew = false,
    ApplyImmediately = false,
    Tags = new[]
    {
        new Volcengine.Redis.Inputs.InstanceTagArgs
        {
            Key = "string",
            Value = "string",
        },
    },
    VpcAuthMode = "string",
});
example, err := redis.NewInstance(ctx, "exampleinstanceResourceResourceFromRedisinstance", &redis.InstanceArgs{
	EngineVersion:  pulumi.String("string"),
	SubnetId:       pulumi.String("string"),
	ShardedCluster: pulumi.Int(0),
	ShardCapacity:  pulumi.Int(0),
	NodeNumber:     pulumi.Int(0),
	MultiAz:        pulumi.String("string"),
	Port:           pulumi.Int(0),
	ConfigureNodes: redis.InstanceConfigureNodeArray{
		&redis.InstanceConfigureNodeArgs{
			Az: pulumi.String("string"),
		},
	},
	CreateBackup:       pulumi.Bool(false),
	DeletionProtection: pulumi.String("string"),
	BackupPeriods: pulumi.IntArray{
		pulumi.Int(0),
	},
	InstanceName:        pulumi.String("string"),
	AdditionalBandwidth: pulumi.Int(0),
	BackupHour:          pulumi.Int(0),
	ParamValues: redis.InstanceParamValueArray{
		&redis.InstanceParamValueArgs{
			Name:  pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
	Password:         pulumi.String("string"),
	ChargeType:       pulumi.String("string"),
	ProjectName:      pulumi.String("string"),
	PurchaseMonths:   pulumi.Int(0),
	BackupActive:     pulumi.Bool(false),
	ShardNumber:      pulumi.Int(0),
	AutoRenew:        pulumi.Bool(false),
	ApplyImmediately: pulumi.Bool(false),
	Tags: redis.InstanceTagArray{
		&redis.InstanceTagArgs{
			Key:   pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
	VpcAuthMode: pulumi.String("string"),
})
var exampleinstanceResourceResourceFromRedisinstance = new Instance("exampleinstanceResourceResourceFromRedisinstance", InstanceArgs.builder()
    .engineVersion("string")
    .subnetId("string")
    .shardedCluster(0)
    .shardCapacity(0)
    .nodeNumber(0)
    .multiAz("string")
    .port(0)
    .configureNodes(InstanceConfigureNodeArgs.builder()
        .az("string")
        .build())
    .createBackup(false)
    .deletionProtection("string")
    .backupPeriods(0)
    .instanceName("string")
    .additionalBandwidth(0)
    .backupHour(0)
    .paramValues(InstanceParamValueArgs.builder()
        .name("string")
        .value("string")
        .build())
    .password("string")
    .chargeType("string")
    .projectName("string")
    .purchaseMonths(0)
    .backupActive(false)
    .shardNumber(0)
    .autoRenew(false)
    .applyImmediately(false)
    .tags(InstanceTagArgs.builder()
        .key("string")
        .value("string")
        .build())
    .vpcAuthMode("string")
    .build());
exampleinstance_resource_resource_from_redisinstance = volcengine.redis.Instance("exampleinstanceResourceResourceFromRedisinstance",
    engine_version="string",
    subnet_id="string",
    sharded_cluster=0,
    shard_capacity=0,
    node_number=0,
    multi_az="string",
    port=0,
    configure_nodes=[{
        "az": "string",
    }],
    create_backup=False,
    deletion_protection="string",
    backup_periods=[0],
    instance_name="string",
    additional_bandwidth=0,
    backup_hour=0,
    param_values=[{
        "name": "string",
        "value": "string",
    }],
    password="string",
    charge_type="string",
    project_name="string",
    purchase_months=0,
    backup_active=False,
    shard_number=0,
    auto_renew=False,
    apply_immediately=False,
    tags=[{
        "key": "string",
        "value": "string",
    }],
    vpc_auth_mode="string")
const exampleinstanceResourceResourceFromRedisinstance = new volcengine.redis.Instance("exampleinstanceResourceResourceFromRedisinstance", {
    engineVersion: "string",
    subnetId: "string",
    shardedCluster: 0,
    shardCapacity: 0,
    nodeNumber: 0,
    multiAz: "string",
    port: 0,
    configureNodes: [{
        az: "string",
    }],
    createBackup: false,
    deletionProtection: "string",
    backupPeriods: [0],
    instanceName: "string",
    additionalBandwidth: 0,
    backupHour: 0,
    paramValues: [{
        name: "string",
        value: "string",
    }],
    password: "string",
    chargeType: "string",
    projectName: "string",
    purchaseMonths: 0,
    backupActive: false,
    shardNumber: 0,
    autoRenew: false,
    applyImmediately: false,
    tags: [{
        key: "string",
        value: "string",
    }],
    vpcAuthMode: "string",
});
type: volcengine:redis:Instance
properties:
    additionalBandwidth: 0
    applyImmediately: false
    autoRenew: false
    backupActive: false
    backupHour: 0
    backupPeriods:
        - 0
    chargeType: string
    configureNodes:
        - az: string
    createBackup: false
    deletionProtection: string
    engineVersion: string
    instanceName: string
    multiAz: string
    nodeNumber: 0
    paramValues:
        - name: string
          value: string
    password: string
    port: 0
    projectName: string
    purchaseMonths: 0
    shardCapacity: 0
    shardNumber: 0
    shardedCluster: 0
    subnetId: string
    tags:
        - key: string
          value: string
    vpcAuthMode: 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:
- EngineVersion string
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- NodeNumber int
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- int
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- int
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- SubnetId string
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- AdditionalBandwidth int
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- ApplyImmediately bool
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- AutoRenew bool
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- BackupActive bool
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- BackupHour int
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- BackupPeriods List<int>
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- ChargeType string
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- ConfigureNodes List<InstanceConfigure Node> 
- Set the list of available zones to which the node belongs.
- CreateBackup bool
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- DeletionProtection string
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- InstanceName string
- The name of the redis instance.
- MultiAz string
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- ParamValues List<InstanceParam Value> 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- Password string
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- Port int
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- ProjectName string
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- PurchaseMonths int
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- int
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- 
List<InstanceTag> 
- Tags.
- VpcAuth stringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- ZoneIds List<string>
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- EngineVersion string
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- NodeNumber int
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- int
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- int
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- SubnetId string
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- AdditionalBandwidth int
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- ApplyImmediately bool
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- AutoRenew bool
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- BackupActive bool
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- BackupHour int
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- BackupPeriods []int
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- ChargeType string
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- ConfigureNodes []InstanceConfigure Node Args 
- Set the list of available zones to which the node belongs.
- CreateBackup bool
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- DeletionProtection string
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- InstanceName string
- The name of the redis instance.
- MultiAz string
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- ParamValues []InstanceParam Value Args 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- Password string
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- Port int
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- ProjectName string
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- PurchaseMonths int
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- int
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- 
[]InstanceTag Args 
- Tags.
- VpcAuth stringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- ZoneIds []string
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- engineVersion String
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- nodeNumber Integer
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- Integer
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- Integer
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- subnetId String
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- additionalBandwidth Integer
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- applyImmediately Boolean
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- autoRenew Boolean
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- backupActive Boolean
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupHour Integer
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupPeriods List<Integer>
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- chargeType String
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- configureNodes List<InstanceConfigure Node> 
- Set the list of available zones to which the node belongs.
- createBackup Boolean
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- deletionProtection String
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- instanceName String
- The name of the redis instance.
- multiAz String
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- paramValues List<InstanceParam Value> 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- password String
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- port Integer
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- projectName String
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- purchaseMonths Integer
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- Integer
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- 
List<InstanceTag> 
- Tags.
- vpcAuth StringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- zoneIds List<String>
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- engineVersion string
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- nodeNumber number
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- number
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- number
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- subnetId string
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- additionalBandwidth number
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- applyImmediately boolean
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- autoRenew boolean
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- backupActive boolean
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupHour number
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupPeriods number[]
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- chargeType string
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- configureNodes InstanceConfigure Node[] 
- Set the list of available zones to which the node belongs.
- createBackup boolean
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- deletionProtection string
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- instanceName string
- The name of the redis instance.
- multiAz string
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- paramValues InstanceParam Value[] 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- password string
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- port number
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- projectName string
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- purchaseMonths number
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- number
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- 
InstanceTag[] 
- Tags.
- vpcAuth stringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- zoneIds string[]
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- engine_version str
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- node_number int
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- int
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- int
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- subnet_id str
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- additional_bandwidth int
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- apply_immediately bool
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- auto_renew bool
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- backup_active bool
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- backup_hour int
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- backup_periods Sequence[int]
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- charge_type str
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- configure_nodes Sequence[InstanceConfigure Node Args] 
- Set the list of available zones to which the node belongs.
- create_backup bool
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- deletion_protection str
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- instance_name str
- The name of the redis instance.
- multi_az str
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- param_values Sequence[InstanceParam Value Args] 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- password str
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- port int
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- project_name str
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- purchase_months int
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- int
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- 
Sequence[InstanceTag Args] 
- Tags.
- vpc_auth_ strmode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- zone_ids Sequence[str]
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- engineVersion String
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- nodeNumber Number
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- Number
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- Number
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- subnetId String
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- additionalBandwidth Number
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- applyImmediately Boolean
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- autoRenew Boolean
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- backupActive Boolean
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupHour Number
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupPeriods List<Number>
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- chargeType String
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- configureNodes List<Property Map>
- Set the list of available zones to which the node belongs.
- createBackup Boolean
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- deletionProtection String
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- instanceName String
- The name of the redis instance.
- multiAz String
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- paramValues List<Property Map>
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- password String
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- port Number
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- projectName String
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- purchaseMonths Number
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- Number
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- List<Property Map>
- Tags.
- vpcAuth StringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- zoneIds List<String>
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
Outputs
All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
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,
        additional_bandwidth: Optional[int] = None,
        apply_immediately: Optional[bool] = None,
        auto_renew: Optional[bool] = None,
        backup_active: Optional[bool] = None,
        backup_hour: Optional[int] = None,
        backup_periods: Optional[Sequence[int]] = None,
        charge_type: Optional[str] = None,
        configure_nodes: Optional[Sequence[InstanceConfigureNodeArgs]] = None,
        create_backup: Optional[bool] = None,
        deletion_protection: Optional[str] = None,
        engine_version: Optional[str] = None,
        instance_name: Optional[str] = None,
        multi_az: Optional[str] = None,
        node_number: Optional[int] = None,
        param_values: Optional[Sequence[InstanceParamValueArgs]] = None,
        password: Optional[str] = None,
        port: Optional[int] = None,
        project_name: Optional[str] = None,
        purchase_months: Optional[int] = None,
        shard_capacity: Optional[int] = None,
        shard_number: Optional[int] = None,
        sharded_cluster: Optional[int] = None,
        subnet_id: Optional[str] = None,
        tags: Optional[Sequence[InstanceTagArgs]] = None,
        vpc_auth_mode: Optional[str] = None,
        zone_ids: Optional[Sequence[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: volcengine:redis: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.
- AdditionalBandwidth int
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- ApplyImmediately bool
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- AutoRenew bool
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- BackupActive bool
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- BackupHour int
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- BackupPeriods List<int>
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- ChargeType string
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- ConfigureNodes List<InstanceConfigure Node> 
- Set the list of available zones to which the node belongs.
- CreateBackup bool
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- DeletionProtection string
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- EngineVersion string
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- InstanceName string
- The name of the redis instance.
- MultiAz string
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- NodeNumber int
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- ParamValues List<InstanceParam Value> 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- Password string
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- Port int
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- ProjectName string
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- PurchaseMonths int
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- ShardCapacity int
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- ShardNumber int
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- ShardedCluster int
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- SubnetId string
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- 
List<InstanceTag> 
- Tags.
- VpcAuth stringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- ZoneIds List<string>
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- AdditionalBandwidth int
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- ApplyImmediately bool
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- AutoRenew bool
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- BackupActive bool
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- BackupHour int
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- BackupPeriods []int
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- ChargeType string
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- ConfigureNodes []InstanceConfigure Node Args 
- Set the list of available zones to which the node belongs.
- CreateBackup bool
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- DeletionProtection string
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- EngineVersion string
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- InstanceName string
- The name of the redis instance.
- MultiAz string
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- NodeNumber int
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- ParamValues []InstanceParam Value Args 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- Password string
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- Port int
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- ProjectName string
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- PurchaseMonths int
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- ShardCapacity int
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- ShardNumber int
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- ShardedCluster int
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- SubnetId string
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- 
[]InstanceTag Args 
- Tags.
- VpcAuth stringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- ZoneIds []string
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- additionalBandwidth Integer
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- applyImmediately Boolean
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- autoRenew Boolean
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- backupActive Boolean
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupHour Integer
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupPeriods List<Integer>
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- chargeType String
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- configureNodes List<InstanceConfigure Node> 
- Set the list of available zones to which the node belongs.
- createBackup Boolean
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- deletionProtection String
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- engineVersion String
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- instanceName String
- The name of the redis instance.
- multiAz String
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- nodeNumber Integer
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- paramValues List<InstanceParam Value> 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- password String
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- port Integer
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- projectName String
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- purchaseMonths Integer
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- shardCapacity Integer
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- shardNumber Integer
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- shardedCluster Integer
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- subnetId String
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- 
List<InstanceTag> 
- Tags.
- vpcAuth StringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- zoneIds List<String>
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- additionalBandwidth number
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- applyImmediately boolean
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- autoRenew boolean
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- backupActive boolean
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupHour number
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupPeriods number[]
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- chargeType string
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- configureNodes InstanceConfigure Node[] 
- Set the list of available zones to which the node belongs.
- createBackup boolean
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- deletionProtection string
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- engineVersion string
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- instanceName string
- The name of the redis instance.
- multiAz string
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- nodeNumber number
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- paramValues InstanceParam Value[] 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- password string
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- port number
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- projectName string
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- purchaseMonths number
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- shardCapacity number
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- shardNumber number
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- shardedCluster number
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- subnetId string
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- 
InstanceTag[] 
- Tags.
- vpcAuth stringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- zoneIds string[]
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- additional_bandwidth int
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- apply_immediately bool
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- auto_renew bool
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- backup_active bool
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- backup_hour int
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- backup_periods Sequence[int]
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- charge_type str
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- configure_nodes Sequence[InstanceConfigure Node Args] 
- Set the list of available zones to which the node belongs.
- create_backup bool
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- deletion_protection str
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- engine_version str
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- instance_name str
- The name of the redis instance.
- multi_az str
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- node_number int
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- param_values Sequence[InstanceParam Value Args] 
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- password str
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- port int
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- project_name str
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- purchase_months int
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- shard_capacity int
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- shard_number int
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- sharded_cluster int
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- subnet_id str
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- 
Sequence[InstanceTag Args] 
- Tags.
- vpc_auth_ strmode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- zone_ids Sequence[str]
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
- additionalBandwidth Number
- Modify the single-shard additional bandwidth of the target Redis instance. Set the additional bandwidth of a single shard, that is, the bandwidth that needs to be additionally increased on the basis of the default bandwidth. Unit: MB/s. The value of additional bandwidth needs to meet the following conditions at the same time: It must be greater than or equal to 0. When the value is 0, it means that no additional bandwidth is added, and the bandwidth of a single shard is the default bandwidth. The sum of additional bandwidth and default bandwidth cannot exceed the upper limit of bandwidth that can be modified for the current instance. Different specification nodes have different upper limits of bandwidth that can be modified. For more details, please refer to bandwidth modification range. The upper limits of the total write bandwidth and the total read bandwidth of an instance are both 2048MB/s.
- applyImmediately Boolean
- Whether to apply the instance configuration change operation immediately. The value of this field is false, means that the change operation will be applied within maintenance time.
- autoRenew Boolean
- Whether to enable automatic renewal. This field is valid only when ChargeTypeisPrePaid, the default value is false. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- backupActive Boolean
- Whether enable auto backup for redis instance. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupHour Number
- The time period to start performing the backup. The valid value range is any integer between 0 and 23, where 0 means that the system will perform the backup in the period of 00:00~01:00, 1 means that the backup will be performed in the period of 01:00~02:00, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- backupPeriods List<Number>
- The backup period. The valid value can be any integer between 1 and 7. Among them, 1 means backup every Monday, 2 means backup every Tuesday, and so on. This field is valid and required when updating the backup plan of primary and secondary instance.
- chargeType String
- The charge type of redis instance. Valid value: PostPaid,PrePaid.
- configureNodes List<Property Map>
- Set the list of available zones to which the node belongs.
- createBackup Boolean
- Whether to create a final backup when modify the instance configuration or destroy the redis instance.
- deletionProtection String
- Whether enable deletion protection for redis instance. Valid values: enabled,disabled(default).
- engineVersion String
- The engine version of redis instance. Valid value: 5.0,6.0,7.0.
- instanceName String
- The name of the redis instance.
- multiAz String
- Set the availability zone deployment scheme for the instance. The value range is as follows: disabled: Single availability zone deployment scheme. enabled: Multi-availability zone deployment scheme. Description: When the newly created instance is a single-node instance (that is, when the value of NodeNumber is 1), only the single availability zone deployment scheme is allowed. At this time, the value of MultiAZ must be disabled.
- nodeNumber Number
- The number of nodes in each shard, the valid value range is 1-6. When the value is 1, it means creating a single node instance, and this field can not be modified. When the value is greater than 1, it means creating a primary and secondary instance, and this field can be modified.
- paramValues List<Property Map>
- The configuration item information to be modified. This field can only be added or modified. Deleting this field is invalid.
When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields, or use the command pulumi upto perform a modification operation.
- password String
- The account password. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields. If this parameter is left blank, it means that no password is set for the default account. At this time, the system will automatically generate a password for the default account to ensure instance access security. No account can obtain this random password. Therefore, before connecting to the instance, you need to reset the password of the default account through the ModifyDBAccount interface.You can also set a new account and password through the CreateDBAccount interface according to business needs. If you need to use password-free access function, you need to enable password-free access first through the ModifyDBInstanceVpcAuthMode interface.
- port Number
- The port of custom define private network address. The valid value range is 1024-65535. The default value is6379.
- projectName String
- The project name to which the redis instance belongs, if this parameter is empty, the new redis instance will be added to the defaultproject.
- purchaseMonths Number
- The purchase months of redis instance, the unit is month. the valid value range is as fallows: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36. This field is valid and required whenChargeTypeisPrepaid. When importing resources, this attribute will not be imported. If this attribute is set, please use lifecycle and ignore_changes ignore changes in fields.
- shardCapacity Number
- The memory capacity of each shard, unit is MiB. The valid value range is as fallows: When the value of ShardedClusteris 0: 256, 1024, 2048, 4096, 8192, 16384, 32768, 65536. When the value ofShardedClusteris 1: 1024, 2048, 4096, 8192, 16384. When the value ofnode_numberis 1, the value of this field can not be 256.
- shardNumber Number
- The number of shards in redis instance, the valid value range is 2-256. This field is valid and required when the value ofShardedClusteris 1.
- shardedCluster Number
- Whether enable sharded cluster for the current redis instance. Valid values: 0, 1. 0 means disable, 1 means enable.
- subnetId String
- The subnet id of the redis instance. The specified subnet id must belong to the zone ids.
- List<Property Map>
- Tags.
- vpcAuth StringMode 
- Whether to enable password-free access when connecting to an instance through a private network. Valid values: open,close.
- zoneIds List<String>
- This field has been deprecated after version-0.0.152. Please use multi_az and configure_nodes to specify the availability zone. The list of zone IDs of instance. When creating a single node instance, only one zone id can be specified.
Supporting Types
InstanceConfigureNode, InstanceConfigureNodeArgs      
- Az string
- Set the availability zone to which the node belongs. The number of nodes of an instance (i.e., NodeNumber) and the availability zone deployment scheme (i.e., the value of the MultiAZ parameter) will affect the filling of the current parameter. Among them: When a new instance is a single-node instance (i.e., the value of NodeNumber is 1), only a single availability zone deployment scheme is allowed (i.e., the value of MultiAZ must be disabled). At this time, only one availability zone needs to be passed in AZ, and all nodes in the instance will be deployed in this availability zone. When creating a new instance as a primary-standby instance (that is, when the value of NodeNumber is greater than or equal to 2), the number of availability zones passed in must be equal to the number of nodes in a single shard (that is, the value of the NodeNumber parameter), and the value of AZ must comply with the multi-availability zone deployment scheme rules. The specific rules are as follows: If the primary-standby instance selects the multi-availability zone deployment scheme (that is, the value of MultiAZ is enabled), then at least two different availability zone IDs must be passed in in AZ, and the first availability zone is the availability zone where the primary node is located. If the primary and standby instances choose a single availability zone deployment scheme (that is, the value of MultiAZ is disabled), then the availability zones passed in for each node must be the same.
- Az string
- Set the availability zone to which the node belongs. The number of nodes of an instance (i.e., NodeNumber) and the availability zone deployment scheme (i.e., the value of the MultiAZ parameter) will affect the filling of the current parameter. Among them: When a new instance is a single-node instance (i.e., the value of NodeNumber is 1), only a single availability zone deployment scheme is allowed (i.e., the value of MultiAZ must be disabled). At this time, only one availability zone needs to be passed in AZ, and all nodes in the instance will be deployed in this availability zone. When creating a new instance as a primary-standby instance (that is, when the value of NodeNumber is greater than or equal to 2), the number of availability zones passed in must be equal to the number of nodes in a single shard (that is, the value of the NodeNumber parameter), and the value of AZ must comply with the multi-availability zone deployment scheme rules. The specific rules are as follows: If the primary-standby instance selects the multi-availability zone deployment scheme (that is, the value of MultiAZ is enabled), then at least two different availability zone IDs must be passed in in AZ, and the first availability zone is the availability zone where the primary node is located. If the primary and standby instances choose a single availability zone deployment scheme (that is, the value of MultiAZ is disabled), then the availability zones passed in for each node must be the same.
- az String
- Set the availability zone to which the node belongs. The number of nodes of an instance (i.e., NodeNumber) and the availability zone deployment scheme (i.e., the value of the MultiAZ parameter) will affect the filling of the current parameter. Among them: When a new instance is a single-node instance (i.e., the value of NodeNumber is 1), only a single availability zone deployment scheme is allowed (i.e., the value of MultiAZ must be disabled). At this time, only one availability zone needs to be passed in AZ, and all nodes in the instance will be deployed in this availability zone. When creating a new instance as a primary-standby instance (that is, when the value of NodeNumber is greater than or equal to 2), the number of availability zones passed in must be equal to the number of nodes in a single shard (that is, the value of the NodeNumber parameter), and the value of AZ must comply with the multi-availability zone deployment scheme rules. The specific rules are as follows: If the primary-standby instance selects the multi-availability zone deployment scheme (that is, the value of MultiAZ is enabled), then at least two different availability zone IDs must be passed in in AZ, and the first availability zone is the availability zone where the primary node is located. If the primary and standby instances choose a single availability zone deployment scheme (that is, the value of MultiAZ is disabled), then the availability zones passed in for each node must be the same.
- az string
- Set the availability zone to which the node belongs. The number of nodes of an instance (i.e., NodeNumber) and the availability zone deployment scheme (i.e., the value of the MultiAZ parameter) will affect the filling of the current parameter. Among them: When a new instance is a single-node instance (i.e., the value of NodeNumber is 1), only a single availability zone deployment scheme is allowed (i.e., the value of MultiAZ must be disabled). At this time, only one availability zone needs to be passed in AZ, and all nodes in the instance will be deployed in this availability zone. When creating a new instance as a primary-standby instance (that is, when the value of NodeNumber is greater than or equal to 2), the number of availability zones passed in must be equal to the number of nodes in a single shard (that is, the value of the NodeNumber parameter), and the value of AZ must comply with the multi-availability zone deployment scheme rules. The specific rules are as follows: If the primary-standby instance selects the multi-availability zone deployment scheme (that is, the value of MultiAZ is enabled), then at least two different availability zone IDs must be passed in in AZ, and the first availability zone is the availability zone where the primary node is located. If the primary and standby instances choose a single availability zone deployment scheme (that is, the value of MultiAZ is disabled), then the availability zones passed in for each node must be the same.
- az str
- Set the availability zone to which the node belongs. The number of nodes of an instance (i.e., NodeNumber) and the availability zone deployment scheme (i.e., the value of the MultiAZ parameter) will affect the filling of the current parameter. Among them: When a new instance is a single-node instance (i.e., the value of NodeNumber is 1), only a single availability zone deployment scheme is allowed (i.e., the value of MultiAZ must be disabled). At this time, only one availability zone needs to be passed in AZ, and all nodes in the instance will be deployed in this availability zone. When creating a new instance as a primary-standby instance (that is, when the value of NodeNumber is greater than or equal to 2), the number of availability zones passed in must be equal to the number of nodes in a single shard (that is, the value of the NodeNumber parameter), and the value of AZ must comply with the multi-availability zone deployment scheme rules. The specific rules are as follows: If the primary-standby instance selects the multi-availability zone deployment scheme (that is, the value of MultiAZ is enabled), then at least two different availability zone IDs must be passed in in AZ, and the first availability zone is the availability zone where the primary node is located. If the primary and standby instances choose a single availability zone deployment scheme (that is, the value of MultiAZ is disabled), then the availability zones passed in for each node must be the same.
- az String
- Set the availability zone to which the node belongs. The number of nodes of an instance (i.e., NodeNumber) and the availability zone deployment scheme (i.e., the value of the MultiAZ parameter) will affect the filling of the current parameter. Among them: When a new instance is a single-node instance (i.e., the value of NodeNumber is 1), only a single availability zone deployment scheme is allowed (i.e., the value of MultiAZ must be disabled). At this time, only one availability zone needs to be passed in AZ, and all nodes in the instance will be deployed in this availability zone. When creating a new instance as a primary-standby instance (that is, when the value of NodeNumber is greater than or equal to 2), the number of availability zones passed in must be equal to the number of nodes in a single shard (that is, the value of the NodeNumber parameter), and the value of AZ must comply with the multi-availability zone deployment scheme rules. The specific rules are as follows: If the primary-standby instance selects the multi-availability zone deployment scheme (that is, the value of MultiAZ is enabled), then at least two different availability zone IDs must be passed in in AZ, and the first availability zone is the availability zone where the primary node is located. If the primary and standby instances choose a single availability zone deployment scheme (that is, the value of MultiAZ is disabled), then the availability zones passed in for each node must be the same.
InstanceParamValue, InstanceParamValueArgs      
InstanceTag, InstanceTagArgs    
Import
redis instance can be imported using the id, e.g.
$ pulumi import volcengine:redis/instance:Instance default redis-n769ewmjjqyqh5dv
Adding or removing nodes and migrating availability zones for multiple AZ instances are not supported to be orchestrated simultaneously, but it is possible for single AZ instances.
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- volcengine volcengine/pulumi-volcengine
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the volcengineTerraform Provider.