DescribeMetaList - PolarDB - Centro de documentación de Alibaba Cloud

Consulta las bases de datos y tablas recuperables.

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

polardb:DescribeMetaList

get

*DBCluster

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#DbClusterId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DBClusterId	string	Sí	El ID del clúster. Nota Llame a la operación DescribeDBClusters para consultar los detalles de todos los clústeres en su cuenta.	pc-**************
BackupId	string	No	El ID del conjunto de copias de seguridad. Nota Debe especificar el parámetro `BackupId` o `RestoreTime`. Llame a la operación DescribeBackups para consultar el ID del conjunto de copias de seguridad.	111111
RestoreTime	string	No	El punto en el tiempo al que desea restaurar los datos. Especifique la hora en formato AAAA-MM-DDThh:mmZ. La hora debe estar en UTC. Nota Debe especificar el parámetro `BackupId` o `RestoreTime`. Llame a la operación DescribeBackups para consultar el punto en el tiempo para la restauración.	2020-10-04T01:40:00Z
GetDbName	string	No	El nombre de la base de datos, como `test_db`. Si especifica este parámetro, se devuelven los nombres de todas las tablas que se pueden recuperar de la base de datos especificada. Nota Solo puede especificar un nombre de base de datos a la vez. Si no especifica este parámetro, se devuelven los nombres de todas las bases de datos que se pueden recuperar del conjunto de copias de seguridad actual. No se devuelven los nombres de las tablas en cada base de datos.	test_db
PageSize	integer	No	El número de entradas que se devolverán en cada página. Valores válidos: 30 50 100 Valor predeterminado: 30.	30
PageNumber	integer	No	El número de página. El valor debe ser un número entero mayor que 0 y no debe exceder el valor máximo del tipo de datos Integer. Valor predeterminado: 1.	1
RegionCode	string	No	El ID de región de la instancia. Puede llamar a DescribeDBClusterAttribute para consultar el ID de región.	cn-hangzhou

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
TotalPageCount	string	El número total de páginas.	1
TotalRecordCount	string	El número total de registros.	2
PageSize	string	El número de registros en la página actual.	30
RequestId	string	El ID de la solicitud.	AA815DE7-B576-4B22-B33C-3FB31A******
PageNumber	string	El número de página.	1
Items	array<object>	Los detalles de las bases de datos y tablas recuperables.
	object
Database	string	El nombre de la base de datos que se puede recuperar.	test_db
Tables	array	Los nombres de las tablas que se pueden recuperar.
	string	El nombre de la tabla recuperable.	test_tb1
Size	array	El tamaño de la base de datos o tabla, en bytes.
	integer	El tamaño de la base de datos o tabla en bytes.	16384
DBClusterId	string	El ID del clúster.	pc-bp1s826a1up******

Ejemplos

Respuesta exitosa

JSON Formato

{
  "TotalPageCount": "1",
  "TotalRecordCount": "2",
  "PageSize": "30",
  "RequestId": "AA815DE7-B576-4B22-B33C-3FB31A******",
  "PageNumber": "1",
  "Items": [
    {
      "Database": "test_db",
      "Tables": [
        "test_tb1"
      ],
      "Size": [
        16384
      ]
    }
  ],
  "DBClusterId": "pc-bp1s826a1up******"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	InvalidRestoreType.Format	Specified restore type is not valid.
400	InvalidRestoreTime.Format	Specified restore time is not valid.
400	InvalidBackupSetID.NotFound	Specified backup set ID does not exist.
400	IncorrectBackupSetState	Current backup set state does not support operations.
400	InvalidDBName.Duplicate	Specified DB name already exists in the This instance.
400	InvalidParameters.Format	Specified parameters is not valid.
400	InsufficientResourceCapacity	There is insufficient capacity available for the requested instance.
400	InvalidRestoreType.NotFound	At least one of BackupId and RestoreTime is malformed.
400	MissingUserID	The request is missing a user_id parameter.
400	MissingUID	The request is missing a uid parameter.
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.
404	InvalidBackup.NotFound	The available backup does not exist in recovery time.
404	InvalidDBClusterId.NotFound	The DBInstanceId provided does not exist in our records.

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.