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

Consulta uma lista de versões 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 ListFiles para consultar o ID do arquivo.	100000001
ProjectId	integer	Não	O ID do espaço de trabalho do DataWorks. Para encontrá-lo, clique no ícone de chave de fenda no canto superior direito e navegue até a página de gerenciamento do espaço de trabalho.	100001
ProjectIdentifier	string	Não	O identificador exclusivo do espaço de trabalho do DataWorks, que é o identificador na parte superior da página do Data Studio onde você alterna entre espaços de trabalho. Este parâmetro ou o ProjectId deve ser especificado para identificar o espaço de trabalho do DataWorks de destino para esta chamada de API.	dw_project
PageNumber	integer	Não	O número da página 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	A 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 false.	true
Data	object	A lista de versões de arquivo.
PageNumber	integer	O número da página atual.	1
PageSize	integer	O número de entradas na página atual.	10
TotalCount	integer	O número total de entradas retornadas.	13
FileVersions	array<object>	A lista de detalhes das versões de arquivo.
	object	Os detalhes da versão do arquivo.
FileContent	string	The file code for this version.	SHOW TABLES;
Status	string	The current status of the file version. Valid values: COMMITTING (committing), COMMITTED or CHECK_OK (committed), PACKAGED (ready for deployment), DEPLOYING (deploying), DEPLOYED (deployed), and CANCELLED (deployment canceled).	COMMITTED
IsCurrentProd	boolean	Indicates whether this file version is the latest version in the production environment. true false	false
CommitUser	string	The Alibaba Cloud account ID of the user who created this file version.	73842342****
NodeContent	string	The scheduling configuration for this file version.	{"cycleType":0,"cronExpress":"00 05 00 * * ?"}
Comment	string	The description of this file version.	Second version submission
FilePropertyContent	string	The text information for this file version.	{"fileName":"ods_user_info_d","fileType":10}
FileName	string	The file name for this file version.	ods_user_info_d
UseType	string	The functional module to which the file belongs. Valid values: NORMAL (Data Studio), MANUAL (manual task), MANUAL_BIZ (manual workflow), SKIP (dry-run scheduling in Data Studio), ADHOCQUERY (ad hoc query), and COMPONENT (component management).	NORMAL
ChangeType	string	The change type for this file version. Valid values: CREATE, UPDATE, and DELETE.	UPDATE
FileVersion	integer	The file version.	2
CommitTime	integer	The timestamp (in milliseconds) when the file version was created.	1593881265000
NodeId	integer	The scheduling task ID associated with this file version.	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.	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.