Update tox.ini && conf.py file

Performed-by: gitea/infra/otc-metadata/tools/generate_doc_confpy.py

api-ref/source/api/index.rst

@@ -0,0 +1,24 @@
+:original_name: gaussdb_04_0000.html
+
+.. _gaussdb_04_0000:
+
+API
+===
+
+-  :ref:`Querying Version Information About a DB Engine <gaussdb_04_0001>`
+-  :ref:`Querying Database Specifications <gaussdb_04_0002>`
+-  :ref:`Managing DB Instances <gaussdb_04_0003>`
+-  :ref:`Managing Parameter Templates <gaussdb_04_0008>`
+-  :ref:`Managing Quotas <gaussdb_04_0010>`
+-  :ref:`Obtaining Task Information <gaussdb_04_0014>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   querying_version_information_about_a_db_engine
+   querying_database_specifications
+   managing_db_instances/index
+   managing_parameter_templates/index
+   managing_quotas/index
+   obtaining_task_information

api-ref/source/api/managing_db_instances/deleting_a_db_instance.rst

@@ -0,0 +1,75 @@
+:original_name: gaussdb_04_0007.html
+
+.. _gaussdb_04_0007:
+
+Deleting a DB Instance
+======================
+
+Function
+--------
+
+This API is used to delete a DB instance.
+
+-  Learn how to :ref:`authorize and authenticate <gaussdb_03_0001>` this API before using it.
+-  Before calling this API, obtain the required :ref:`region and endpoint <gaussdb_00_0003>`.
+
+URI
+---
+
+-  URI format
+
+   DELETE https://{*Endpoint*}/mysql/v3/{project_id}/instances/{instance_id}
+
+-  Example
+
+   DELETE https://{*Endpoint*}/mysql/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01
+
+-  Parameter description
+
+   .. table:: **Table 1** Parameter description
+
+      +-----------------------+-----------------------+----------------------------------------------------------------------------+
+      | Name                  | Mandatory             | Description                                                                |
+      +=======================+=======================+============================================================================+
+      | project_id            | Yes                   | Project ID of a tenant in a region.                                        |
+      |                       |                       |                                                                            |
+      |                       |                       | To obtain this value, see :ref:`Obtaining a Project ID <gaussdb_10_0004>`. |
+      +-----------------------+-----------------------+----------------------------------------------------------------------------+
+      | instance_id           | Yes                   | DB instance ID, which is compliant with the UUID format.                   |
+      +-----------------------+-----------------------+----------------------------------------------------------------------------+
+
+Request
+-------
+
+None.
+
+Response
+--------
+
+-  Normal response
+
+   .. table:: **Table 2** Parameter description
+
+      ====== ====== ====================================
+      Name   Type   Description
+      ====== ====== ====================================
+      job_id String ID of the DB instance deletion task.
+      ====== ====== ====================================
+
+-  Example normal response
+
+   .. code-block:: text
+
+      {
+          "job_id": "dff1d289-4d03-4942-8b9f-463ea07c000d"
+      }
+
+Status Code
+-----------
+
+For details, see :ref:`Status Codes <gaussdb_10_0002>`.
+
+Error Code
+----------
+
+For details, see :ref:`Error Codes <gaussdb_10_0003>`.

api-ref/source/api/managing_db_instances/index.rst

@@ -0,0 +1,20 @@
+:original_name: gaussdb_04_0003.html
+
+.. _gaussdb_04_0003:
+
+Managing DB Instances
+=====================
+
+-  :ref:`Creating a DB instance <gaussdb_04_0004>`
+-  :ref:`Querying a DB Instance List <gaussdb_04_0005>`
+-  :ref:`Querying Details of a DB Instance <gaussdb_04_0006>`
+-  :ref:`Deleting a DB Instance <gaussdb_04_0007>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   creating_a_db_instance
+   querying_a_db_instance_list
+   querying_details_of_a_db_instance
+   deleting_a_db_instance

api-ref/source/api/managing_parameter_templates/index.rst

@@ -0,0 +1,14 @@
+:original_name: gaussdb_04_0008.html
+
+.. _gaussdb_04_0008:
+
+Managing Parameter Templates
+============================
+
+-  :ref:`Querying a Parameter Template <gaussdb_04_0009>`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden: 
+
+   querying_a_parameter_template

api-ref/source/api/managing_quotas/index.rst

@@ -2,13 +2,12 @@
 
 .. _gaussdb_04_0010:
 
-Quota Management
-================
+Managing Quotas
+===============
 
 -  :ref:`Querying Resource Quotas <gaussdb_04_0011>`
 -  :ref:`Configuring Resource Quotas <gaussdb_04_0012>`
 -  :ref:`Modifying Resource Quotas <gaussdb_04_0013>`
--  :ref:`Querying the DB Instance Quotas of a Tenant <showgaussmysqlprojectquotas>`
 
 .. toctree::
    :maxdepth: 1
@@ -17,4 +16,3 @@ Quota Management
    querying_resource_quotas
    configuring_resource_quotas
    modifying_resource_quotas
-   querying_the_db_instance_quotas_of_a_tenant

api-ref/source/api/querying_version_information_about_a_db_engine.rst

@@ -0,0 +1,92 @@
+:original_name: gaussdb_04_0001.html
+
+.. _gaussdb_04_0001:
+
+Querying Version Information About a DB Engine
+==============================================
+
+Function
+--------
+
+This API is used to query the DB version information of a specified DB engine.
+
+-  Learn how to :ref:`authorize and authenticate <gaussdb_03_0001>` this API before using it.
+-  Before calling this API, obtain the required :ref:`region and endpoint <gaussdb_00_0003>`.
+
+URI
+---
+
+-  URI format
+
+   GET https://{*Endpoint*}/mysql/v3/{project_id}/datastores/{database_name}
+
+-  Example
+
+   GET https://{*Endpoint*}/mysql/v3/619d3e78f61b4be68bc5aa0b59edcf7b/datastores/gaussdb-mysql
+
+-  Parameter description
+
+   .. table:: **Table 1** Parameter description
+
+      +-----------------------+-----------------------+-----------------------------------------------------------------------------------+
+      | Name                  | Mandatory             | Description                                                                       |
+      +=======================+=======================+===================================================================================+
+      | project_id            | Yes                   | Project ID of a tenant in a region.                                               |
+      |                       |                       |                                                                                   |
+      |                       |                       | To obtain this value, see :ref:`Obtaining a Project ID <gaussdb_10_0004>`.        |
+      +-----------------------+-----------------------+-----------------------------------------------------------------------------------+
+      | database_name         | Yes                   | DB engine. The following DB engine is supported (case-insensitive): gaussdb-mysql |
+      +-----------------------+-----------------------+-----------------------------------------------------------------------------------+
+
+Request
+-------
+
+None.
+
+Response
+--------
+
+-  Normal response
+
+   .. table:: **Table 2** Parameter description
+
+      +-----------------------+-----------------------+-------------------------------------------------------------------+
+      | Name                  | Type                  | Description                                                       |
+      +=======================+=======================+===================================================================+
+      | datastores            | Array of objects      | DB version list.                                                  |
+      |                       |                       |                                                                   |
+      |                       |                       | For details, see :ref:`Table 3 <gaussdb_04_0001__table66531170>`. |
+      +-----------------------+-----------------------+-------------------------------------------------------------------+
+
+   .. _gaussdb_04_0001__table66531170:
+
+   .. table:: **Table 3** datastores field data structure description
+
+      +------+--------+-------------------------------------------------------------------------------+
+      | Name | Type   | Description                                                                   |
+      +======+========+===============================================================================+
+      | id   | String | DB version ID. Its value is unique.                                           |
+      +------+--------+-------------------------------------------------------------------------------+
+      | name | String | DB version number. Only the major version number with two digits is returned. |
+      +------+--------+-------------------------------------------------------------------------------+
+
+-  Example normal response
+
+   .. code-block:: text
+
+      {
+               "datastores": [{
+                         "id": "87620726-6802-46c0-9028-a8785e1f1921",
+                         "name": "8.0"
+               }]
+      }
+
+Status Code
+-----------
+
+For details, see :ref:`Status Codes <gaussdb_10_0002>`.
+
+Error Code
+----------
+
+For details, see :ref:`Error Codes <gaussdb_10_0003>`.

api-ref/source/api_overview.rst

@@ -7,26 +7,18 @@ API Overview
 
 With GaussDB(for MySQL) APIs, you can query, set, and modify resource quotas.
 
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
 | Type                          | Description                                                                                                                                   |
-+===============================+====================================================================================================================================================================================================================+
++===============================+===============================================================================================================================================+
 | DB engine version query       | Query the DB version information of a specified DB engine.                                                                                    |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
 | DB specifications query       | Query the DB specifications of a specified DB engine version.                                                                                 |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| DB instance management        | Create instances, query instance lists, query instance details, delete instances, create read replicas, delete read replicas, change instance names, reset database passwords, and change instance specifications. |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| Backup management             | Create manual backups, query backup lists, query automated backup policies, and modify automated backup policies.                                                                                                  |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
+| DB instance management        | Create DB instances, query DB instance lists, query DB instance details, delete DB instances, create read replicas, and delete read replicas. |
++-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
 | Parameter template management | Query parameter templates.                                                                                                                    |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
 | Quota management              | Query, set, and modify resource quotas.                                                                                                       |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| Database proxy                | Query database proxy information and specifications, and enable or disable database proxy.                                                                                                                         |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| Log management                | Obtain log information, including database error logs and slow logs.                                                                                                                                               |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| Tag management                | Manage tags, including adding tags in batches, deleting tags in batches, and querying project tags.                                                                                                                |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| Task center                   | Obtain task information about the task center.                                                                                                                                                                     |
-+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
+| Task information query        | Obtain task information about the task center.                                                                                                |
++-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+

api-ref/source/apis_recommended/backup_management/index.rst

@@ -1,22 +0,0 @@
-:original_name: gaussdb_06_0002.html
-
-.. _gaussdb_06_0002:
-
-Backup Management
-=================
-
--  :ref:`Creating a Manual Backup <gaussdb_06_0003>`
--  :ref:`Querying Backups <gaussdb_06_0004>`
--  :ref:`Querying an Automated Backup Policy <gaussdb_06_0005>`
--  :ref:`Modifying an Automated Backup Policy <gaussdb_06_0006>`
--  :ref:`Deleting a Manual Backup <deletegaussmysqlbackup>`
-
-.. toctree::
-   :maxdepth: 1
-   :hidden: 
-
-   creating_a_manual_backup
-   querying_backups
-   querying_an_automated_backup_policy
-   modifying_an_automated_backup_policy
-   deleting_a_manual_backup

api-ref/source/apis_recommended/database_proxy/index.rst

@@ -1,26 +0,0 @@
-:original_name: topic_300000006.html
-
-.. _topic_300000006:
-
-Database Proxy
-==============
-
--  :ref:`Enabling Database Proxy <creategaussmysqlproxy>`
--  :ref:`Disabling Database Proxy <deletegaussmysqlproxy>`
--  :ref:`Querying Database Proxy Instances <showgaussmysqlproxylist>`
--  :ref:`Querying Database Proxy Specifications <showgaussmysqlproxyflavors>`
--  :ref:`Adding Database Proxy Nodes <expandgaussmysqlproxy>`
--  :ref:`Changing Specifications of a Database Proxy Instance <changegaussmysqlproxyspecification>`
--  :ref:`Assigning Read Weights <setgaussmysqlproxyweight>`
-
-.. toctree::
-   :maxdepth: 1
-   :hidden: 
-
-   enabling_database_proxy
-   disabling_database_proxy
-   querying_database_proxy_instances
-   querying_database_proxy_specifications
-   adding_database_proxy_nodes
-   changing_specifications_of_a_database_proxy_instance
-   assigning_read_weights

api-ref/source/apis_recommended/index.rst

@@ -1,32 +0,0 @@
-:original_name: gaussdb_04_0000.html
-
-.. _gaussdb_04_0000:
-
-APIs (Recommended)
-==================
-
--  :ref:`Querying Version Information About a DB Engine <gaussdb_04_0001>`
--  :ref:`Querying Database Specifications <gaussdb_04_0002>`
--  :ref:`Managing DB Instances <gaussdb_04_0003>`
--  :ref:`Backup Management <gaussdb_06_0002>`
--  :ref:`Parameter Template Management <gaussdb_04_0008>`
--  :ref:`Quota Management <gaussdb_04_0010>`
--  :ref:`Database Proxy <topic_300000006>`
--  :ref:`Log Management <topic_300000007>`
--  :ref:`Tag Management <topic_300000009>`
--  :ref:`Task Center <gaussdb_04_0014>`
-
-.. toctree::
-   :maxdepth: 1
-   :hidden: 
-
-   querying_version_information_about_a_db_engine
-   querying_database_specifications
-   managing_db_instances/index
-   backup_management/index
-   parameter_template_management/index
-   quota_management/index
-   database_proxy/index
-   log_management/index
-   tag_management/index
-   task_center/index

api-ref/source/apis_recommended/log_management/index.rst

@@ -1,16 +0,0 @@
-:original_name: topic_300000007.html
-
-.. _topic_300000007:
-
-Log Management
-==============
-
--  :ref:`Querying Database Error Logs <listgaussmysqlerrorlog>`
--  :ref:`Querying Database Slow Logs <listgaussmysqlslowlog>`
-
-.. toctree::
-   :maxdepth: 1
-   :hidden: 
-
-   querying_database_error_logs
-   querying_database_slow_logs

api-ref/source/apis_recommended/managing_db_instances/index.rst

@@ -1,34 +0,0 @@
-:original_name: gaussdb_04_0003.html
-
-.. _gaussdb_04_0003:
-
-Managing DB Instances
-=====================
-
--  :ref:`Creating a DB Instance <gaussdb_04_0004>`
--  :ref:`Querying DB Instances <gaussdb_04_0005>`
--  :ref:`Deleting a DB Instance <gaussdb_04_0007>`
--  :ref:`Querying Details of a DB Instance <gaussdb_04_0006>`
--  :ref:`Creating a Read Replica <gaussdb_04_0015>`
--  :ref:`Deleting a Read Replica <gaussdb_04_0016>`
--  :ref:`Changing a DB Instance Name <gaussdb_04_0018>`
--  :ref:`Resetting a Database Password <gaussdb_04_0019>`
--  :ref:`Changing DB Instance Specifications <gaussdb_04_0020>`
--  :ref:`Changing the Collection Period of Monitoring by Seconds <updateinstancemonitor>`
--  :ref:`Querying the Collection Period of Monitoring by Seconds <showinstancemonitorextend>`
-
-.. toctree::
-   :maxdepth: 1
-   :hidden: 
-
-   creating_a_db_instance
-   querying_db_instances
-   deleting_a_db_instance
-   querying_details_of_a_db_instance
-   creating_a_read_replica
-   deleting_a_read_replica
-   changing_a_db_instance_name
-   resetting_a_database_password
-   changing_db_instance_specifications
-   changing_the_collection_period_of_monitoring_by_seconds
-   querying_the_collection_period_of_monitoring_by_seconds