GetDatabase - - Centro de documentación de Alibaba Cloud

Consulta los detalles de una base de datos específica.

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 SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	GetDatabase	La operación que desea ejecutar. Establezca el valor en GetDatabase.
Host	String	Sí	192.168.XX.XX	El endpoint utilizado para conectarse a la base de datos.
Port	Integer	Sí	3306	El puerto utilizado para conectarse a la base de datos.
SchemaName	String	Sí	mysql	El nombre de la base de datos.
Tid	Long	Sí	-1	El ID del inquilino. Llame a la operación GetUserActiveTenant para consultar el ID del inquilino.
Sid	String	No	test_sid	El identificador del sistema (SID) de la base de datos. Nota El SID identifica de forma única una base de datos Oracle. Una vez creada la base de datos, se genera un SID para ella.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Database	Struct		Los detalles de la base de datos.
CatalogName	String	def	El nombre del catálogo al que pertenece la base de datos.
DatabaseId	String	984****	El ID de la base de datos.
DbType	String	mysql	El tipo de la base de datos. Para obtener más información sobre los valores válidos de este parámetro, consulte Parámetro DbType.
DbaId	String	27****	El ID del administrador de la base de datos (DBA).
DbaName	String	dba_name	El apodo del DBA.
Encoding	String	utf8mb4	El formato de codificación de la base de datos.
EnvType	String	product	El tipo de entorno al que pertenece la base de datos. Valores válidos: product: entorno de producción dev: entorno de desarrollo pre: entorno de preproducción test: entorno de pruebas sit: entorno SIT uat: entorno de pruebas de aceptación de usuario (UAT) pet: entorno de pruebas de estrés stag: entorno STAG
Host	String	192.168.XX.XX	El endpoint utilizado para conectarse a la base de datos.
InstanceId	String	149****	El ID de la instancia.
OwnerIdList	List	27****	Los ID de los propietarios de la base de datos.
OwnerNameList	List	test	Los nombres de los propietarios de la base de datos.
Port	Integer	3306	El puerto utilizado para conectarse a la base de datos.
SchemaName	String	mysql	El nombre de la base de datos.
SearchName	String	mysql@192.168.XX.XX:3306	La palabra clave utilizada para buscar la base de datos.
Sid	String	test_sid	El SID de la base de datos. Nota El valor del parámetro solo se devuelve para bases de datos Oracle.
State	String	NORMAL	El estado de la base de datos. Valores válidos: NORMAL: La base de datos funciona correctamente. DISABLE: La base de datos está deshabilitada. OFFLINE: La base de datos no está publicada. NOT_EXIST: La base de datos no existe.
ErrorCode	String	UnknownError	El código de error.
ErrorMessage	String	An unknown error occurred.	El mensaje de error.
RequestId	String	3CDB8601-AD74-4A47-8114-08E08CD6****	El ID de la solicitud.
Success	Boolean	true	Indica si la solicitud fue exitosa. Valores válidos: true: La solicitud fue exitosa. false: La solicitud falló.

Ejemplos

Solicitudes de ejemplo

http(s)://dms-enterprise.aliyuncs.com/?Action=GetDatabase
&Host=192.168.XX.XX
&Port=3306
&SchemaName=mysql
&Tid=-1
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<GetDatabaseResponse>
  <RequestId>2EF65A2C-FCDC-5E14-A8B5-8D28F33A****</RequestId>
  <Database>
        <SearchName>mysql@192.168.XX.XX:3306[bw-mysql-el8]</SearchName>
        <InstanceId>149****</InstanceId>
        <Port>3306</Port>
        <Encoding>utf8mb4</Encoding>
        <Host>192.168.XX.XX</Host>
        <DatabaseId>984****</DatabaseId>
        <DbType>mysql</DbType>
        <EnvType>product</EnvType>
        <DbaName>dba_name</DbaName>
        <DbaId>27****</DbaId>
        <State>NORMAL</State>
        <CatalogName>def</CatalogName>
        <OwnerNameList>
              <OwnerNames>test</OwnerNames>
        </OwnerNameList>
        <SchemaName>mysql</SchemaName>
        <OwnerIdList>
              <OwnerIds>27****</OwnerIds>
        </OwnerIdList>
  </Database>
  <Success>true</Success>
</GetDatabaseResponse>

Formato JSON

{
    "RequestId": "2EF65A2C-FCDC-5E14-A8B5-8D28F33A****",
    "Database": {
        "SearchName": "mysql@192.168.XX.XX:3306[bw-mysql-el8]",
        "InstanceId": "149****",
        "Port": "3306",
        "Encoding": "utf8mb4",
        "Host": "192.168.XX.XX",
        "DatabaseId": "984****",
        "DbType": "mysql",
        "EnvType": "product",
        "DbaName": "dba_name",
        "DbaId": "27****",
        "State": "NORMAL",
        "CatalogName": "def",
        "OwnerNameList": {
            "OwnerNames": [
                "test"
            ]
        },
        "SchemaName": "mysql",
        "OwnerIdList": {
            "OwnerIds": [
                "27****"
            ]
        }
    },
    "Success": true
}

Códigos de error

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