Consulta as informações sobre uma versão de arquivo.
Experimente agora
Testar
Autorização RAM
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 workspace do DataWorks. Você pode clicar no ícone Gerenciar Workspace no canto superior direito da página do DataStudio para acessar a página Workspace e visualizar o ID do workspace. |
1000011 |
| ProjectIdentifier |
string |
Não |
O identificador exclusivo do workspace do DataWorks. Você pode clicar no identificador no canto superior esquerdo da página do DataStudio para alternar para outro workspace. Você deve especificar este parâmetro ou ProjectId para determinar o workspace 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. |
true |
| Data |
object |
Os detalhes da versão do arquivo. |
|
| FileContent |
string |
O código do arquivo. |
SHOW TABLES; |
| IsCurrentProd |
boolean |
Indica se a versão é a versão mais recente no ambiente de produção. |
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: NORMAL, MANUAL, MANUAL_BIZ, SKIP, ADHOCQUERY e COMPONENT. O valor NORMAL indica DataStudio. O valor MANUAL indica um nó acionado manualmente. O valor MANUAL_BIZ indica um workflow acionado manualmente. O valor SKIP indica um nó do DataStudio em dry-run. O valor ADHOCQUERY indica uma consulta ad hoc. O valor COMPONENT indica snippets. |
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 timestamp 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 |
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.