alicloud_polardb_primary_endpoint

更新时间:

Provides a PolarDB endpoint resource to manage primary endpoint of PolarDB cluster.

-> NOTE: Available since v1.217.0

-> NOTE: The default primary endpoint can not be created or deleted manually.

Example Usage


data "alicloud_polardb_node_classes" "default" {
  db_type    = "MySQL"
  db_version = "8.0"
  pay_type   = "PostPaid"
  category   = "Normal"
}

resource "alicloud_vpc" "default" {
  vpc_name   = "terraform-example"
  cidr_block = "172.16.0.0/16"
}

resource "alicloud_vswitch" "default" {
  vpc_id       = alicloud_vpc.default.id
  cidr_block   = "172.16.0.0/24"
  zone_id      = data.alicloud_polardb_node_classes.default.classes[0].zone_id
  vswitch_name = "terraform-example"
}

resource "alicloud_polardb_cluster" "default" {
  db_type       = "MySQL"
  db_version    = "8.0"
  db_node_class = data.alicloud_polardb_node_classes.default.classes.0.supported_engines.0.available_resources.0.db_node_class
  pay_type      = "PostPaid"
  vswitch_id    = alicloud_vswitch.default.id
  description   = "terraform-example"
}

resource "alicloud_polardb_primary_endpoint" "default" {
  db_cluster_id = alicloud_polardb_cluster.default.id
}

Argument Reference

The following arguments are supported:

  • db_cluster_id - (Required, ForceNew) The Id of cluster that can run database.
  • ssl_enabled - (Optional) Specifies how to modify the SSL encryption status. Valid values: Disable, Enable, Update.
  • net_type - (Optional) The network type of the endpoint address.
  • ssl_auto_rotate - (Optional) Specifies whether automatic rotation of SSL certificates is enabled. Valid values: Enable,Disable. NOTE: For a PolarDB for MySQL cluster, this parameter is required, and only one connection string in each endpoint can enable the ssl, for other notes, see Configure SSL encryption.
    For a PolarDB for PostgreSQL cluster or a PolarDB-O cluster, this parameter is not required, by default, SSL encryption is enabled for all endpoints.
  • db_endpoint_description - (Optional) The name of the endpoint.
  • connection_prefix - (Optional) Prefix of the specified endpoint. The prefix must be 6 to 30 characters in length, and can contain lowercase letters, digits, and hyphens (-), must start with a letter and end with a digit or letter.
  • port - (Optional) Port of the specified endpoint. Valid values: 3000 to 5999.

Attributes Reference

The following attributes are exported:

  • id - The current instance connection resource ID. Composed of instance ID and connection string with format <db_cluster_id>:<db_endpoint_id>.
  • endpoint_type - Type of endpoint.
  • ssl_connection_string - The SSL connection string.
  • ssl_expire_time - The time when the SSL certificate expires. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.
  • db_endpoint_id - The ID of the cluster endpoint.
  • ssl_certificate_url - The specifies SSL certificate download link.

Import

PolarDB endpoint can be imported using the id, e.g.

$ terraform import alicloud_polardb_primary_endpoint.example pc-abc123456:pe-abc123456