alicloud.kvstore.Instance
Explore with Pulumi AI
Import
KVStore instance can be imported using the id, e.g.
$ pulumi import alicloud:kvstore/instance:Instance example r-abc12345678
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: Optional[InstanceArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def Instance(resource_name: str,
opts: Optional[ResourceOptions] = None,
auto_renew: Optional[bool] = None,
auto_renew_period: Optional[int] = None,
auto_use_coupon: Optional[bool] = None,
availability_zone: Optional[str] = None,
backup_id: Optional[str] = None,
backup_periods: Optional[Sequence[str]] = None,
backup_time: Optional[str] = None,
business_info: Optional[str] = None,
capacity: Optional[int] = None,
config: Optional[Mapping[str, str]] = None,
connection_string_prefix: Optional[str] = None,
coupon_no: Optional[str] = None,
db_instance_name: Optional[str] = None,
dedicated_host_group_id: Optional[str] = None,
dry_run: Optional[bool] = None,
effective_time: Optional[str] = None,
enable_backup_log: Optional[int] = None,
enable_public: Optional[bool] = None,
encryption_key: Optional[str] = None,
encryption_name: Optional[str] = None,
engine_version: Optional[str] = None,
force_upgrade: Optional[bool] = None,
global_instance: Optional[bool] = None,
global_instance_id: Optional[str] = None,
instance_charge_type: Optional[str] = None,
instance_class: Optional[str] = None,
instance_name: Optional[str] = None,
instance_release_protection: Optional[bool] = None,
instance_type: Optional[str] = None,
is_auto_upgrade_open: Optional[str] = None,
kms_encrypted_password: Optional[str] = None,
kms_encryption_context: Optional[Mapping[str, str]] = None,
maintain_end_time: Optional[str] = None,
maintain_start_time: Optional[str] = None,
node_type: Optional[str] = None,
order_type: Optional[str] = None,
parameters: Optional[Sequence[InstanceParameterArgs]] = None,
password: Optional[str] = None,
payment_type: Optional[str] = None,
period: Optional[str] = None,
port: Optional[int] = None,
private_connection_port: Optional[str] = None,
private_connection_prefix: Optional[str] = None,
private_ip: Optional[str] = None,
read_only_count: Optional[int] = None,
resource_group_id: Optional[str] = None,
restore_time: Optional[str] = None,
role_arn: Optional[str] = None,
secondary_zone_id: Optional[str] = None,
security_group_id: Optional[str] = None,
security_ip_group_attribute: Optional[str] = None,
security_ip_group_name: Optional[str] = None,
security_ips: Optional[Sequence[str]] = None,
shard_count: Optional[int] = None,
slave_read_only_count: Optional[int] = None,
srcdb_instance_id: Optional[str] = None,
ssl_enable: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
tde_status: Optional[str] = None,
vpc_auth_mode: Optional[str] = None,
vswitch_id: Optional[str] = None,
zone_id: Optional[str] = None)
func NewInstance(ctx *Context, name string, args *InstanceArgs, opts ...ResourceOption) (*Instance, error)
public Instance(string name, InstanceArgs? args = null, CustomResourceOptions? opts = null)
public Instance(String name, InstanceArgs args)
public Instance(String name, InstanceArgs args, CustomResourceOptions options)
type: alicloud:kvstore: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 exampleinstanceResourceResourceFromKvstoreinstance = new AliCloud.KVStore.Instance("exampleinstanceResourceResourceFromKvstoreinstance", new()
{
AutoRenew = false,
AutoRenewPeriod = 0,
AutoUseCoupon = false,
BackupId = "string",
BackupPeriods = new[]
{
"string",
},
BackupTime = "string",
BusinessInfo = "string",
Capacity = 0,
Config =
{
{ "string", "string" },
},
CouponNo = "string",
DbInstanceName = "string",
DedicatedHostGroupId = "string",
DryRun = false,
EffectiveTime = "string",
EnableBackupLog = 0,
EncryptionKey = "string",
EncryptionName = "string",
EngineVersion = "string",
ForceUpgrade = false,
GlobalInstance = false,
GlobalInstanceId = "string",
InstanceClass = "string",
InstanceReleaseProtection = false,
InstanceType = "string",
IsAutoUpgradeOpen = "string",
KmsEncryptedPassword = "string",
KmsEncryptionContext =
{
{ "string", "string" },
},
MaintainEndTime = "string",
MaintainStartTime = "string",
OrderType = "string",
Password = "string",
PaymentType = "string",
Period = "string",
Port = 0,
PrivateConnectionPort = "string",
PrivateConnectionPrefix = "string",
PrivateIp = "string",
ReadOnlyCount = 0,
ResourceGroupId = "string",
RestoreTime = "string",
RoleArn = "string",
SecondaryZoneId = "string",
SecurityGroupId = "string",
SecurityIpGroupAttribute = "string",
SecurityIpGroupName = "string",
SecurityIps = new[]
{
"string",
},
ShardCount = 0,
SlaveReadOnlyCount = 0,
SrcdbInstanceId = "string",
SslEnable = "string",
Tags =
{
{ "string", "string" },
},
TdeStatus = "string",
VpcAuthMode = "string",
VswitchId = "string",
ZoneId = "string",
});
example, err := kvstore.NewInstance(ctx, "exampleinstanceResourceResourceFromKvstoreinstance", &kvstore.InstanceArgs{
AutoRenew: pulumi.Bool(false),
AutoRenewPeriod: pulumi.Int(0),
AutoUseCoupon: pulumi.Bool(false),
BackupId: pulumi.String("string"),
BackupPeriods: pulumi.StringArray{
pulumi.String("string"),
},
BackupTime: pulumi.String("string"),
BusinessInfo: pulumi.String("string"),
Capacity: pulumi.Int(0),
Config: pulumi.StringMap{
"string": pulumi.String("string"),
},
CouponNo: pulumi.String("string"),
DbInstanceName: pulumi.String("string"),
DedicatedHostGroupId: pulumi.String("string"),
DryRun: pulumi.Bool(false),
EffectiveTime: pulumi.String("string"),
EnableBackupLog: pulumi.Int(0),
EncryptionKey: pulumi.String("string"),
EncryptionName: pulumi.String("string"),
EngineVersion: pulumi.String("string"),
ForceUpgrade: pulumi.Bool(false),
GlobalInstance: pulumi.Bool(false),
GlobalInstanceId: pulumi.String("string"),
InstanceClass: pulumi.String("string"),
InstanceReleaseProtection: pulumi.Bool(false),
InstanceType: pulumi.String("string"),
IsAutoUpgradeOpen: pulumi.String("string"),
KmsEncryptedPassword: pulumi.String("string"),
KmsEncryptionContext: pulumi.StringMap{
"string": pulumi.String("string"),
},
MaintainEndTime: pulumi.String("string"),
MaintainStartTime: pulumi.String("string"),
OrderType: pulumi.String("string"),
Password: pulumi.String("string"),
PaymentType: pulumi.String("string"),
Period: pulumi.String("string"),
Port: pulumi.Int(0),
PrivateConnectionPort: pulumi.String("string"),
PrivateConnectionPrefix: pulumi.String("string"),
PrivateIp: pulumi.String("string"),
ReadOnlyCount: pulumi.Int(0),
ResourceGroupId: pulumi.String("string"),
RestoreTime: pulumi.String("string"),
RoleArn: pulumi.String("string"),
SecondaryZoneId: pulumi.String("string"),
SecurityGroupId: pulumi.String("string"),
SecurityIpGroupAttribute: pulumi.String("string"),
SecurityIpGroupName: pulumi.String("string"),
SecurityIps: pulumi.StringArray{
pulumi.String("string"),
},
ShardCount: pulumi.Int(0),
SlaveReadOnlyCount: pulumi.Int(0),
SrcdbInstanceId: pulumi.String("string"),
SslEnable: pulumi.String("string"),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
TdeStatus: pulumi.String("string"),
VpcAuthMode: pulumi.String("string"),
VswitchId: pulumi.String("string"),
ZoneId: pulumi.String("string"),
})
var exampleinstanceResourceResourceFromKvstoreinstance = new Instance("exampleinstanceResourceResourceFromKvstoreinstance", InstanceArgs.builder()
.autoRenew(false)
.autoRenewPeriod(0)
.autoUseCoupon(false)
.backupId("string")
.backupPeriods("string")
.backupTime("string")
.businessInfo("string")
.capacity(0)
.config(Map.of("string", "string"))
.couponNo("string")
.dbInstanceName("string")
.dedicatedHostGroupId("string")
.dryRun(false)
.effectiveTime("string")
.enableBackupLog(0)
.encryptionKey("string")
.encryptionName("string")
.engineVersion("string")
.forceUpgrade(false)
.globalInstance(false)
.globalInstanceId("string")
.instanceClass("string")
.instanceReleaseProtection(false)
.instanceType("string")
.isAutoUpgradeOpen("string")
.kmsEncryptedPassword("string")
.kmsEncryptionContext(Map.of("string", "string"))
.maintainEndTime("string")
.maintainStartTime("string")
.orderType("string")
.password("string")
.paymentType("string")
.period("string")
.port(0)
.privateConnectionPort("string")
.privateConnectionPrefix("string")
.privateIp("string")
.readOnlyCount(0)
.resourceGroupId("string")
.restoreTime("string")
.roleArn("string")
.secondaryZoneId("string")
.securityGroupId("string")
.securityIpGroupAttribute("string")
.securityIpGroupName("string")
.securityIps("string")
.shardCount(0)
.slaveReadOnlyCount(0)
.srcdbInstanceId("string")
.sslEnable("string")
.tags(Map.of("string", "string"))
.tdeStatus("string")
.vpcAuthMode("string")
.vswitchId("string")
.zoneId("string")
.build());
exampleinstance_resource_resource_from_kvstoreinstance = alicloud.kvstore.Instance("exampleinstanceResourceResourceFromKvstoreinstance",
auto_renew=False,
auto_renew_period=0,
auto_use_coupon=False,
backup_id="string",
backup_periods=["string"],
backup_time="string",
business_info="string",
capacity=0,
config={
"string": "string",
},
coupon_no="string",
db_instance_name="string",
dedicated_host_group_id="string",
dry_run=False,
effective_time="string",
enable_backup_log=0,
encryption_key="string",
encryption_name="string",
engine_version="string",
force_upgrade=False,
global_instance=False,
global_instance_id="string",
instance_class="string",
instance_release_protection=False,
instance_type="string",
is_auto_upgrade_open="string",
kms_encrypted_password="string",
kms_encryption_context={
"string": "string",
},
maintain_end_time="string",
maintain_start_time="string",
order_type="string",
password="string",
payment_type="string",
period="string",
port=0,
private_connection_port="string",
private_connection_prefix="string",
private_ip="string",
read_only_count=0,
resource_group_id="string",
restore_time="string",
role_arn="string",
secondary_zone_id="string",
security_group_id="string",
security_ip_group_attribute="string",
security_ip_group_name="string",
security_ips=["string"],
shard_count=0,
slave_read_only_count=0,
srcdb_instance_id="string",
ssl_enable="string",
tags={
"string": "string",
},
tde_status="string",
vpc_auth_mode="string",
vswitch_id="string",
zone_id="string")
const exampleinstanceResourceResourceFromKvstoreinstance = new alicloud.kvstore.Instance("exampleinstanceResourceResourceFromKvstoreinstance", {
autoRenew: false,
autoRenewPeriod: 0,
autoUseCoupon: false,
backupId: "string",
backupPeriods: ["string"],
backupTime: "string",
businessInfo: "string",
capacity: 0,
config: {
string: "string",
},
couponNo: "string",
dbInstanceName: "string",
dedicatedHostGroupId: "string",
dryRun: false,
effectiveTime: "string",
enableBackupLog: 0,
encryptionKey: "string",
encryptionName: "string",
engineVersion: "string",
forceUpgrade: false,
globalInstance: false,
globalInstanceId: "string",
instanceClass: "string",
instanceReleaseProtection: false,
instanceType: "string",
isAutoUpgradeOpen: "string",
kmsEncryptedPassword: "string",
kmsEncryptionContext: {
string: "string",
},
maintainEndTime: "string",
maintainStartTime: "string",
orderType: "string",
password: "string",
paymentType: "string",
period: "string",
port: 0,
privateConnectionPort: "string",
privateConnectionPrefix: "string",
privateIp: "string",
readOnlyCount: 0,
resourceGroupId: "string",
restoreTime: "string",
roleArn: "string",
secondaryZoneId: "string",
securityGroupId: "string",
securityIpGroupAttribute: "string",
securityIpGroupName: "string",
securityIps: ["string"],
shardCount: 0,
slaveReadOnlyCount: 0,
srcdbInstanceId: "string",
sslEnable: "string",
tags: {
string: "string",
},
tdeStatus: "string",
vpcAuthMode: "string",
vswitchId: "string",
zoneId: "string",
});
type: alicloud:kvstore:Instance
properties:
autoRenew: false
autoRenewPeriod: 0
autoUseCoupon: false
backupId: string
backupPeriods:
- string
backupTime: string
businessInfo: string
capacity: 0
config:
string: string
couponNo: string
dbInstanceName: string
dedicatedHostGroupId: string
dryRun: false
effectiveTime: string
enableBackupLog: 0
encryptionKey: string
encryptionName: string
engineVersion: string
forceUpgrade: false
globalInstance: false
globalInstanceId: string
instanceClass: string
instanceReleaseProtection: false
instanceType: string
isAutoUpgradeOpen: string
kmsEncryptedPassword: string
kmsEncryptionContext:
string: string
maintainEndTime: string
maintainStartTime: string
orderType: string
password: string
paymentType: string
period: string
port: 0
privateConnectionPort: string
privateConnectionPrefix: string
privateIp: string
readOnlyCount: 0
resourceGroupId: string
restoreTime: string
roleArn: string
secondaryZoneId: string
securityGroupId: string
securityIpGroupAttribute: string
securityIpGroupName: string
securityIps:
- string
shardCount: 0
slaveReadOnlyCount: 0
srcdbInstanceId: string
sslEnable: string
tags:
string: string
tdeStatus: string
vpcAuthMode: string
vswitchId: string
zoneId: 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
The Instance resource accepts the following input properties:
- Auto
Renew bool - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - Auto
Renew intPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - Auto
Use boolCoupon - Specifies whether to use a coupon. Default value:
false
. - Availability
Zone string - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - Backup
Id string - The ID of the backup file of the source instance.
- Backup
Periods List<string> - Backup period.
- Backup
Time string - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- Business
Info string - The ID of the event or the business information.
- Capacity int
- The storage capacity of the KVStore DBInstance. Unit: MB.
- Config Dictionary<string, string>
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- Connection
String stringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Coupon
No string - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - Db
Instance stringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- Dedicated
Host stringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- Dry
Run bool - Specifies whether to precheck the request. Valid values:
- Effective
Time string - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- Enable
Backup intLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- Enable
Public bool - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Encryption
Key string - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- Encryption
Name string - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- Engine
Version string - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - Force
Upgrade bool - Specifies whether to forcibly change the type. Default value:
true
. - Global
Instance bool - Whether to create a distributed cache. Default value:
false
. - Global
Instance stringId - The ID of distributed cache.
- Instance
Charge stringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - Instance
Class string - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - Instance
Name string - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - Instance
Release boolProtection - Whether to open the release protection.
- Instance
Type string - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - Is
Auto stringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- Kms
Encrypted stringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - Kms
Encryption Dictionary<string, string>Context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - Maintain
End stringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- Maintain
Start stringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- Node
Type string - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - Order
Type string - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - Parameters
List<Pulumi.
Ali Cloud. KVStore. Inputs. Instance Parameter> - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - Password string
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- Payment
Type string - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - Period string
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - Port int
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Private
Connection stringPort - Private network connection port, used to modify the private network connection port.
- Private
Connection stringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- Private
Ip string - The internal IP address of the instance.
- Read
Only intCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - Resource
Group stringId - The ID of resource group which the resource belongs.
- Restore
Time string - The point in time of a backup file.
- Role
Arn string - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - Secondary
Zone stringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- Security
Group stringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - Security
Ip stringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- Security
Ip stringGroup Name - The name of the whitelist group.
- Security
Ips List<string> - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- int
- The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - Slave
Read intOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- Srcdb
Instance stringId - The ID of the source instance.
- Ssl
Enable string - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - Dictionary<string, string>
- A mapping of tags to assign to the resource.
- Tde
Status string - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - Vpc
Auth stringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - Vswitch
Id string - The ID of VSwitch.
- Zone
Id string - The ID of the zone.
- Auto
Renew bool - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - Auto
Renew intPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - Auto
Use boolCoupon - Specifies whether to use a coupon. Default value:
false
. - Availability
Zone string - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - Backup
Id string - The ID of the backup file of the source instance.
- Backup
Periods []string - Backup period.
- Backup
Time string - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- Business
Info string - The ID of the event or the business information.
- Capacity int
- The storage capacity of the KVStore DBInstance. Unit: MB.
- Config map[string]string
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- Connection
String stringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Coupon
No string - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - Db
Instance stringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- Dedicated
Host stringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- Dry
Run bool - Specifies whether to precheck the request. Valid values:
- Effective
Time string - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- Enable
Backup intLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- Enable
Public bool - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Encryption
Key string - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- Encryption
Name string - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- Engine
Version string - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - Force
Upgrade bool - Specifies whether to forcibly change the type. Default value:
true
. - Global
Instance bool - Whether to create a distributed cache. Default value:
false
. - Global
Instance stringId - The ID of distributed cache.
- Instance
Charge stringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - Instance
Class string - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - Instance
Name string - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - Instance
Release boolProtection - Whether to open the release protection.
- Instance
Type string - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - Is
Auto stringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- Kms
Encrypted stringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - Kms
Encryption map[string]stringContext - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - Maintain
End stringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- Maintain
Start stringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- Node
Type string - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - Order
Type string - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - Parameters
[]Instance
Parameter Args - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - Password string
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- Payment
Type string - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - Period string
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - Port int
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Private
Connection stringPort - Private network connection port, used to modify the private network connection port.
- Private
Connection stringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- Private
Ip string - The internal IP address of the instance.
- Read
Only intCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - Resource
Group stringId - The ID of resource group which the resource belongs.
- Restore
Time string - The point in time of a backup file.
- Role
Arn string - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - Secondary
Zone stringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- Security
Group stringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - Security
Ip stringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- Security
Ip stringGroup Name - The name of the whitelist group.
- Security
Ips []string - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- int
- The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - Slave
Read intOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- Srcdb
Instance stringId - The ID of the source instance.
- Ssl
Enable string - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - map[string]string
- A mapping of tags to assign to the resource.
- Tde
Status string - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - Vpc
Auth stringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - Vswitch
Id string - The ID of VSwitch.
- Zone
Id string - The ID of the zone.
- auto
Renew Boolean - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - auto
Renew IntegerPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - auto
Use BooleanCoupon - Specifies whether to use a coupon. Default value:
false
. - availability
Zone String - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - backup
Id String - The ID of the backup file of the source instance.
- backup
Periods List<String> - Backup period.
- backup
Time String - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- business
Info String - The ID of the event or the business information.
- capacity Integer
- The storage capacity of the KVStore DBInstance. Unit: MB.
- config Map<String,String>
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- connection
String StringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - coupon
No String - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - db
Instance StringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- dedicated
Host StringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- dry
Run Boolean - Specifies whether to precheck the request. Valid values:
- effective
Time String - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- enable
Backup IntegerLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- enable
Public Boolean - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - encryption
Key String - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- encryption
Name String - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- engine
Version String - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - force
Upgrade Boolean - Specifies whether to forcibly change the type. Default value:
true
. - global
Instance Boolean - Whether to create a distributed cache. Default value:
false
. - global
Instance StringId - The ID of distributed cache.
- instance
Charge StringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - instance
Class String - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - instance
Name String - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - instance
Release BooleanProtection - Whether to open the release protection.
- instance
Type String - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - is
Auto StringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- kms
Encrypted StringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - kms
Encryption Map<String,String>Context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - maintain
End StringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- maintain
Start StringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- node
Type String - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - order
Type String - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - parameters
List<Instance
Parameter> - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - password String
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- payment
Type String - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - period String
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - port Integer
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - private
Connection StringPort - Private network connection port, used to modify the private network connection port.
- private
Connection StringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- private
Ip String - The internal IP address of the instance.
- read
Only IntegerCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - resource
Group StringId - The ID of resource group which the resource belongs.
- restore
Time String - The point in time of a backup file.
- role
Arn String - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - secondary
Zone StringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- security
Group StringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - security
Ip StringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- security
Ip StringGroup Name - The name of the whitelist group.
- security
Ips List<String> - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- Integer
- The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - slave
Read IntegerOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- srcdb
Instance StringId - The ID of the source instance.
- ssl
Enable String - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - Map<String,String>
- A mapping of tags to assign to the resource.
- tde
Status String - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - vpc
Auth StringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - vswitch
Id String - The ID of VSwitch.
- zone
Id String - The ID of the zone.
- auto
Renew boolean - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - auto
Renew numberPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - auto
Use booleanCoupon - Specifies whether to use a coupon. Default value:
false
. - availability
Zone string - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - backup
Id string - The ID of the backup file of the source instance.
- backup
Periods string[] - Backup period.
- backup
Time string - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- business
Info string - The ID of the event or the business information.
- capacity number
- The storage capacity of the KVStore DBInstance. Unit: MB.
- config {[key: string]: string}
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- connection
String stringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - coupon
No string - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - db
Instance stringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- dedicated
Host stringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- dry
Run boolean - Specifies whether to precheck the request. Valid values:
- effective
Time string - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- enable
Backup numberLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- enable
Public boolean - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - encryption
Key string - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- encryption
Name string - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- engine
Version string - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - force
Upgrade boolean - Specifies whether to forcibly change the type. Default value:
true
. - global
Instance boolean - Whether to create a distributed cache. Default value:
false
. - global
Instance stringId - The ID of distributed cache.
- instance
Charge stringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - instance
Class string - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - instance
Name string - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - instance
Release booleanProtection - Whether to open the release protection.
- instance
Type string - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - is
Auto stringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- kms
Encrypted stringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - kms
Encryption {[key: string]: string}Context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - maintain
End stringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- maintain
Start stringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- node
Type string - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - order
Type string - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - parameters
Instance
Parameter[] - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - password string
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- payment
Type string - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - period string
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - port number
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - private
Connection stringPort - Private network connection port, used to modify the private network connection port.
- private
Connection stringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- private
Ip string - The internal IP address of the instance.
- read
Only numberCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - resource
Group stringId - The ID of resource group which the resource belongs.
- restore
Time string - The point in time of a backup file.
- role
Arn string - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - secondary
Zone stringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- security
Group stringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - security
Ip stringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- security
Ip stringGroup Name - The name of the whitelist group.
- security
Ips string[] - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- number
- The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - slave
Read numberOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- srcdb
Instance stringId - The ID of the source instance.
- ssl
Enable string - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - {[key: string]: string}
- A mapping of tags to assign to the resource.
- tde
Status string - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - vpc
Auth stringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - vswitch
Id string - The ID of VSwitch.
- zone
Id string - The ID of the zone.
- auto_
renew bool - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - auto_
renew_ intperiod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - auto_
use_ boolcoupon - Specifies whether to use a coupon. Default value:
false
. - availability_
zone str - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - backup_
id str - The ID of the backup file of the source instance.
- backup_
periods Sequence[str] - Backup period.
- backup_
time str - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- business_
info str - The ID of the event or the business information.
- capacity int
- The storage capacity of the KVStore DBInstance. Unit: MB.
- config Mapping[str, str]
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- connection_
string_ strprefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - coupon_
no str - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - db_
instance_ strname - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- dedicated_
host_ strgroup_ id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- dry_
run bool - Specifies whether to precheck the request. Valid values:
- effective_
time str - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- enable_
backup_ intlog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- enable_
public bool - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - encryption_
key str - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- encryption_
name str - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- engine_
version str - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - force_
upgrade bool - Specifies whether to forcibly change the type. Default value:
true
. - global_
instance bool - Whether to create a distributed cache. Default value:
false
. - global_
instance_ strid - The ID of distributed cache.
- instance_
charge_ strtype - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - instance_
class str - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - instance_
name str - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - instance_
release_ boolprotection - Whether to open the release protection.
- instance_
type str - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - is_
auto_ strupgrade_ open - Specifies whether to enable automatic minor version update. Valid values:
- kms_
encrypted_ strpassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - kms_
encryption_ Mapping[str, str]context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - maintain_
end_ strtime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- maintain_
start_ strtime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- node_
type str - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - order_
type str - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - parameters
Sequence[Instance
Parameter Args] - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - password str
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- payment_
type str - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - period str
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - port int
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - private_
connection_ strport - Private network connection port, used to modify the private network connection port.
- private_
connection_ strprefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- private_
ip str - The internal IP address of the instance.
- read_
only_ intcount - The number of read replicas in the primary zone. Valid values:
1
to9
. - resource_
group_ strid - The ID of resource group which the resource belongs.
- restore_
time str - The point in time of a backup file.
- role_
arn str - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - secondary_
zone_ strid The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- security_
group_ strid - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - security_
ip_ strgroup_ attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- security_
ip_ strgroup_ name - The name of the whitelist group.
- security_
ips Sequence[str] - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- int
- The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - slave_
read_ intonly_ count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- srcdb_
instance_ strid - The ID of the source instance.
- ssl_
enable str - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - Mapping[str, str]
- A mapping of tags to assign to the resource.
- tde_
status str - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - vpc_
auth_ strmode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - vswitch_
id str - The ID of VSwitch.
- zone_
id str - The ID of the zone.
- auto
Renew Boolean - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - auto
Renew NumberPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - auto
Use BooleanCoupon - Specifies whether to use a coupon. Default value:
false
. - availability
Zone String - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - backup
Id String - The ID of the backup file of the source instance.
- backup
Periods List<String> - Backup period.
- backup
Time String - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- business
Info String - The ID of the event or the business information.
- capacity Number
- The storage capacity of the KVStore DBInstance. Unit: MB.
- config Map<String>
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- connection
String StringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - coupon
No String - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - db
Instance StringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- dedicated
Host StringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- dry
Run Boolean - Specifies whether to precheck the request. Valid values:
- effective
Time String - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- enable
Backup NumberLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- enable
Public Boolean - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - encryption
Key String - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- encryption
Name String - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- engine
Version String - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - force
Upgrade Boolean - Specifies whether to forcibly change the type. Default value:
true
. - global
Instance Boolean - Whether to create a distributed cache. Default value:
false
. - global
Instance StringId - The ID of distributed cache.
- instance
Charge StringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - instance
Class String - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - instance
Name String - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - instance
Release BooleanProtection - Whether to open the release protection.
- instance
Type String - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - is
Auto StringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- kms
Encrypted StringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - kms
Encryption Map<String>Context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - maintain
End StringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- maintain
Start StringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- node
Type String - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - order
Type String - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - parameters List<Property Map>
- It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - password String
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- payment
Type String - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - period String
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - port Number
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - private
Connection StringPort - Private network connection port, used to modify the private network connection port.
- private
Connection StringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- private
Ip String - The internal IP address of the instance.
- read
Only NumberCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - resource
Group StringId - The ID of resource group which the resource belongs.
- restore
Time String - The point in time of a backup file.
- role
Arn String - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - secondary
Zone StringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- security
Group StringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - security
Ip StringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- security
Ip StringGroup Name - The name of the whitelist group.
- security
Ips List<String> - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- Number
- The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - slave
Read NumberOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- srcdb
Instance StringId - The ID of the source instance.
- ssl
Enable String - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - Map<String>
- A mapping of tags to assign to the resource.
- tde
Status String - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - vpc
Auth StringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - vswitch
Id String - The ID of VSwitch.
- zone
Id String - The ID of the zone.
Outputs
All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:
- Bandwidth int
- The bandwidth.
- Connection
Domain string - Intranet connection address of the KVStore instance.
- Connection
String string - Indicates whether the address is a private endpoint.
- End
Time string - The expiration time of the prepaid instance.
- Id string
- The provider-assigned unique ID for this managed resource.
- Qps int
- Theoretical maximum QPS value.
- Status string
- The status of KVStore DBInstance.
- Bandwidth int
- The bandwidth.
- Connection
Domain string - Intranet connection address of the KVStore instance.
- Connection
String string - Indicates whether the address is a private endpoint.
- End
Time string - The expiration time of the prepaid instance.
- Id string
- The provider-assigned unique ID for this managed resource.
- Qps int
- Theoretical maximum QPS value.
- Status string
- The status of KVStore DBInstance.
- bandwidth Integer
- The bandwidth.
- connection
Domain String - Intranet connection address of the KVStore instance.
- connection
String String - Indicates whether the address is a private endpoint.
- end
Time String - The expiration time of the prepaid instance.
- id String
- The provider-assigned unique ID for this managed resource.
- qps Integer
- Theoretical maximum QPS value.
- status String
- The status of KVStore DBInstance.
- bandwidth number
- The bandwidth.
- connection
Domain string - Intranet connection address of the KVStore instance.
- connection
String string - Indicates whether the address is a private endpoint.
- end
Time string - The expiration time of the prepaid instance.
- id string
- The provider-assigned unique ID for this managed resource.
- qps number
- Theoretical maximum QPS value.
- status string
- The status of KVStore DBInstance.
- bandwidth int
- The bandwidth.
- connection_
domain str - Intranet connection address of the KVStore instance.
- connection_
string str - Indicates whether the address is a private endpoint.
- end_
time str - The expiration time of the prepaid instance.
- id str
- The provider-assigned unique ID for this managed resource.
- qps int
- Theoretical maximum QPS value.
- status str
- The status of KVStore DBInstance.
- bandwidth Number
- The bandwidth.
- connection
Domain String - Intranet connection address of the KVStore instance.
- connection
String String - Indicates whether the address is a private endpoint.
- end
Time String - The expiration time of the prepaid instance.
- id String
- The provider-assigned unique ID for this managed resource.
- qps Number
- Theoretical maximum QPS value.
- status String
- The status of KVStore DBInstance.
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,
auto_renew: Optional[bool] = None,
auto_renew_period: Optional[int] = None,
auto_use_coupon: Optional[bool] = None,
availability_zone: Optional[str] = None,
backup_id: Optional[str] = None,
backup_periods: Optional[Sequence[str]] = None,
backup_time: Optional[str] = None,
bandwidth: Optional[int] = None,
business_info: Optional[str] = None,
capacity: Optional[int] = None,
config: Optional[Mapping[str, str]] = None,
connection_domain: Optional[str] = None,
connection_string: Optional[str] = None,
connection_string_prefix: Optional[str] = None,
coupon_no: Optional[str] = None,
db_instance_name: Optional[str] = None,
dedicated_host_group_id: Optional[str] = None,
dry_run: Optional[bool] = None,
effective_time: Optional[str] = None,
enable_backup_log: Optional[int] = None,
enable_public: Optional[bool] = None,
encryption_key: Optional[str] = None,
encryption_name: Optional[str] = None,
end_time: Optional[str] = None,
engine_version: Optional[str] = None,
force_upgrade: Optional[bool] = None,
global_instance: Optional[bool] = None,
global_instance_id: Optional[str] = None,
instance_charge_type: Optional[str] = None,
instance_class: Optional[str] = None,
instance_name: Optional[str] = None,
instance_release_protection: Optional[bool] = None,
instance_type: Optional[str] = None,
is_auto_upgrade_open: Optional[str] = None,
kms_encrypted_password: Optional[str] = None,
kms_encryption_context: Optional[Mapping[str, str]] = None,
maintain_end_time: Optional[str] = None,
maintain_start_time: Optional[str] = None,
node_type: Optional[str] = None,
order_type: Optional[str] = None,
parameters: Optional[Sequence[InstanceParameterArgs]] = None,
password: Optional[str] = None,
payment_type: Optional[str] = None,
period: Optional[str] = None,
port: Optional[int] = None,
private_connection_port: Optional[str] = None,
private_connection_prefix: Optional[str] = None,
private_ip: Optional[str] = None,
qps: Optional[int] = None,
read_only_count: Optional[int] = None,
resource_group_id: Optional[str] = None,
restore_time: Optional[str] = None,
role_arn: Optional[str] = None,
secondary_zone_id: Optional[str] = None,
security_group_id: Optional[str] = None,
security_ip_group_attribute: Optional[str] = None,
security_ip_group_name: Optional[str] = None,
security_ips: Optional[Sequence[str]] = None,
shard_count: Optional[int] = None,
slave_read_only_count: Optional[int] = None,
srcdb_instance_id: Optional[str] = None,
ssl_enable: Optional[str] = None,
status: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
tde_status: Optional[str] = None,
vpc_auth_mode: Optional[str] = None,
vswitch_id: Optional[str] = None,
zone_id: Optional[str] = None) -> Instance
func 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)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Auto
Renew bool - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - Auto
Renew intPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - Auto
Use boolCoupon - Specifies whether to use a coupon. Default value:
false
. - Availability
Zone string - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - Backup
Id string - The ID of the backup file of the source instance.
- Backup
Periods List<string> - Backup period.
- Backup
Time string - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- Bandwidth int
- The bandwidth.
- Business
Info string - The ID of the event or the business information.
- Capacity int
- The storage capacity of the KVStore DBInstance. Unit: MB.
- Config Dictionary<string, string>
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- Connection
Domain string - Intranet connection address of the KVStore instance.
- Connection
String string - Indicates whether the address is a private endpoint.
- Connection
String stringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Coupon
No string - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - Db
Instance stringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- Dedicated
Host stringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- Dry
Run bool - Specifies whether to precheck the request. Valid values:
- Effective
Time string - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- Enable
Backup intLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- Enable
Public bool - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Encryption
Key string - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- Encryption
Name string - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- End
Time string - The expiration time of the prepaid instance.
- Engine
Version string - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - Force
Upgrade bool - Specifies whether to forcibly change the type. Default value:
true
. - Global
Instance bool - Whether to create a distributed cache. Default value:
false
. - Global
Instance stringId - The ID of distributed cache.
- Instance
Charge stringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - Instance
Class string - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - Instance
Name string - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - Instance
Release boolProtection - Whether to open the release protection.
- Instance
Type string - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - Is
Auto stringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- Kms
Encrypted stringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - Kms
Encryption Dictionary<string, string>Context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - Maintain
End stringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- Maintain
Start stringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- Node
Type string - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - Order
Type string - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - Parameters
List<Pulumi.
Ali Cloud. KVStore. Inputs. Instance Parameter> - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - Password string
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- Payment
Type string - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - Period string
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - Port int
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Private
Connection stringPort - Private network connection port, used to modify the private network connection port.
- Private
Connection stringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- Private
Ip string - The internal IP address of the instance.
- Qps int
- Theoretical maximum QPS value.
- Read
Only intCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - Resource
Group stringId - The ID of resource group which the resource belongs.
- Restore
Time string - The point in time of a backup file.
- Role
Arn string - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - Secondary
Zone stringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- Security
Group stringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - Security
Ip stringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- Security
Ip stringGroup Name - The name of the whitelist group.
- Security
Ips List<string> - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- Shard
Count int - The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - Slave
Read intOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- Srcdb
Instance stringId - The ID of the source instance.
- Ssl
Enable string - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - Status string
- The status of KVStore DBInstance.
- Dictionary<string, string>
- A mapping of tags to assign to the resource.
- Tde
Status string - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - Vpc
Auth stringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - Vswitch
Id string - The ID of VSwitch.
- Zone
Id string - The ID of the zone.
- Auto
Renew bool - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - Auto
Renew intPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - Auto
Use boolCoupon - Specifies whether to use a coupon. Default value:
false
. - Availability
Zone string - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - Backup
Id string - The ID of the backup file of the source instance.
- Backup
Periods []string - Backup period.
- Backup
Time string - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- Bandwidth int
- The bandwidth.
- Business
Info string - The ID of the event or the business information.
- Capacity int
- The storage capacity of the KVStore DBInstance. Unit: MB.
- Config map[string]string
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- Connection
Domain string - Intranet connection address of the KVStore instance.
- Connection
String string - Indicates whether the address is a private endpoint.
- Connection
String stringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Coupon
No string - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - Db
Instance stringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- Dedicated
Host stringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- Dry
Run bool - Specifies whether to precheck the request. Valid values:
- Effective
Time string - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- Enable
Backup intLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- Enable
Public bool - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Encryption
Key string - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- Encryption
Name string - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- End
Time string - The expiration time of the prepaid instance.
- Engine
Version string - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - Force
Upgrade bool - Specifies whether to forcibly change the type. Default value:
true
. - Global
Instance bool - Whether to create a distributed cache. Default value:
false
. - Global
Instance stringId - The ID of distributed cache.
- Instance
Charge stringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - Instance
Class string - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - Instance
Name string - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - Instance
Release boolProtection - Whether to open the release protection.
- Instance
Type string - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - Is
Auto stringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- Kms
Encrypted stringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - Kms
Encryption map[string]stringContext - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - Maintain
End stringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- Maintain
Start stringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- Node
Type string - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - Order
Type string - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - Parameters
[]Instance
Parameter Args - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - Password string
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- Payment
Type string - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - Period string
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - Port int
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - Private
Connection stringPort - Private network connection port, used to modify the private network connection port.
- Private
Connection stringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- Private
Ip string - The internal IP address of the instance.
- Qps int
- Theoretical maximum QPS value.
- Read
Only intCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - Resource
Group stringId - The ID of resource group which the resource belongs.
- Restore
Time string - The point in time of a backup file.
- Role
Arn string - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - Secondary
Zone stringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- Security
Group stringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - Security
Ip stringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- Security
Ip stringGroup Name - The name of the whitelist group.
- Security
Ips []string - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- Shard
Count int - The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - Slave
Read intOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- Srcdb
Instance stringId - The ID of the source instance.
- Ssl
Enable string - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - Status string
- The status of KVStore DBInstance.
- map[string]string
- A mapping of tags to assign to the resource.
- Tde
Status string - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - Vpc
Auth stringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - Vswitch
Id string - The ID of VSwitch.
- Zone
Id string - The ID of the zone.
- auto
Renew Boolean - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - auto
Renew IntegerPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - auto
Use BooleanCoupon - Specifies whether to use a coupon. Default value:
false
. - availability
Zone String - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - backup
Id String - The ID of the backup file of the source instance.
- backup
Periods List<String> - Backup period.
- backup
Time String - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- bandwidth Integer
- The bandwidth.
- business
Info String - The ID of the event or the business information.
- capacity Integer
- The storage capacity of the KVStore DBInstance. Unit: MB.
- config Map<String,String>
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- connection
Domain String - Intranet connection address of the KVStore instance.
- connection
String String - Indicates whether the address is a private endpoint.
- connection
String StringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - coupon
No String - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - db
Instance StringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- dedicated
Host StringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- dry
Run Boolean - Specifies whether to precheck the request. Valid values:
- effective
Time String - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- enable
Backup IntegerLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- enable
Public Boolean - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - encryption
Key String - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- encryption
Name String - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- end
Time String - The expiration time of the prepaid instance.
- engine
Version String - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - force
Upgrade Boolean - Specifies whether to forcibly change the type. Default value:
true
. - global
Instance Boolean - Whether to create a distributed cache. Default value:
false
. - global
Instance StringId - The ID of distributed cache.
- instance
Charge StringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - instance
Class String - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - instance
Name String - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - instance
Release BooleanProtection - Whether to open the release protection.
- instance
Type String - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - is
Auto StringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- kms
Encrypted StringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - kms
Encryption Map<String,String>Context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - maintain
End StringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- maintain
Start StringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- node
Type String - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - order
Type String - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - parameters
List<Instance
Parameter> - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - password String
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- payment
Type String - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - period String
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - port Integer
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - private
Connection StringPort - Private network connection port, used to modify the private network connection port.
- private
Connection StringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- private
Ip String - The internal IP address of the instance.
- qps Integer
- Theoretical maximum QPS value.
- read
Only IntegerCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - resource
Group StringId - The ID of resource group which the resource belongs.
- restore
Time String - The point in time of a backup file.
- role
Arn String - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - secondary
Zone StringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- security
Group StringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - security
Ip StringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- security
Ip StringGroup Name - The name of the whitelist group.
- security
Ips List<String> - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- shard
Count Integer - The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - slave
Read IntegerOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- srcdb
Instance StringId - The ID of the source instance.
- ssl
Enable String - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - status String
- The status of KVStore DBInstance.
- Map<String,String>
- A mapping of tags to assign to the resource.
- tde
Status String - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - vpc
Auth StringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - vswitch
Id String - The ID of VSwitch.
- zone
Id String - The ID of the zone.
- auto
Renew boolean - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - auto
Renew numberPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - auto
Use booleanCoupon - Specifies whether to use a coupon. Default value:
false
. - availability
Zone string - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - backup
Id string - The ID of the backup file of the source instance.
- backup
Periods string[] - Backup period.
- backup
Time string - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- bandwidth number
- The bandwidth.
- business
Info string - The ID of the event or the business information.
- capacity number
- The storage capacity of the KVStore DBInstance. Unit: MB.
- config {[key: string]: string}
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- connection
Domain string - Intranet connection address of the KVStore instance.
- connection
String string - Indicates whether the address is a private endpoint.
- connection
String stringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - coupon
No string - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - db
Instance stringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- dedicated
Host stringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- dry
Run boolean - Specifies whether to precheck the request. Valid values:
- effective
Time string - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- enable
Backup numberLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- enable
Public boolean - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - encryption
Key string - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- encryption
Name string - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- end
Time string - The expiration time of the prepaid instance.
- engine
Version string - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - force
Upgrade boolean - Specifies whether to forcibly change the type. Default value:
true
. - global
Instance boolean - Whether to create a distributed cache. Default value:
false
. - global
Instance stringId - The ID of distributed cache.
- instance
Charge stringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - instance
Class string - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - instance
Name string - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - instance
Release booleanProtection - Whether to open the release protection.
- instance
Type string - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - is
Auto stringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- kms
Encrypted stringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - kms
Encryption {[key: string]: string}Context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - maintain
End stringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- maintain
Start stringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- node
Type string - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - order
Type string - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - parameters
Instance
Parameter[] - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - password string
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- payment
Type string - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - period string
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - port number
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - private
Connection stringPort - Private network connection port, used to modify the private network connection port.
- private
Connection stringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- private
Ip string - The internal IP address of the instance.
- qps number
- Theoretical maximum QPS value.
- read
Only numberCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - resource
Group stringId - The ID of resource group which the resource belongs.
- restore
Time string - The point in time of a backup file.
- role
Arn string - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - secondary
Zone stringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- security
Group stringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - security
Ip stringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- security
Ip stringGroup Name - The name of the whitelist group.
- security
Ips string[] - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- shard
Count number - The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - slave
Read numberOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- srcdb
Instance stringId - The ID of the source instance.
- ssl
Enable string - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - status string
- The status of KVStore DBInstance.
- {[key: string]: string}
- A mapping of tags to assign to the resource.
- tde
Status string - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - vpc
Auth stringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - vswitch
Id string - The ID of VSwitch.
- zone
Id string - The ID of the zone.
- auto_
renew bool - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - auto_
renew_ intperiod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - auto_
use_ boolcoupon - Specifies whether to use a coupon. Default value:
false
. - availability_
zone str - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - backup_
id str - The ID of the backup file of the source instance.
- backup_
periods Sequence[str] - Backup period.
- backup_
time str - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- bandwidth int
- The bandwidth.
- business_
info str - The ID of the event or the business information.
- capacity int
- The storage capacity of the KVStore DBInstance. Unit: MB.
- config Mapping[str, str]
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- connection_
domain str - Intranet connection address of the KVStore instance.
- connection_
string str - Indicates whether the address is a private endpoint.
- connection_
string_ strprefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - coupon_
no str - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - db_
instance_ strname - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- dedicated_
host_ strgroup_ id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- dry_
run bool - Specifies whether to precheck the request. Valid values:
- effective_
time str - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- enable_
backup_ intlog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- enable_
public bool - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - encryption_
key str - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- encryption_
name str - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- end_
time str - The expiration time of the prepaid instance.
- engine_
version str - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - force_
upgrade bool - Specifies whether to forcibly change the type. Default value:
true
. - global_
instance bool - Whether to create a distributed cache. Default value:
false
. - global_
instance_ strid - The ID of distributed cache.
- instance_
charge_ strtype - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - instance_
class str - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - instance_
name str - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - instance_
release_ boolprotection - Whether to open the release protection.
- instance_
type str - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - is_
auto_ strupgrade_ open - Specifies whether to enable automatic minor version update. Valid values:
- kms_
encrypted_ strpassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - kms_
encryption_ Mapping[str, str]context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - maintain_
end_ strtime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- maintain_
start_ strtime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- node_
type str - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - order_
type str - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - parameters
Sequence[Instance
Parameter Args] - It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - password str
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- payment_
type str - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - period str
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - port int
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - private_
connection_ strport - Private network connection port, used to modify the private network connection port.
- private_
connection_ strprefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- private_
ip str - The internal IP address of the instance.
- qps int
- Theoretical maximum QPS value.
- read_
only_ intcount - The number of read replicas in the primary zone. Valid values:
1
to9
. - resource_
group_ strid - The ID of resource group which the resource belongs.
- restore_
time str - The point in time of a backup file.
- role_
arn str - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - secondary_
zone_ strid The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- security_
group_ strid - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - security_
ip_ strgroup_ attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- security_
ip_ strgroup_ name - The name of the whitelist group.
- security_
ips Sequence[str] - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- shard_
count int - The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - slave_
read_ intonly_ count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- srcdb_
instance_ strid - The ID of the source instance.
- ssl_
enable str - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - status str
- The status of KVStore DBInstance.
- Mapping[str, str]
- A mapping of tags to assign to the resource.
- tde_
status str - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - vpc_
auth_ strmode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - vswitch_
id str - The ID of VSwitch.
- zone_
id str - The ID of the zone.
- auto
Renew Boolean - Whether to renewal a KVStore DBInstance automatically or not. It is valid when payment_type is
PrePaid
. Default value:false
. - auto
Renew NumberPeriod - Auto-renewal period of an KVStore DBInstance, in the unit of the month. It is valid when payment_type is
PrePaid
. Valid values: [1~12]. Default value:1
. - auto
Use BooleanCoupon - Specifies whether to use a coupon. Default value:
false
. - availability
Zone String - It has been deprecated from provider version 1.101.0 and
zone_id
instead. - backup
Id String - The ID of the backup file of the source instance.
- backup
Periods List<String> - Backup period.
- backup
Time String - Backup time, the format is HH:mmZ-HH:mmZ (UTC time).
- bandwidth Number
- The bandwidth.
- business
Info String - The ID of the event or the business information.
- capacity Number
- The storage capacity of the KVStore DBInstance. Unit: MB.
- config Map<String>
- The configuration of the KVStore DBInstance. Available parameters can refer to the latest docs Instance configurations table.
- connection
Domain String - Intranet connection address of the KVStore instance.
- connection
String String - Indicates whether the address is a private endpoint.
- connection
String StringPrefix - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - coupon
No String - The coupon code. NOTE: The default value
youhuiquan_promotion_option_id_for_blank
removed since v1.216.0, this can cause your status file to change even if it has not been modified, so please review your change plan before apply change plan. - db
Instance StringName - The name of KVStore DBInstance. It is a string of 2 to 256 characters.
- dedicated
Host StringGroup Id - The ID of the dedicated cluster. This parameter is required when you create an ApsaraDB for Redis instance in a dedicated cluster.
- dry
Run Boolean - Specifies whether to precheck the request. Valid values:
- effective
Time String - The time when the database is switched after the instance is migrated, or when the major version is upgraded, or when the instance class is upgraded. Valid values:
Immediately
(Default): The configurations are immediately changed.MaintainTime
: The configurations are changed within the maintenance window. You can setmaintain_start_time
andmaintain_end_time
to change the maintenance window.
- enable
Backup NumberLog - Turn on or off incremental backup. Valid values:
1
,0
. Default value:0
- enable
Public Boolean - It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - encryption
Key String - The Custom key ID, which you can get by calling DescribeEncryptionKeyList.If this parameter is not passed, the key is automatically generated by the key management service. To create a custom key, you can call the CreateKey interface of the key management service.
- encryption
Name String - The Encryption algorithm, default AES-CTR-256.Note that this parameter is only available when the TDEStatus parameter is Enabled.
- end
Time String - The expiration time of the prepaid instance.
- engine
Version String - The engine version of the KVStore DBInstance. Valid values: ["2.8", "4.0", "5.0", "6.0", "7.0"]. Default value:
5.0
. NOTE: Wheninstance_type = Memcache
, theengine_version
only supports "4.0". - force
Upgrade Boolean - Specifies whether to forcibly change the type. Default value:
true
. - global
Instance Boolean - Whether to create a distributed cache. Default value:
false
. - global
Instance StringId - The ID of distributed cache.
- instance
Charge StringType - It has been deprecated from provider version 1.101.0 and
payment_type
instead. - instance
Class String - Type of the applied ApsaraDB for Redis instance. It can be retrieved by data source
alicloud.kvstore.getInstanceClasses
or referring to help-docs Instance type table. - instance
Name String - It has been deprecated from provider version 1.101.0 and
db_instance_name
instead. - instance
Release BooleanProtection - Whether to open the release protection.
- instance
Type String - The engine type of the KVStore DBInstance. Valid values:
Redis
orMemcache
. Default value:Redis
. - is
Auto StringUpgrade Open - Specifies whether to enable automatic minor version update. Valid values:
- kms
Encrypted StringPassword - An KMS encrypts password used to an instance. If the
password
is filled in, this field will be ignored. - kms
Encryption Map<String>Context - An KMS encryption context used to decrypt
kms_encrypted_password
before creating or updating instance withkms_encrypted_password
. See Encryption Context. It is valid whenkms_encrypted_password
is set. - maintain
End StringTime - The end time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- maintain
Start StringTime - The start time of the operation and maintenance time period of the KVStore DBInstance, in the format of HH:mmZ (UTC time).
- node
Type String - "Field
node_type
has been deprecated from version 1.120.1". This parameter is determined by theinstance_class
. - order
Type String - Specifies a change type when you change the configuration of a subscription instance. Valid values:
UPGRADE
,DOWNGRADE
. Default value:UPGRADE
.UPGRADE
means upgrades the configuration of a subscription instance.DOWNGRADE
means downgrades the configuration of a subscription instance. - parameters List<Property Map>
- It has been deprecated from provider version 1.101.0 and
config
instead. Seeparameters
below. - password String
- The password of the KVStore DBInstance. The password that is used to connect to the instance. The password must be 8 to 32 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, special characters, and digits. Special characters include:
! @ # $ % ^ & * ( ) _ + - =
- payment
Type String - The billing method of the KVStore DBInstance. Valid values:
PrePaid
,PostPaid
. Default value:PostPaid
. - period String
- The duration that you will buy KVStore DBInstance (in month). It is valid when payment_type is
PrePaid
. Valid values:[1~9]
,12
,24
,36
. - port Number
- It has been deprecated from provider version 1.101.0 and resource
alicloud.kvstore.Connection
instead. - private
Connection StringPort - Private network connection port, used to modify the private network connection port.
- private
Connection StringPrefix - Private network connection prefix, used to modify the private network connection address. Only supports updating private network connections for existing instance.
- private
Ip String - The internal IP address of the instance.
- qps Number
- Theoretical maximum QPS value.
- read
Only NumberCount - The number of read replicas in the primary zone. Valid values:
1
to9
. - resource
Group StringId - The ID of resource group which the resource belongs.
- restore
Time String - The point in time of a backup file.
- role
Arn String - The Specify the global resource descriptor ARN (Alibaba Cloud Resource Name) information of the role to be authorized, and use the related key management services after the authorization is completed, in the format:
acs:ram::$accountID:role/$roleName
. - secondary
Zone StringId The ID of the secondary zone to which you want to migrate the ApsaraDB for Redis instance.
NOTE: If you specify this parameter, the master node and replica node of the instance can be deployed in different zones and disaster recovery is implemented across zones. The instance can withstand failures in data centers.
- security
Group StringId - The ID of security groups. Separate multiple security group IDs with commas (,), such as
sg-***,sg-***,sg-***
. - security
Ip StringGroup Attribute - The value of this parameter is empty by default. The attribute of the whitelist group. The console does not display the whitelist group whose value of this parameter is hidden.
- security
Ip StringGroup Name - The name of the whitelist group.
- security
Ips List<String> - The IP addresses in the whitelist group. The maximum number of IP addresses in the whitelist group is 1000.
- shard
Count Number - The number of data shards. This parameter is available only if you create a cluster instance that uses cloud disks. You can use this parameter to specify a custom number of data shards. NOTE: From version 1.216.0,
shard_count
can be modified. - slave
Read NumberOnly Count The number of read replicas in the secondary zone. NOTE:: When you create a multi-zone read/write splitting instance, you must specify both
secondary_zone_id
andslave_read_only_count
.NOTE: The sum of
read_only_count
andslave_read_only_count
cannot be greater than9
.- srcdb
Instance StringId - The ID of the source instance.
- ssl
Enable String - Modifies the SSL status. Valid values:
Disable
,Enable
andUpdate
. NOTE: This functionality is supported by Cluster mode (Redis 2.8, 4.0, 5.0) and Standard mode( Redis 2.8 only). - status String
- The status of KVStore DBInstance.
- Map<String>
- A mapping of tags to assign to the resource.
- tde
Status String - Specifies whether to enable TDE. Valid values:
Enabled
. NOTE:: TDE cannot be disabled after it is enabled. Before you enable it, evaluate whether this feature affects. your business. For more information, see Enable TDE. - vpc
Auth StringMode - Only meaningful if instance_type is
Redis
and network type is VPC. Valid values:Close
,Open
. Default value:Open
.Close
means the redis instance can be accessed without authentication.Open
means authentication is required. - vswitch
Id String - The ID of VSwitch.
- zone
Id String - The ID of the zone.
Supporting Types
InstanceParameter, InstanceParameterArgs
Package Details
- Repository
- Alibaba Cloud pulumi/pulumi-alicloud
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
alicloud
Terraform Provider.