Provides a PolarDB endpoint resource to manage custom endpoint of PolarDB cluster.
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_endpoint" "default" {
db_cluster_id = alicloud_polardb_cluster.default.id
endpoint_type = "Custom"
}
The following arguments are supported:
db_cluster_id
- (Required, ForceNew) The Id of cluster that can run database.endpoint_type
- (Optional, ForceNew) Type of the endpoint. Before v1.121.0, it only can be Custom
. since v1.121.0, Custom
, Cluster
, Primary
are valid, default to Custom
. However when creating a new endpoint, it also only can be Custom
. read_write_mode
- (Optional) Read or write mode. Valid values are ReadWrite
, ReadOnly
. When creating a new custom endpoint, default to ReadOnly
.nodes
- (Optional) Node id list for endpoint configuration. At least 2 nodes if specified, or if the cluster has more than 3 nodes, read-only endpoint is allowed to mount only one node. Default is all nodes.auto_add_new_nodes
- (Optional) Whether the new node automatically joins the default cluster address. Valid values are Enable
, Disable
. When creating a new custom endpoint, default to Disable
.endpoint_config
- (Optional) The advanced settings of the endpoint of Apsara PolarDB clusters are in JSON format. Including the settings of consistency level, transaction splitting, connection pool, and offload reads from primary node. For more details, see the description of EndpointConfig in the Request parameters table for details.ssl_enabled
- (Optional, Available since v1.121.0) Specifies how to modify the SSL encryption status. Valid values: Disable
, Enable
, Update
.net_type
- (Optional, Available since v1.121.0) The network type of the endpoint address.ssl_auto_rotate
- (Optional, Available since v1.132.0) Specifies whether automatic rotation of SSL certificates is enabled. Valid values: Enable
,Disable
. ssl_certificate_url
- (Available since v1.132.0) Specifies SSL certificate download link. db_endpoint_description
- (Optional, Available since v1.201.0) The name of the endpoint.connection_prefix
- (Optional, Available since v1.217.0) 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, Available since v1.217.0) Port of the specified endpoint. Valid values: 3000 to 5999.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>
.ssl_connection_string
- (Available since v1.121.0) The SSL connection string.ssl_expire_time
- (Available since v1.121.0) 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
- (Available since v1.161.0) The ID of the cluster endpoint.PolarDB endpoint can be imported using the id, e.g.
$ terraform import alicloud_polardb_endpoint.example pc-abc123456:pe-abc123456