ListMetaDB - - Centro de documentación de Alibaba Cloud

Consulta metadatabases.

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í	ListMetaDB	La operación que desea ejecutar. Establezca el valor en ListMetaDB.
RegionId	String	Sí	cn-shanghai	El ID de la región. Por ejemplo, el ID de la región China (Shanghai) es cn-shanghai y el de la región China (Zhangjiakou) es cn-zhangjiakou. El sistema determina el valor de este parámetro según el endpoint que se utiliza para llamar a la operación.
ProjectId	Long	Sí	123	El ID del espacio de trabajo de DataWorks. Llame a la operación ListProjects para obtener el ID.
DataSourceType	String	Sí	emr	El tipo de origen de datos. Solo se admite emr.
PageNum	Integer	No	1	El número de página que se devolverá.
PageSize	Integer	No	10	El número de entradas que se devolverán en cada página. Valor predeterminado: 10. Valor máximo: 100.
ClusterId	String	No	abc	El ID del clúster de E-MapReduce (EMR). Inicie sesión en la consola de EMR para obtener el ID.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	abc	El ID de la solicitud.
DatabaseInfo	Object		La información de las metadatabases.
TotalCount	Long	10	El número total de metadatabases.
DbList	Array of DbList		La lista de metadatabases.
Type	String	HIVE	El tipo de la metadatabase.
CreateTimeStamp	Long	1388776825	La marca de tiempo en la que se creó la metadatabase. Puede convertir la marca de tiempo a la fecha correspondiente según la zona horaria que utilice.
UUID	String	32342	El identificador único universal (UUID) de la metadatabase.
ModifiedTimeStamp	Long	1388776837	La marca de tiempo en la que se actualizó la metadatabase.
Name	String	name	El nombre de la metadatabase.
OwnerId	String	1232	El ID del propietario de la metadatabase.
Location	String	hdfs://localhost:777/user/hadoop/test.txt	La URL de la metadatabase.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=ListMetaDB
&ProjectId=123
&DataSourceType=emr
&PageNum=1
&PageSize=10
&ClusterId=abc
&<Common request parameters>

Respuestas correctas de ejemplo

Formato XML

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

<ListMetaDBResponse>
    <RequestId>abc</RequestId>
    <DatabaseInfo>
        <TotalCount>10</TotalCount>
        <DbList>
            <Type>HIVE</Type>
            <CreateTimeStamp>1388776825</CreateTimeStamp>
            <UUID>32342</UUID>
            <ModifiedTimeStamp>1388776837</ModifiedTimeStamp>
            <Name>name</Name>
            <OwnerId>1232</OwnerId>
            <Location>hdfs://localhost:777/user/hadoop/test.txt</Location>
        </DbList>
    </DatabaseInfo>
</ListMetaDBResponse>

Formato JSON

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

{
  "RequestId" : "abc",
  "DatabaseInfo" : {
    "TotalCount" : 10,
    "DbList" : {
      "Type" : "HIVE",
      "CreateTimeStamp" : 1388776825,
      "UUID" : 32342,
      "ModifiedTimeStamp" : 1388776837,
      "Name" : "name",
      "OwnerId" : 1232,
      "Location" : "hdfs://localhost:777/user/hadoop/test.txt"
    }
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Invalid.Meta.AppNotExist	The MaxCompute project does not exist.	El mensaje de error devuelto porque el proyecto de MaxCompute no existe.
400	InvalidParameter.Meta.CommonError	The specified parameter is invalid.	El mensaje de error devuelto porque los valores especificados para uno o más parámetros de solicitud no son válidos.
400	InvalidParameter.Meta.Illegal	The app guid parameter is invalid.	El mensaje de error devuelto porque los valores especificados para uno o más parámetros de la aplicación no son válidos.
400	InvalidParameter.Meta.IllegalDate	The date format is invalid.	El mensaje de error devuelto porque el formato de fecha no es válido.
400	InvalidParameter.Meta.IllegalPageError	The parameter for paging is invalid.	El mensaje de error devuelto porque el valor del parámetro de paginación no es válido.
400	InvalidParameter.Meta.NotExist	The object does not exist.	El mensaje de error devuelto porque el objeto consultado no existe.
403	Forbidden.Meta.NoTenant	The user is not the owner of any tenants.	El mensaje de error devuelto porque el usuario actual no es propietario de ningún inquilino.
403	Forbidden.Access	Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.	El mensaje de error devuelto porque no tiene permiso para realizar esta operación. Active DataWorks Enterprise Edition o DataWorks Ultimate Edition.
429	Throttling.Api	The request for this resource has exceeded your available limit.	El mensaje de error devuelto porque el número de solicitudes para el recurso ha superado el límite superior.
429	Throttling.Api.Risk	The request for this resource has exceeded your daily available limit.	El mensaje de error devuelto porque el número de solicitudes diarias para el recurso ha superado el límite superior.
429	Throttling.System	The DataWorks system is busy. Try again later.	El mensaje de error devuelto porque el sistema de DataWorks está ocupado. Inténtelo de nuevo más tarde.
429	Throttling.User	Your request is too frequent. Try again later.	El mensaje de error devuelto porque se han enviado demasiadas solicitudes en un periodo corto. Inténtelo de nuevo más tarde.
500	InternalError.System	An internal system error occurred. Try again later.	El mensaje de error devuelto porque se produjo un error interno. Inténtelo de nuevo más tarde.
500	InternalError.UserId.Missing	An internal system error occurred. Try again later.	El mensaje de error devuelto porque se produjo un error interno. Inténtelo de nuevo más tarde.
500	InternalError.Meta.NoCalcEngine	An error occurred while retrieving the compute engine based on the MaxCompute project.	El mensaje de error devuelto porque el sistema no pudo obtener la instancia del motor de cómputo según el proyecto de MaxCompute especificado.
500	InternalError.Meta.TenantTimeOut	Failed to connect to the interface network.	El mensaje de error devuelto porque no se puede establecer la conexión de red.
500	InternalError.Meta.Unknown	An unknown error occurred while processing your request.	El mensaje de error devuelto porque se produjo un error desconocido.

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

Para obtener más información sobre cómo utilizar la operación, consulte Ejemplos de operaciones de API de DataWorks.