GetPhysicalDatabase - Data Management - Centro de documentación de Alibaba Cloud

Consulta los detalles de una base de datos física.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dms:GetPhysicalDatabase

get

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DbId	integer	Sí	El ID de la base de datos física. Puede llamar a la operación SearchDatabase para obtener el ID.	43153
Tid	integer	No	El ID del inquilino. Puede llamar a la operación GetUserActiveTenant para consultar el ID del inquilino.	1

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los datos devueltos.
RequestId	string	El ID de la solicitud.	7FAD400F-7A5C-4193-8F9A-39D86C4F0231
Database	object	La información sobre la base de datos física.
DatabaseId	string	El ID de la base de datos física.	43125312
Host	string	El endpoint que se utiliza para conectarse a la base de datos.	rm-xxxab3r272.mysql.rds.aliyuncs.com
CatalogName	string	El nombre del catálogo al que pertenece la base de datos. Nota : Si la base de datos es una base de datos PostgreSQL, se muestra el nombre de la base de datos.	def
DbaName	string	El apodo del administrador de bases de datos (DBA) en la base de datos de destino.	dmstest
State	string	El estado de la base de datos. Valores válidos: NORMAL: La base de datos está normal. DISABLE: La base de datos está deshabilitada. OFFLINE: La base de datos no está publicada. NOT_EXIST: La base de datos no existe.	NORMAL
DbaId	string	El ID de usuario del DBA en la base de datos de destino.	43253
SchemaName	string	El nombre de la base de datos. Nota : Si la base de datos es una base de datos PostgreSQL, se muestra el nombre del esquema.	dmstest
InstanceId	string	El ID de instancia de la base de datos de destino.	43215325
Port	integer	El puerto que se utiliza para conectarse a la base de datos.	3306
EnvType	string	El tipo de entorno al que pertenece la base de datos. Para obtener más información, consulte Cambiar el tipo de entorno de una instancia.	product
Sid	string	El ID de sistema (SID) de la base de datos. Nota : El valor del parámetro se devuelve solo para bases de datos Oracle.	def
OwnerIdList	object
OwnerIds	array	Los ID de usuario de los propietarios de la base de datos.
	string	El ID de usuario del propietario de la base de datos.	43215325
Encoding	string	El formato de codificación de la base de datos.	utf8mb4
DbType	string	El tipo de motor de base de datos.	mysql
OwnerNameList	object
OwnerNames	array	Los apodos de los propietarios de la base de datos.
	string	El apodo del propietario de la base de datos.	dmstest
SearchName	string	El nombre que se utiliza para buscar la base de datos.	dmstest@rm-xxxab3r272.mysql.rds.aliyuncs.com:3306
InstanceAlias	string	El alias de la instancia de base de datos.	test
ErrorCode	string	El código de error devuelto si la solicitud falló.	UnknownError
ErrorMessage	string	El mensaje de error devuelto si la solicitud falló.	UnknownError
Success	boolean	Indica si la solicitud se realizó correctamente.	true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "7FAD400F-7A5C-4193-8F9A-39D86C4F0231",
  "Database": {
    "DatabaseId": "43125312",
    "Host": "rm-xxxab3r272.mysql.rds.aliyuncs.com",
    "CatalogName": "def",
    "DbaName": "dmstest",
    "State": "NORMAL",
    "DbaId": "43253",
    "SchemaName": "dmstest",
    "InstanceId": "43215325",
    "Port": 3306,
    "EnvType": "product",
    "Sid": "def",
    "OwnerIdList": {
      "OwnerIds": [
        "43215325"
      ]
    },
    "Encoding": "utf8mb4",
    "DbType": "mysql",
    "OwnerNameList": {
      "OwnerNames": [
        "dmstest"
      ]
    },
    "SearchName": "dmstest@rm-xxxab3r272.mysql.rds.aliyuncs.com:3306",
    "InstanceAlias": "test"
  },
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "Success": true
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.