alicloud_kvstore_account

Provides a KVStore Account resource.

For information about KVStore Account and how to use it, see What is Account.

-> NOTE: Available since v1.66.0.

Example Usage

Basic Usage

variable "name" {
  default = "tf-example"
}
data "alicloud_kvstore_zones" "default" {

}
data "alicloud_resource_manager_resource_groups" "default" {
  status = "OK"
}

resource "alicloud_vpc" "default" {
  vpc_name   = var.name
  cidr_block = "10.4.0.0/16"
}
resource "alicloud_vswitch" "default" {
  vswitch_name = var.name
  cidr_block   = "10.4.0.0/24"
  vpc_id       = alicloud_vpc.default.id
  zone_id      = data.alicloud_kvstore_zones.default.zones.0.id
}

resource "alicloud_kvstore_instance" "default" {
  db_instance_name  = var.name
  vswitch_id        = alicloud_vswitch.default.id
  resource_group_id = data.alicloud_resource_manager_resource_groups.default.ids.0
  zone_id           = data.alicloud_kvstore_zones.default.zones.0.id
  instance_class    = "redis.master.large.default"
  instance_type     = "Redis"
  engine_version    = "5.0"
  security_ips      = ["10.23.12.24"]
  config = {
    appendonly             = "yes"
    lazyfree-lazy-eviction = "yes"
  }
  tags = {
    Created = "TF",
    For     = "example",
  }
}

resource "alicloud_kvstore_account" "default" {
  account_name     = "tfexamplename"
  account_password = "YourPassword_123"
  instance_id      = alicloud_kvstore_instance.default.id
}

Argument Reference

The following arguments are supported:

• account_name - (Required, ForceNew) The name of the account. The name must meet the following requirements:
  • The name can contain lowercase letters, digits, and hyphens (-), and must start with a lowercase letter.
  • The name can be up to 100 characters in length.
  • The name cannot be one of the reserved words in the Reserved words for Redis account names section.
• account_password - (Optional, Sensitive) The password of the account. The password must be 8 to 32 characters in length. It must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Special characters include !@ # $ % ^ & * ( ) _ + - =. You have to specify one of account_password and kms_encrypted_password fields.
• description - (Optional) Database description. It cannot begin with https://. It must start with a Chinese character or English letter. It can include Chinese and English characters, underlines (_), hyphens (-), and numbers. The length may be 2-256 characters.
• instance_id - (Required, ForceNew) The Id of instance in which account belongs (The engine version of instance must be 4.0 or 4.0+).
• kms_encrypted_password - (Optional) An KMS encrypts password used to a KVStore account. If the account_password is filled in, this field will be ignored.
• kms_encryption_context - (Optional) An KMS encryption context used to decrypt kms_encrypted_password before creating or updating a KVStore account with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
• account_type - (Optional, ForceNew) Privilege type of account.
  • Normal: Common privilege. Default to Normal.
• account_privilege - (Optional) The privilege of account access database. Default value: RoleReadWrite
  • RoleReadOnly: This value is only for Redis and Memcache
  • RoleReadWrite: This value is only for Redis and Memcache

Attributes Reference

The following attributes are exported:

• id - The resource ID of Account. The value is formatted <instance_id>:<account_name>.
• status - The status of KVStore Account.

Timeouts

-> NOTE: Available in 1.102.0+.

The timeouts block allows you to specify timeouts for certain actions:

• create - (Defaults to 6 mins) Used when create the Account.
• update - (Defaults to 6 mins) Used when update the Account.

Import

KVStore account can be imported using the id, e.g.

$ terraform import alicloud_kvstore_account.example <instance_id>:<account_name>