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

Obtém os detalhes da versão 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.	1000001
ProjectId	integer	Não	O ID do workspace do DataWorks. Você pode clicar no pequeno ícone de chave inglesa no canto superior direito da página para acessar a página de gerenciamento do workspace e visualizar o ID.	1000011
ProjectIdentifier	string	Não	O identificador exclusivo do workspace do DataWorks, que é o identificador em inglês exibido na parte superior da página do Data Studio para alternar workspaces.\n\n\n\nVocê deve definir este parâmetro ou ProjectId para determinar o workspace do DataWorks para esta chamada de API.	dw_project
FileVersion	integer	Sim	A versão do arquivo a ser consultada.	2

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
HttpStatusCode	integer	O código de status HTTP.	200
ErrorMessage	string	A mensagem de erro.	The connection does not exist.
RequestId	string	O ID exclusivo da solicitação. Você pode usar este ID para solucionar problemas.	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:\n- true: A chamada foi bem-sucedida.\n- false: A chamada falhou.	true
Data	object	Os detalhes da versão do arquivo.
FileContent	string	O código do arquivo que gerou esta versão 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:\n- true: A versão é a versão mais recente.\n- false: A versão não é a versão mais recente.	true
Status	string	O status atual da versão do arquivo. Valores válidos:\n- COMMITTING: A versão está sendo submetida.\n- COMMITTED ou CHECK_OK: A versão foi submetida.\n- PACKAGED: A versão está pronta para implantação.\n- DEPLOYING: A versão está sendo implantada.\n- DEPLOYED: A versão foi implantada.\n- CANCELLED: A implantação foi cancelada.	COMMITTED
NodeContent	string	A configuração de agendamento quando esta versão do arquivo foi gerada.	{"cycleType":0,"cronExpress":"00 05 00 * * ?"}
CommitUser	string	O ID de usuário do Alibaba Cloud que gerou esta versão do arquivo.	7384234****
Comment	string	A descrição desta versão do arquivo.	Second version submission
FilePropertyContent	string	As informações básicas do arquivo quando esta versão do arquivo foi gerada.	{"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:\n\n\n\n\n- 0: NORMAL (Data Studio)\n- 1: MANUAL (nó manual)\n- 2: MANUAL_BIZ (workflow manual)\n- 3: SKIP (agendamento de dry-run no Data Studio)\n- 10: ADHOCQUERY (consulta ad hoc)\n- 30: COMPONENT (gerenciamento de componentes)	0
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 que a versão do arquivo foi gerada, em milissegundos.	1593881265000
NodeId	integer	O ID do nó de agendamento associado à versão do arquivo quando ela foi gerada.	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": "\t\n7384234****\n",
    "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	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.