Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Relational Database Service/ Referencia de la API/ API v3 (recomendado)/ Gestión de bases de datos y cuentas (MySQL)/ Consulta de bases de datos

Actualización más reciente 2024-06-06 GMT+08:00

Ver PDF

Consulta de bases de datos

Función

Esta API se utiliza para consultar bases de datos en una instancia de base de datos especificada.

Antes de invocar a una API, debe entender la API de Autenticación.

Restricciones

Las bases de datos no se pueden consultar cuando la instancia de base de datos está en estado anormal o congelado.
No se puede consultar la lista de réplicas de lectura de la base de datos.

URI

Formato de URI
GET /v3/{project_id}/instances/{instance_id}/database/detail?page={page}&limit={limit}

Descripción de parámetro

**Tabla 1** Descripción de parámetro
Nombre	Obligatorio	Descripción
project_id	Sí	Especifica el ID de proyecto de un tenant en una región. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
instance_id	Sí	Especifica el ID de instancia de base de datos.
page	Sí	Especifica el número de página. El valor comienza desde 1.
limit	Sí	Especifica el número de registros de cada página. El valor varía de 1 (inclusivo) a 100 (inclusivo).

Solicitud

Parámetros de solicitud
Ninguna

Ejemplo de URI
GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/database/detail?page=1&limit=10

Respuesta

Respuesta normal

**Tabla 2** Descripción de parámetro
Nombre	Tipo	Descripción
databases	Array of objects	Cada elemento de la lista indica una base de datos. Para obtener más información, véase Tabla 3.
total_count	Integer	Indica el número total de bases de datos.

**Tabla 3** descripción de la estructura del elemento de bases de datos
Nombre	Tipo	Descripción
name	String	Indica el nombre de la base de datos.
character_set	String	Indica el conjunto de caracteres utilizado por la base de datos, como utf8, gbk y ascii.
comment	String	Especifica las observaciones de la base de datos. NOTA: Si no especificó este parámetro durante la creación de una instancia, este parámetro no se puede consultar.

Ejemplo de respuesta normal

{
    "databases": [
        {
            "name": "rds-test",
            "character_set": "utf8",
            "comment":"comment"
        },
        {
            "name": "testdb1",
            "character_set": "utf8",
            "comment":"comment"
        },
        {
            "name": "tt",
            "character_set": "utf8",
            "comment":"comment"
        }
    ],
    "total_count": 3
}