Todos os produtos
Search
Central de documentação

DataWorks:GetFileVersion

Última atualização: Jun 26, 2026

Invoca GetFileVersion para obter 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 obter o ID do arquivo desejado chamando ListFiles.

1000001

ProjectId

integer

Não

O ID do workspace do DataWorks. Você pode clicar no ícone de chave de fenda no canto superior direito da página para acessar a página de Gerenciamento de Workspace e visualizá-lo.

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 de Desenvolvimento de Dados ao alternar workspaces.

Você deve especificar este parâmetro ou o parâmetro ProjectId para identificar 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 desta solicitação. Se ocorrer um erro, você poderá solucionar o problema usando este ID.

0000-ABCD-EFG****

ErrorCode

string

O código de erro.

Invalid.Tenant.ConnectionNotExists

Success

boolean

Indica se a chamada de API foi bem-sucedida.

  • true: Bem-sucedida.

  • false: Falhou.

true

Data

object

Os detalhes da versão do arquivo.

FileContent

string

O código do arquivo para esta versão.

SHOW TABLES;

IsCurrentProd

boolean

Indica se esta versão do arquivo é a versão mais recente no ambiente de produção atual.

  • true: É a versão mais recente.

  • false: Não é a versão mais recente.

true

Status

string

O status atual da versão do arquivo. Valores válidos:

  • COMMITTING (Enviando)

  • COMMITTED ou CHECK_OK (Enviado)

  • PACKAGED (Preparando para publicação)

  • DEPLOYING (Em publicação)

  • DEPLOYED (Publicado)

  • CANCELLED (Publicação cancelada).

COMMITTED

NodeContent

string

A configuração de verificação no momento em que esta versão do arquivo foi gerada.

{"cycleType":0,"cronExpress":"00 05 00 * * ?"}

CommitUser

string

O ID de usuário do usuário da 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 usado para gerar esta versão do arquivo.

{"fileName":"ods_user_info_d","fileType":10}

FileName

string

O nome do arquivo usado para gerar esta versão do arquivo.

ods_user_info_d

UseType

string

O módulo de função ao qual o arquivo pertence. Valores válidos:

  • 0: NORMAL (Desenvolvimento de Dados)

  • 1: MANUAL (tarefa única)

  • 2: MANUAL_BIZ (pipeline manual)

  • 3: SKIP (Agendamento de Dry-Run no Desenvolvimento de Dados)

  • 10: ADHOCQUERY (Consulta Ad Hoc)

  • 30: COMPONENT (Gerenciamento de widgets).

0

ChangeType

string

O tipo de alteração desta versão do arquivo, incluindo CREATE, UPDATE e DELETE.

UPDATE

FileVersion

integer

A versão do arquivo.

2

CommitTime

integer

O timestamp UNIX (em milissegundos) no momento em que a versão do arquivo foi gerada.

1593881265000

NodeId

integer

O ID da tarefa de agendamento correspondente à geração desta 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": "\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. No permission, please authorize
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.