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 (PostgreSQL)/ 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 de una instancia de base de datos especificada.

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

Restricciones

Esta operación no se puede realizar cuando la instancia de base de datos está en el estado anormal o congelado.
No se pueden consultar los detalles acerca de las bases de datos de réplicas de lectura.

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/f569f1358436479dbcba8603c32cc4aein03/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, consulte 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.
owner	String	Indica el propietario de la base de datos.
character_set	String	Indica el juego de caracteres utilizado por la base de datos, como UTF8.
collate_set	String	Indica la intercalación de la base de datos, como en_US.UTF-8.
size	Integer	Indica el tamaño de la base de datos, en bytes.

Ejemplo de respuesta normal

{
    "databases": [
        {
            "name": "rds_test",
            "owner": "root",
            "character_set": "UTF8",
            "collate_set":"en_US.UTF-8",
            "size":10777247
        },
       {
           "name": "rds_test2",
           "owner":"root",
           "character_set": "UTF8",
           "collate_set":"en_US.UTF-8",
           "size":1055623
        },
       {
           "name": "rds_test3",
           "owner":"root",
           "character_set": "UTF8",
           "collate_set":"en_US.UTF-8",
           "size":107772488
       }
    ],
    "total_count": 3
}