All Products
Search

This Product

    ApsaraDB RDS:Use Terraform to manage an account of an ApsaraDB RDS for PostgreSQL instance

    Document Center

    ApsaraDB RDS:Use Terraform to manage an account of an ApsaraDB RDS for PostgreSQL instance

    Last Updated:Jan 26, 2025

    This topic describes how to use Terraform to create, modify, query, and delete an account for an ApsaraDB RDS for PostgreSQL instance.

    Note

    You can run the sample code in this topic with a few clicks. For more information, visit Terraform Explorer.

    Prerequisites

    • An RDS instance is created. For more information, see Create an RDS instance.

    • The RDS instance is in the Running state. You can use one of the following methods to check whether the RDS instance is in the Running state:

      • Check the value of the status parameter by following the instructions provided in Query instance details. If the value is Running, the RDS instance is in the Running state.

      • Log on to the ApsaraDB RDS console, switch to the required region, find the RDS instance, and then check the instance status.

    • An Alibaba Cloud account has all permissions on resources within the account. If an Alibaba Cloud account is leaked, the resources are exposed to major risks. We recommend that you use a Resource Access Management (RAM) user and create an AccessKey pair for the RAM user. For more information, see Create a RAM user and Create an AccessKey pair.

    • You must use RAM to manage access permissions on cloud resources in an efficient manner. This helps meet the requirements for multi-user collaboration and allows you to grant permissions to users based on the principle of least privilege (PoLP) to prevent security vulnerabilities caused by excessive permissions. For more information, see Grant permissions to RAM users. 

      {
    "Version": "1",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "vpc:DescribeVpcAttribute",
                "vpc:DescribeRouteTableList",
                "vpc:DescribeVSwitchAttributes",
                "vpc:DeleteVpc",
                "vpc:DeleteVSwitch",
                "vpc:CreateVpc",
                "vpc:CreateVSwitch"
            ],
            "Resource": "*"
        },
        {
            "Action": "rds:*",
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": "dbs:*",
            "Resource": "acs:rds:*:*:*",
            "Effect": "Allow"
        },
        {
            "Action": "hdm:*",
            "Resource": "acs:rds:*:*:*",
            "Effect": "Allow"
        },
        {
            "Action": "dms:LoginDatabase",
            "Resource": "acs:rds:*:*:*",
            "Effect": "Allow"
        },
        {
            "Effect": "Allow",
            "Action": "ram:CreateServiceLinkedRole",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "ram:ServiceName": [
                        "backupencryption.rds.aliyuncs.com"
                    ]
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "bss:ModifyAgreementRecord",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bss:DescribeOrderList",
                "bss:DescribeOrderDetail",
                "bss:PayOrder",
                "bss:CancelOrder"
            ],
            "Resource": "*"
        }
    ]
}

    • Prepare the Terraform environment. You can use one of the following methods to use Terraform:

      • Use Terraform in Terraform Explorer: Alibaba Cloud provides Terraform Explorer, an online runtime environment for Terraform. You can use Terraform after you log on to Terraform Explorer without the need to install Terraform. For more information, see Use Terraform in Terraform Explorer. This method is suitable for scenarios in which you want to use and debug Terraform in a fast and convenient manner at no additional cost.

      • Use Terraform in Cloud Shell: Terraform is preinstalled in Cloud Shell and identity credentials are configured. You can directly run Terraform commands in Cloud Shell. For more information, see Use Terraform in Cloud Shell. This method is suitable for scenarios in which you want to use and debug Terraform in a fast and convenient manner at low cost.

      • Install and configure Terraform on your on-premises machine: This method is suitable for scenarios in which network conditions are poor or a custom development environment is used. For more information, see Install and configure Terraform in the local PC.

    Resources

    Note

    You are charged for specific resources. If you no longer require the resources, you must release or unsubscribe from the resources at the earliest opportunity.

    Create an account

    This section describes how to create an account named tf_account_test.

    1. Create a working directory and a configuration file named main.tf in the directory. Copy the following code to the main.tf configuration file:

      • Create the required resources. 

        variable "region" {
  default = "cn-hangzhou"
}

provider "alicloud" {
  region = var.region
}

variable "zone_id" {
  default = "cn-hangzhou-b"
}

variable "instance_type" {
  default = "pg.n2.2c.2m"
}

# Create a VPC.
resource "alicloud_vpc" "main" {
  vpc_name   = "alicloud"
  cidr_block = "172.16.0.0/16"
}

# Create a vSwitch.
resource "alicloud_vswitch" "main" {
  vpc_id     = alicloud_vpc.main.id
  cidr_block = "172.16.192.0/20"
  zone_id    = var.zone_id
}

# Create an RDS instance.
resource "alicloud_db_instance" "instance" {
  engine               = "PostgreSQL"
  engine_version       = "13.0"
  instance_type        = var.instance_type
  instance_storage     = "30"
  instance_charge_type = "Postpaid"
  vswitch_id           = alicloud_vswitch.main.id
}

      • In the main.tf file, add the resource "alicloud_db_account" "account" {} configuration item. 

        ...
resource "alicloud_db_account" "account" {
  db_instance_id   = alicloud_db_instance.instance.id
  account_name     = "tf_account_test"
  account_password = "!Test@123456"
}

    2. Run the following command to initialize the runtime environment for Terraform: 

      terraform init

      If the following information is returned, Terraform is initialized. 

      Initializing the backend...

Initializing provider plugins...
- Checking for available provider plugins...
- Downloading plugin for provider "alicloud" (hashicorp/alicloud) 1.90.1...
...

You may now begin working with Terraform. Try running "terraform plan" to see
any changes that are required for your infrastructure. All Terraform commands
should now work.

If you ever set or change modules or backend configuration for Terraform,
rerun this command to reinitialize your working directory. If you forget, other
commands will detect it and remind you to do so if necessary.

    3. Create an execution plan and preview the changes. 

      terraform plan

    4. Run the following command to create the resources: 

      terraform apply

      During the execution, enter yes as prompted and press the Enter key. Wait until the command is successfully executed. If the following information appears, the operation is successful: 

      alicloud_db_account.account: Creating...
alicloud_db_account.account: Creation complete after 6s [id=pgm-****:tf_account_test]

Apply complete!  Resources: 1 added, 0 changed, 0 destroyed.

    5. Verify the result.

      Run the terraform show command

      Run the following command to query account information:

      terraform show
      # alicloud_db_account.account:
resource "alicloud_db_account" "account" {
    account_name     = "tf_account_test"
    account_password = (sensitive value)
    account_type     = "Normal"
    db_instance_id   = "pgm-****"
    id               = "pgm-****:tf_account_test"
    instance_id      = "pgm-****)"
    name             = "tf_account_test"
    status           = "Available"
    type             = "Normal"
}
# alicloud_db_instance.instance:
resource "alicloud_db_instance" "instance" {
    client_ca_enabled          = 0
    client_crl_enabled         = 0
    connection_string          = "pgm-****.pg.rds.aliyuncs.com"
    connection_string_prefix   = "pgm-****"
    db_instance_storage_type   = "cloud_essd"
    db_time_zone               = "Asia/Shanghai"
    deletion_protection        = false
    engine                     = "PostgreSQL"
    engine_version             = "13.0"
    force_restart              = false
    ha_config                  = "Auto"
    id                         = "pgm-****"
    instance_charge_type       = "Postpaid"
    instance_name              = "terraformtest"
    instance_storage           = 50
    instance_type              = "pg.n2.2c.2m"
    maintain_time              = "05:00Z-06:00Z"
    monitoring_period          = 300
    period                     = 0
    port                       = "5432"
    private_ip_address         = "172.16.XX.XX"
    resource_group_id          = "rg-****"
    security_group_ids         = []
    security_ip_mode           = "normal"
    security_ips               = [
        "127.0.0.1",
    ]
    sql_collector_config_value = 30
    sql_collector_status       = "Disabled"
    storage_auto_scale         = "Enable"
    storage_threshold          = 30
    storage_upper_bound        = 100
    target_minor_version       = "rds_postgres_1300_20220730"
    tcp_connection_type        = "SHORT"
    vpc_id                     = "vpc-****"
    vswitch_id                 = "vsw-****"
    zone_id                    = "cn-hangzhou-j"
}

      Log on to the ApsaraDB RDS console

      Log on to the ApsaraDB RDS console to view account information.账号信息

    Change the password of an account

    This section describes how to change the password of the tf_account_test account to Test123@rds.

    1. In the main.tf file, modify the account_password field in the resource "alicloud_db_account" "account" configuration item based on the following code snippet: 

      ...
resource "alicloud_db_account" "account" {
...
  account_password    = "Test123@rds"
}

    2. Run the terraform apply command.

      If the following information appears, confirm the information and enter yes to change the password: 

      alicloud_vpc.main: Refreshing state... [id=vpc-****]
alicloud_vswitch.main: Refreshing state... [id=vsw-****]
alicloud_db_instance.instance: Refreshing state... [id=pgm-****]
alicloud_db_account.account: Refreshing state... [id=pgm-****:tf_account_test]

Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols:
  ~ update in-place

Terraform will perform the following actions:

  # alicloud_db_account.account will be updated in-place
  ~ resource "alicloud_db_account" "account" {
      ~ account_password = (sensitive value)
        id               = "pgm-****:tf_account_test"
        name             = "tf_account_test"
        # (6 unchanged attributes hidden)
    }

Plan: 0 to add, 1 to change, 0 to destroy.

Do you want to perform these actions?
  Terraform will perform the actions described above.
  Only 'yes' will be accepted to approve.

  Enter a value:

      If the following logs appear, the operation is successful: 

      alicloud_db_account.account: Modifying... [id=pgm-****:tf_account_test]
alicloud_db_account.account: Modifications complete after 6s [id=pgm-****:tf_account_test]

Apply complete!  Resources: 0 added, 1 changed, 0 destroyed.

    3. Use the new password to connect to the database to verify that the new password takes effect.

    Query an account

    1. In the main.tf file, add the following content: 

      ...
data "alicloud_rds_accounts" "queryaccounts" {
  db_instance_id = alicloud_db_instance.instance.id
}

    2. Run the terraform apply command to query an account that is created for your RDS instance.

      If the following logs appear, the query is successful: 

      alicloud_vpc.main: Refreshing state... [id=vpc-****]
alicloud_vswitch.main: Refreshing state... [id=vsw-****]
alicloud_db_instance.instance: Refreshing state... [id=pgm-****]
data.alicloud_rds_accounts.queryaccounts: Reading...
alicloud_db_account.account: Refreshing state... [id=pgm-****:tf_account_test]
data.alicloud_rds_accounts.queryaccounts: Read complete after 1s [id=137568****]

No changes. Your infrastructure matches the configuration.

Terraform has compared your real infrastructure against your configuration and found no differences, so no changes are needed.

Apply complete!  Resources: 0 added, 0 changed, 0 destroyed.

    3. Verify the result.

      Run the following command to view the result:

      terraform show
      # data.alicloud_rds_accounts.queryaccounts:
data "alicloud_rds_accounts" "queryaccounts" {
    accounts       = [
        {
            account_description = ""
            account_name        = "tf_account_test"
            account_type        = "Normal"
            database_privileges = []
            id                  = "tf_account_test"
            priv_exceeded       = ""
            status              = "Available"
        },
    ]
    db_instance_id = "pgm-****"
    id             = "137568****"
    ids            = [
        "tf_account_test",
    ]
    names          = [
        "tf_account_test",
    ]
}

    Delete an account

    This section describes how to delete an account named tf_account_test.

    1. In the main.tf file, delete the resource "alicloud_db_account" "account" configuration item. In this example, the following information is deleted:

      ...
resource "alicloud_db_account" "account" {
  db_instance_id      = alicloud_db_instance.instance.id
  account_name        = "tf_account_test"
  account_password    = "Test123@rds"
}

    2. Run the terraform apply command.

      If the following information appears, confirm the information and enter yes to delete the account: 

      alicloud_db_account.account: Refreshing state... [id=pgm-****:tf_account_test]
alicloud_vpc.main: Refreshing state... [id=vpc-****]
alicloud_vswitch.main: Refreshing state... [id=vsw-****]
alicloud_db_instance.instance: Refreshing state... [id=pgm-****]

Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols:
  - destroy

Terraform will perform the following actions:

  # alicloud_db_account.account will be destroyed
  # (because alicloud_db_account.account is not in configuration)
  - resource "alicloud_db_account" "account" {
      - account_name     = "tf_account_test" -> null
      - account_password = (sensitive value)
      - account_type     = "Normal" -> null
      - db_instance_id   = "pgm-****" -> null
      - id               = "pgm-****:tf_account_test" -> null
      - instance_id      = "pgm-****" -> null
      - name             = "tf_account_test" -> null
      - status           = "Available" -> null
      - type             = "Normal" -> null
    }

Plan: 0 to add, 0 to change, 1 to destroy.

Do you want to perform these actions?
  Terraform will perform the actions described above.
  Only 'yes' will be accepted to approve.

  Enter a value:

      If the following logs appear, the operation is successful: 

      alicloud_db_account.account: Destroying... [id=pgm-****:tf_account_test]
alicloud_db_account.account: Destruction complete after 6s

Apply complete!  Resources: 0 added, 0 changed, 1 destroyed.

    3. Verify the result.

      Run the terraform show command

      Run the following command to view the result:

      terraform show
      # alicloud_db_instance.instance:
resource "alicloud_db_instance" "instance" {
    client_ca_enabled          = 0
    client_crl_enabled         = 0
    connection_string          = "pgm-****.pg.rds.aliyuncs.com"
    connection_string_prefix   = "pgm-****"
    db_instance_storage_type   = "cloud_essd"
    db_time_zone               = "Asia/Shanghai"
    deletion_protection        = false
    engine                     = "PostgreSQL"
    engine_version             = "13.0"
    force_restart              = false
    ha_config                  = "Auto"
    id                         = "pgm-****"
    instance_charge_type       = "Postpaid"
    instance_name              = "terraformtest"
    instance_storage           = 50
    instance_type              = "pg.n2.2c.2m"
    maintain_time              = "05:00Z-06:00Z"
    monitoring_period          = 300
    period                     = 0
    port                       = "5432"
    private_ip_address         = "172.16.XX.XX"
    resource_group_id          = "rg-****"
    security_group_ids         = []
    security_ip_mode           = "normal"
    security_ips               = [
        "127.0.0.1",
    ]
    sql_collector_config_value = 30
    sql_collector_status       = "Disabled"
    storage_auto_scale         = "Enable"
    storage_threshold          = 30
    storage_upper_bound        = 100
    target_minor_version       = "rds_postgres_1300_20220730"
    tcp_connection_type        = "SHORT"
    vpc_id                     = "vpc-****"
    vswitch_id                 = "vsw-****"
    zone_id                    = "cn-hangzhou-j"

    pg_hba_conf {
        address     = "127.0.0.1"
        database    = "all"
        method      = "md5"
        priority_id = 1
        type        = "host"
        user        = "all"
    }
}

      Log on to the ApsaraDB RDS console

      Log on to the ApsaraDB RDS console to check whether the account is deleted.没有账号

    Clear resources

    If you no longer require the preceding resources that are created or managed by using Terraform, run the following command to release the resources. For more information about the terraform destroy command, see Common commands. 

    terraform destroy

    Complete sample code

    Note

    You can run the sample code in this topic with a few clicks. For more information, visit Terraform Explorer.

    Sample code

    variable "region" {
  default = "cn-hangzhou"
}

provider "alicloud" {
  region = var.region
}

variable "zone_id" {
  default = "cn-hangzhou-b"
}

variable "instance_type" {
  default = "pg.n2.2c.2m"
}

# Create a VPC.
resource "alicloud_vpc" "main" {
  vpc_name   = "alicloud"
  cidr_block = "172.16.0.0/16"
}

# Create a vSwitch.
resource "alicloud_vswitch" "main" {
  vpc_id     = alicloud_vpc.main.id
  cidr_block = "172.16.192.0/20"
  zone_id    = var.zone_id
}

# Create an RDS instance.
resource "alicloud_db_instance" "instance" {
  engine               = "PostgreSQL"
  engine_version       = "13.0"
  instance_type        = var.instance_type
  instance_storage     = "30"
  instance_charge_type = "Postpaid"
  vswitch_id           = alicloud_vswitch.main.id
  # If you want to use an existing VPC and vSwitch, use the following configuration:
  # vswitch_id          = "vsw-****"
  # Create multiple RDS instances that have the same configuration. The value x specifies the number of RDS instances that you want to create.
  # count               = x
}

# Create an account.
resource "alicloud_db_account" "account" {
  db_instance_id   = alicloud_db_instance.instance.id
  account_name     = "tf_account_test"
  account_password = "Test123@rds"
}

# Query an account.
data "alicloud_rds_accounts" "queryaccounts" {
  db_instance_id = alicloud_db_instance.instance.id
  depends_on = [alicloud_db_account.account]
}

    If you want to experience more examples, go to the quickstarts page and view the examples in the folder of the corresponding service.