From d0ba3f2e9f71501c745bb0d059ec3b5270d780d6 Mon Sep 17 00:00:00 2001 From: Zippo-Wang <852420284@qq.com> Date: Tue, 17 Oct 2023 10:11:29 +0800 Subject: [PATCH] docs(GaussDB): fix docs issues --- .../gaussdb_cassandra_instances.md | 29 +++++++++++++++---- docs/resources/gaussdb_cassandra_instance.md | 26 +++++++++++++---- docs/resources/gaussdb_influx_instance.md | 26 +++++++++++++---- 3 files changed, 65 insertions(+), 16 deletions(-) diff --git a/docs/data-sources/gaussdb_cassandra_instances.md b/docs/data-sources/gaussdb_cassandra_instances.md index cd541d9c..5876d4b4 100644 --- a/docs/data-sources/gaussdb_cassandra_instances.md +++ b/docs/data-sources/gaussdb_cassandra_instances.md @@ -25,16 +25,20 @@ data "flexibleengine_gaussdb_cassandra_instances" "this" { * `subnet_id` - (Optional, String) Specifies the network ID of a subnet. -## Attributes Reference +## Attribute Reference In addition to all arguments above, the following attributes are exported: * `id` - Indicates the ID of the data source. -* `instances` - An array of available instances. +* `instances` - An array of available instances. The [instances](#gaussdb_instances) object structure is documented + below. + The `instances` block supports: +* `id` - The id of the instance. + * `region` - The region of the instance. * `name` - Indicates the name of the instance. @@ -65,30 +69,43 @@ The `instances` block supports: * `private_ips` - Indicates the list of private IP address of the nodes. -* `datastore` - Indicates the database information. Structure is documented below. +* `datastore` - Indicates the database information. The [datastore](#gaussdb_datastore) object structure is documented + below. -* `backup_strategy` - Indicates the advanced backup policy. Structure is documented below. +* `backup_strategy` - Indicates the advanced backup policy. The [backup_strategy](#gaussdb_backup_strategy) object + structure is documented below. -* `nodes` - Indicates the instance nodes information. Structure is documented below. +* `nodes` - Indicates the instance nodes information. The [nodes](#gaussdb_nodes) object structure is documented below. * `tags` - Indicates the key/value tags of the instance. + The `datastore` block supports: * `engine` - Indicates the database engine. + * `storage_engine` - Indicates the database storage engine. + * `version` - Indicates the database version. + The `backup_strategy` block supports: * `start_time` - Indicates the backup time window. + * `keep_days` - Indicates the number of days to retain the generated -The `nodes` block contains: + +The `nodes` block supports: * `id` - Indicates the node ID. + * `name` - Indicates the node name. + * `private_ip` - Indicates the private IP address of a node. + * `status` - Indicates the node status. + * `support_reduce` - Indicates whether the node support reduce. + * `availability_zone` - Indicates the availability zone where the node resides. diff --git a/docs/resources/gaussdb_cassandra_instance.md b/docs/resources/gaussdb_cassandra_instance.md index 6bb58d3b..34c451c7 100644 --- a/docs/resources/gaussdb_cassandra_instance.md +++ b/docs/resources/gaussdb_cassandra_instance.md @@ -93,13 +93,15 @@ The following arguments are supported: * `force_import` - (Optional, Bool) If specified, try to import the instance instead of creating if the name already existed. -* `datastore` - (Optional, List, ForceNew) Specifies the database information. Structure is documented below. Changing - this parameter will create a new resource. +* `datastore` - (Optional, List, ForceNew) Specifies the database information. The [datastore](#gaussdb_datastore) + object structure is documented below. Changing this parameter will create a new resource. -* `backup_strategy` - (Optional, List) Specifies the advanced backup policy. Structure is documented below. +* `backup_strategy` - (Optional, List) Specifies the advanced backup policy. The [backup_strategy](#gaussdb_backup_strategy) + object structure is documented below. * `tags` - (Optional, Map) The key/value pairs to associate with the instance. + The `datastore` block supports: * `engine` - (Required, String, ForceNew) Specifies the database engine. Only "GeminiDB-Cassandra" is supported now. @@ -111,6 +113,7 @@ The `datastore` block supports: * `storage_engine` - (Required, String, ForceNew) Specifies the storage engine. Only "rocksDB" is supported now. Changing this parameter will create a new resource. + The `backup_strategy` block supports: * `start_time` - (Required, String) Specifies the backup time window. Automated backups will be triggered during the @@ -127,21 +130,34 @@ The `backup_strategy` block supports: In addition to all arguments above, the following attributes are exported: * `id` - Indicates the DB instance ID. + * `status` - Indicates the DB instance status. + * `port` - Indicates the database port. + * `mode` - Indicates the instance type. + * `db_user_name` - Indicates the default username. -* `nodes` - Indicates the instance nodes information. Structure is documented below. + +* `nodes` - Indicates the instance nodes information. The [nodes](#gaussdb_nodes) object structure is documented below. + * `private_ips` - Indicates the IP address list of the db. + * `lb_ip_address` - Indicates the LB IP address of the db. + * `lb_port` - Indicates the LB port of the db. -The `nodes` block contains: + +The `nodes` block supports: * `id` - Indicates the node ID. + * `name` - Indicates the node name. + * `status` - Indicates the node status. + * `support_reduce` - Indicates whether the node support reduce or not. + * `private_ip` - Indicates the private IP address of a node. ## Timeouts diff --git a/docs/resources/gaussdb_influx_instance.md b/docs/resources/gaussdb_influx_instance.md index d724c90d..f79dfaa4 100644 --- a/docs/resources/gaussdb_influx_instance.md +++ b/docs/resources/gaussdb_influx_instance.md @@ -94,13 +94,15 @@ The following arguments are supported: * `force_import` - (Optional, Bool) If specified, try to import the instance instead of creating if the name already existed. -* `datastore` - (Optional, List, ForceNew) Specifies the database information. Structure is documented below. Changing - this parameter will create a new resource. +* `datastore` - (Optional, List, ForceNew) Specifies the database information. The [datastore](#gaussdb_datastore) + object structure is documented below. Changing this parameter will create a new resource. -* `backup_strategy` - (Optional, List) Specifies the advanced backup policy. Structure is documented below. +* `backup_strategy` - (Optional, List) Specifies the advanced backup policy. The [backup_strategy](#gaussdb_backup_strategy) + object structure is documented below. * `tags` - (Optional, Map) The key/value pairs to associate with the instance. + The `datastore` block supports: * `engine` - (Required, String, ForceNew) Specifies the database engine. Only **influxdb** is supported now. @@ -112,6 +114,7 @@ The `datastore` block supports: * `storage_engine` - (Required, String, ForceNew) Specifies the storage engine. Only **rocksDB** is supported now. Changing this parameter will create a new resource. + The `backup_strategy` block supports: * `start_time` - (Required, String) Specifies the backup time window. Automated backups will be triggered during the @@ -128,21 +131,34 @@ The `backup_strategy` block supports: In addition to all arguments above, the following attributes are exported: * `id` - Indicates the DB instance ID. + * `status` - Indicates the DB instance status. + * `port` - Indicates the database port. + * `mode` - Indicates the instance type. + * `db_user_name` - Indicates the default username. -* `nodes` - Indicates the instance nodes information. Structure is documented below. + +* `nodes` - Indicates the instance nodes information. The [nodes](#gaussdb_nodes) object structure is documented below. + * `private_ips` - Indicates the IP address list of the db. + * `lb_ip_address` - Indicates the LB IP address of the db. + * `lb_port` - Indicates the LB port of the db. -The `nodes` block contains: + +The `nodes` block supports: * `id` - Indicates the node ID. + * `name` - Indicates the node name. + * `status` - Indicates the node status. + * `support_reduce` - Indicates whether the node support reduce or not. + * `private_ip` - Indicates the private IP address of a node. ## Timeouts