ListMetaDB - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ListMetaDB	Operação a ser executada. Defina o valor como ListMetaDB.
RegionId	String	Sim	cn-shanghai	ID da região. Por exemplo, o ID da região China (Shanghai) é cn-shanghai e o da região China (Zhangjiakou) é cn-zhangjiakou. O sistema determina esse parâmetro com base no endpoint usado na chamada da operação.
ProjectId	Long	Sim	123	ID do workspace do DataWorks. Chame a operação ListProjects para obter esse ID.
DataSourceType	String	Sim	emr	Tipo da fonte de dados. Apenas emr é suportado.
PageNum	Integer	Não	1	Número da página a retornar.
PageSize	Integer	Não	10	Quantidade de entradas por página. Valor padrão: 10. Valor máximo: 100.
ClusterId	String	Não	abc	ID do cluster do E-MapReduce (EMR). Acesse o console do EMR para obter esse ID.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	abc	ID da solicitação.
DatabaseInfo	Object		Informações dos metadatabases.
TotalCount	Long	10	Número total de metadatabases.
DbList	Array of DbList		Lista de metadatabases.
Type	String	HIVE	Tipo do metadatabase.
CreateTimeStamp	Long	1388776825	Timestamp de criação do metadatabase. Converta o timestamp para a data correspondente conforme o fuso horário utilizado.
UUID	String	32342	Identificador universalmente único (UUID) do metadatabase.
ModifiedTimeStamp	Long	1388776837	Timestamp da última atualização do metadatabase.
Name	String	name	Nome do metadatabase.
OwnerId	String	1232	ID do proprietário do metadatabase.
Location	String	hdfs://localhost:777/user/hadoop/test.txt	URL do metadatabase.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Invalid.Meta.AppNotExist	The MaxCompute project does not exist.	O projeto do MaxCompute não existe.
400	InvalidParameter.Meta.CommonError	The specified parameter is invalid.	Um ou mais parâmetros da solicitação têm valores inválidos.
400	InvalidParameter.Meta.Illegal	The app guid parameter is invalid.	Valores definidos para um ou mais parâmetros do aplicativo são inválidos.
400	InvalidParameter.Meta.IllegalDate	The date format is invalid.	Formato de data inválido.
400	InvalidParameter.Meta.IllegalPageError	The parameter for paging is invalid.	Valor do parâmetro de paginação inválido.
400	InvalidParameter.Meta.NotExist	The object does not exist.	Objeto consultado não encontrado.
403	Forbidden.Meta.NoTenant	The user is not the owner of any tenants.	Usuário atual não é proprietário de nenhum tenant.
403	Forbidden.Access	Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.	Acesso negado. Ative o DataWorks Enterprise Edition ou o DataWorks Ultimate Edition.
429	Throttling.Api	The request for this resource has exceeded your available limit.	Limite de solicitações para este recurso excedido.
429	Throttling.Api.Risk	The request for this resource has exceeded your daily available limit.	Limite diário de solicitações para este recurso excedido.
429	Throttling.System	The DataWorks system is busy. Try again later.	Sistema do DataWorks ocupado. Tente novamente mais tarde.
429	Throttling.User	Your request is too frequent. Try again later.	Frequência de solicitações muito alta. Aguarde e tente novamente.
500	InternalError.System	An internal system error occurred. Try again later.	Erro interno do sistema. Tente novamente mais tarde.
500	InternalError.UserId.Missing	An internal system error occurred. Try again later.	Erro interno do sistema. Tente novamente mais tarde.
500	InternalError.Meta.NoCalcEngine	An error occurred while retrieving the compute engine based on the MaxCompute project.	Falha ao recuperar a instância do mecanismo de computação associada ao projeto do MaxCompute especificado.
500	InternalError.Meta.TenantTimeOut	Failed to connect to the interface network.	Falha na conexão com a rede da interface.
500	InternalError.Meta.Unknown	An unknown error occurred while processing your request.	Erro desconhecido durante o processamento da solicitação.

Para obter uma lista completa dos códigos de erro, visite o API Error Center.

Para mais informações sobre como utilizar esta operação, consulte Exemplos de operações da API do DataWorks.