ListFileVersions - DataWorks: Central de Documentação do Alibaba Cloud

Consulta a lista de versões de um arquivo.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
FileId	integer	Sim	O ID do arquivo. Você pode chamar ListFiles para consultar o ID do arquivo.	100000001
ProjectId	integer	Não	O ID do workspace do DataWorks. Você pode clicar no ícone de chave inglesa no canto superior direito da página para acessar a página de gerenciamento do workspace e visualizar o ID.	100001
ProjectIdentifier	string	Não	O identificador exclusivo do workspace do DataWorks, que é o identificador em inglês exibido no seletor de workspaces na parte superior da página do Data Studio. Você deve definir este parâmetro ou o ProjectId para determinar o workspace do DataWorks para esta chamada de API.	dw_project
PageNumber	integer	Não	O número da página. Usado para paginação.	1
PageSize	integer	Não	O número de entradas por página. Valor padrão: 10. Valor máximo: 100.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
HttpStatusCode	integer	O código de status HTTP.	200
ErrorMessage	string	A mensagem de erro.	The connection does not exist.
RequestId	string	O ID da solicitação.	0000-ABCD-EFG****
ErrorCode	string	O código de erro.	Invalid.Tenant.ConnectionNotExists
Success	boolean	Indica se a chamada foi bem-sucedida. Valores válidos: true: A chamada foi bem-sucedida. false: A chamada falhou.	true
Data	object	A lista de versões do arquivo.
PageNumber	integer	O número da página atual.	1
PageSize	integer	O tamanho da página.	10
TotalCount	integer	O número total de entradas que atendem às condições de consulta.	13
FileVersions	array<object>	A lista de detalhes das versões do arquivo.
	object	Os detalhes de uma versão do arquivo.
FileContent	string	O código do arquivo que gerou esta versão do arquivo.	SHOW TABLES;
Status	string	O status atual da versão do arquivo. Valores válidos: COMMITTING (submetendo), COMMITTED ou CHECK_OK (submetido), PACKAGED (pronto para implantação), DEPLOYING (implantando), DEPLOYED (implantado) e CANCELLED (implantação cancelada).	COMMITTED
IsCurrentProd	boolean	Indica se esta versão do arquivo é a versão mais recente no ambiente de produção. true: A versão é a versão mais recente. false: A versão não é a versão mais recente.	false
CommitUser	string	O ID de usuário da Alibaba Cloud que gerou esta versão do arquivo.	73842342****
NodeContent	string	A configuração de agendamento que gerou esta versão do arquivo.	{"cycleType":0,"cronExpress":"00 05 00 * * ?"}
Comment	string	A descrição desta versão do arquivo.	Second version submission
FilePropertyContent	string	As informações de texto básicas que geraram esta versão do arquivo.	{"fileName":"ods_user_info_d","fileType":10}
FileName	string	O nome do arquivo que gerou esta versão do arquivo.	ods_user_info_d
UseType	string	O módulo funcional ao qual o arquivo pertence. Valores válidos: NORMAL (Data Studio), MANUAL (nó manual), MANUAL_BIZ (workflow manual), SKIP (agendamento de dry run no Data Studio), ADHOCQUERY (consulta ad hoc) e COMPONENT (gerenciamento de componentes).	NORMAL
ChangeType	string	O tipo de alteração desta versão do arquivo. Valores válidos: CREATE, UPDATE e DELETE.	UPDATE
FileVersion	integer	A versão do arquivo.	2
CommitTime	integer	O carimbo de data e hora em milissegundos em que a versão do arquivo foi gerada.	1593881265000
NodeId	integer	O ID do nó de agendamento associado à versão do arquivo.	1234

Exemplos

Resposta de sucesso

JSON formato

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist",
  "RequestId": "0000-ABCD-EFG****",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 13,
    "FileVersions": [
      {
        "FileContent": "SHOW TABLES;",
        "Status": "COMMITTED",
        "IsCurrentProd": false,
        "CommitUser": "73842342****\n",
        "NodeContent": "{\"cycleType\":0,\"cronExpress\":\"00 05 00 * * ?\"}",
        "Comment": "Second version submission",
        "FilePropertyContent": "{\"fileName\":\"ods_user_info_d\",\"fileType\":10}",
        "FileName": "ods_user_info_d",
        "UseType": "NORMAL",
        "ChangeType": "UPDATE",
        "FileVersion": 2,
        "CommitTime": 1593881265000,
        "NodeId": 1234
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
500	InternalError.System	An internal system error occurred. Try again later.
500	InternalError.UserId.Missing	An internal system error occurred. Try again later.
403	Forbidden.Access	Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.	Acesso negado. Autorize o acesso.
429	Throttling.Api	The request for this resource has exceeded your available limit.
429	Throttling.System	The DataWorks system is busy. Try again later.
429	Throttling.User	Your request is too frequent. Try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.