From 287127b90a51822b803d73bf837d14f2250b0bf7 Mon Sep 17 00:00:00 2001 From: wangzepeng666 Date: Wed, 20 Sep 2023 09:54:45 +0800 Subject: [PATCH] docs(GaussDB): fix docs issues --- .../gaussdb_cassandra_instances.md | 20 +++++++++++++------ docs/resources/gaussdb_cassandra_instance.md | 14 ++++++++----- docs/resources/gaussdb_influx_instance.md | 12 +++++++---- 3 files changed, 31 insertions(+), 15 deletions(-) diff --git a/docs/data-sources/gaussdb_cassandra_instances.md b/docs/data-sources/gaussdb_cassandra_instances.md index cd541d9c..4ca25e08 100644 --- a/docs/data-sources/gaussdb_cassandra_instances.md +++ b/docs/data-sources/gaussdb_cassandra_instances.md @@ -25,16 +25,19 @@ 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,26 +68,31 @@ 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](#guassdb_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. diff --git a/docs/resources/gaussdb_cassandra_instance.md b/docs/resources/gaussdb_cassandra_instance.md index 6bb58d3b..8f2f0d21 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 @@ -131,12 +134,13 @@ In addition to all arguments above, the following attributes are exported: * `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. diff --git a/docs/resources/gaussdb_influx_instance.md b/docs/resources/gaussdb_influx_instance.md index d724c90d..3a712e0b 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](#guassdb_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 @@ -132,11 +135,12 @@ In addition to all arguments above, the following attributes are exported: * `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: * `id` - Indicates the node ID.