Consulta de información sobre bases de datos - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación DescribeDatabases para consultar la información de las bases de datos de una instancia.

Nota

Si los parámetros de solicitud especificados no son válidos, no se devuelve información de la base de datos.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeDatabases	La operación que desea ejecutar. Establezca el valor en DescribeDatabases.
DBInstanceId	String	Sí	rm-uf6wjk5xxxxxxx	El ID de la instancia.
DBName	String	No	testDB01	El nombre de la base de datos.
DBStatus	String	No	Creating	El estado de la base de datos. Valores válidos: Creating Running Deleting
PageSize	Integer	No	30	El número de entradas por página. Valores válidos: 30 50 100 Valor predeterminado: 30.
PageNumber	Integer	No	1	El número de página a devolver. Valores válidos: cualquier entero positivo distinto de cero. Valor predeterminado: 1.
ResourceGroupId	String	No	rg-acfmy*****	El ID del resource group.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	2603CA96-B17D-4903-BC04-61A2C829CD94	El ID de la solicitud.
Databases	Array of Database		Matriz con la información de las bases de datos.
Database
DBDescription	String	Test database	La descripción de la base de datos.
DBStatus	String	Creating	El estado de la base de datos. Valores válidos: Creating Running Deleting
DBName	String	testDB01	El nombre de la base de datos.
DBInstanceId	String	rm-uf6wjk5xxxxxxx	El ID de la instancia a la que pertenece la base de datos.
Engine	String	MySQL	El motor de base de datos de la instancia a la que pertenece la base de datos.
CharacterSetName	String	utf8	El nombre del conjunto de caracteres.
Collate	String	C	La intercalación del conjunto de caracteres. El valor de ejemplo C representa la configuración regional. Nota Este parámetro solo se devuelve para instancias que ejecutan PostgreSQL.
Ctype	String	en_US.utf8	El tipo del conjunto de caracteres. Nota Este parámetro solo se devuelve para instancias que ejecutan PostgreSQL.
ConnLimit	String	-1	El límite de solicitudes simultáneas. El valor -1 indica que no hay límite. Nota Este parámetro solo se devuelve para instancias que ejecutan PostgreSQL.
Tablespace	String	pg_default	El espacio de tablas de la base de datos. Nota Este parámetro solo se devuelve para instancias que ejecutan PostgreSQL.
ResourceGroupId	String	rg-acfmy*****	El ID del resource group.
Accounts	Array of AccountPrivilegeInfo		Matriz con los detalles de las cuentas. Cada cuenta tiene permisos específicos sobre la base de datos.
AccountPrivilegeInfo
Account	String	test	El nombre de usuario de la cuenta.
AccountPrivilege	String	DMLOnly	Los permisos de la cuenta sobre la base de datos. Valores válidos: ReadWrite: permisos de lectura y escritura ReadOnly: permisos de solo lectura DMLOnly: permisos exclusivos de DML DDLOnly: permisos exclusivos de DDL
AccountPrivilegeDetail	String	SELECT	Los detalles de los permisos de la cuenta sobre la base de datos.
PageNumber	Integer	1	Parámetro reservado.
PageSize	Integer	30	Parámetro reservado.
TotalCount	Integer	100	El número total de entradas devueltas.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=DescribeDatabases
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeDatabasesResponse>
    <RequestId>2603CA96-B17D-4903-BC04-61A2C829CD94</RequestId>
    <Databases>
        <Database>
            <Engine>MySQL</Engine>
            <CharacterSetName>utf8</CharacterSetName>
            <DBStatus>Creating</DBStatus>
            <DBDescription></DBDescription>
            <DBInstanceId>rdsaiiabnaiiabn</DBInstanceId>
            <Accounts></Accounts>
            <DBName>testdb</DBName>
        </Database>
        <Database>
            <Engine>MySQL</Engine>
            <CharacterSetName>gbk</CharacterSetName>
            <DBStatus>Creating</DBStatus>
            <DBDescription></DBDescription>
            <DBInstanceId>rdsaiiabnaiiabn</DBInstanceId>
            <Accounts></Accounts>
            <DBName>testdb2</DBName>
        </Database>
    </Databases></DescribeDatabasesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2603CA96-B17D-4903-BC04-61A2C829CD94",
  "Databases" : {
    "Database" : [ {
      "Engine" : "MySQL",
      "CharacterSetName" : "utf8",
      "DBStatus" : "Creating",
      "DBDescription" : "",
      "DBInstanceId" : "rdsaiiabnaiiabn",
      "Accounts" : {
        " AccountPrivilegeInfo" : [ ]
      },
      "DBName" : "testdb"
    }, {
      "Engine" : "MySQL",
      "CharacterSetName" : "gbk",
      "DBStatus" : "Creating",
      "DBDescription" : "",
      "DBInstanceId" : "rdsaiiabnaiiabn",
      "Accounts" : {
        " AccountPrivilegeInfo" : [ ]
      },
      "DBName" : "testdb2"
    } ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Database.ConnectError	Database connect error. please check instance status and database processlist	Error devuelto debido a una conexión anómala con la base de datos. Compruebe el estado de la instancia y el pool de conexiones de la base de datos.
400	Database.QueryError	Query Db failed, please check input value and instance status	Error devuelto porque no se pudo consultar la base de datos. Compruebe los parámetros de entrada y el estado de la instancia.

Para obtener una lista de códigos de error, visite el Centro de errores de API.