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

Consulta as informações sobre uma versão de 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 a operação ListFiles para consultar o ID.	1000001
ProjectId	integer	Não	O ID do espaço de trabalho do DataWorks. Você pode clicar no ícone Gerenciar Espaço de Trabalho no canto superior direito da página do Data Studio para acessar a página de gerenciamento do espaço de trabalho e visualizar o ID do espaço de trabalho.	1000011
ProjectIdentifier	string	Não	O identificador exclusivo em inglês do espaço de trabalho do DataWorks, exibido no seletor de espaços de trabalho na parte superior da página do Data Studio. Você deve especificar este parâmetro ou ProjectId para determinar o espaço de trabalho do DataWorks ao qual a operação é aplicada.	dw_project
FileVersion	integer	Sim	A versão do arquivo cujos detalhes você deseja consultar.	2

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
HttpStatusCode	integer	O código de status HTTP retornado.	200
ErrorMessage	string	A mensagem de erro retornada.	The connection does not exist.
RequestId	string	O ID da solicitação. Você pode solucionar problemas com base no ID.	0000-ABCD-EFG****
ErrorCode	string	O código de erro retornado.	Invalid.Tenant.ConnectionNotExists
Success	boolean	Indica se a solicitação foi bem-sucedida. Valores válidos: true (bem-sucedida) e false (falha).	true
Data	object	Os detalhes da versão do arquivo.
FileContent	string	O código do arquivo.	SHOW TABLES;
IsCurrentProd	boolean	Indica se esta versão do arquivo é a versão mais recente no ambiente de produção. Valores válidos: true (mais recente) e false (não mais recente).	true
Status	string	O status da versão do arquivo. Valores válidos: COMMITTING, COMMITTED, CHECK_OK, PACKAGED, DEPLOYING, DEPLOYED e CANCELLED. O valor CHECK_OK é equivalente ao valor COMMITTED.	COMMITTED
NodeContent	string	As configurações de agendamento do nó que corresponde à versão do arquivo.	{"cycleType":0,"cronExpress":"00 05 00 * * ?"}
CommitUser	string	O ID da conta da Alibaba Cloud usada para criar a versão do arquivo.	7384234****
Comment	string	A descrição da versão do arquivo.	Second version submission
FilePropertyContent	string	As informações básicas sobre o arquivo.	{"fileName":"ods_user_info_d","fileType":10}
FileName	string	O nome do arquivo.	ods_user_info_d
UseType	string	O módulo funcional ao qual o arquivo pertence. Valores válidos:\n- 0: NORMAL (Data Studio).\n- 1: MANUAL (tarefas acionadas manualmente).\n- 2: MANUAL_BIZ (fluxos de trabalho acionados manualmente).\n- 3: SKIP (agendamento de dry-run no Data Studio).\n- 10: ADHOCQUERY (consultas ad hoc).\n- 30: COMPONENT (gerenciamento de componentes).	0
ChangeType	string	O tipo de alteração da versão do arquivo. Valores válidos: CREATE, UPDATE e DELETE.	UPDATE
FileVersion	integer	A versão do arquivo.	2
CommitTime	integer	A hora em que a versão foi gerada. Este valor é um carimbo de data e hora UNIX que representa o número de milissegundos decorridos desde 1 de janeiro de 1970, 00:00:00 UTC.	1593881265000
NodeId	integer	O ID do nó que corresponde à versão do arquivo.	3000001

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": {
    "FileContent": "SHOW TABLES;",
    "IsCurrentProd": true,
    "Status": "COMMITTED",
    "NodeContent": "{\"cycleType\":0,\"cronExpress\":\"00 05 00 * * ?\"}",
    "CommitUser": "7384234****",
    "Comment": "Second version submission",
    "FilePropertyContent": "{\"fileName\":\"ods_user_info_d\",\"fileType\":10}",
    "FileName": "ods_user_info_d",
    "UseType": "0",
    "ChangeType": "UPDATE",
    "FileVersion": 2,
    "CommitTime": 1593881265000,
    "NodeId": 3000001
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
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.
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.