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

Atualiza assincronamente um nó especificado e sincroniza as alterações com o Data Studio como uma nova versão salva.

Descrição da operação

Esta API é assíncrona. Use a operação GetUpdateTaskResult para consultar o resultado da atualização.
Esta API atualiza as informações de um nó especificado, incluindo o nome, a descrição e o proprietário do nó.
As alterações são sincronizadas com o Data Studio, e o Data Studio cria uma nova versão salva.
Suporta configurações para o método de acionamento do nó, configuração do ambiente de execução, dependências e outros parâmetros detalhados.

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.

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Id	integer	Sim	O ID do nó.	10001
ClientUniqueCode	string	Não	O código exclusivo do cliente do nó, usado para identificá-lo de forma exclusiva. Este código é usado para processamento assíncrono e idempotência. Se você não especificar este parâmetro ao criar um nó, o sistema gera automaticamente um valor e o vincula ao ID do recurso. Se você especificar este parâmetro ao atualizar ou excluir um recurso, o valor deve corresponder ao código exclusivo do cliente usado quando o recurso foi criado.	Workflow_0bc5213917368545132902xxxxxxxx
EnvType	string	Não	O ambiente do projeto. Valores válidos: Prod: produção Dev: desenvolvimento	Prod
Name	string	Não	O nome.	name
Description	string	Não	A descrição.	This is a description.
Owner	string	Não	O ID da conta do proprietário do nó. Você pode fazer login no console do DataWorks e passar o mouse sobre a foto de perfil no canto superior direito da barra de navegação superior para visualizar o ID da conta. Se este parâmetro não for especificado, o ID da conta Alibaba Cloud do chamador será usado por padrão. DataWorks console	1000000000001
InstanceMode	string	Não	O modo de geração de instâncias. Valores válidos: T+1: gera instâncias no dia seguinte. Immediately: gera instâncias imediatamente. Nota: apenas instâncias periódicas cujo horário agendado seja superior a 10 minutos após o horário de publicação do nó são geradas normalmente. Durante o período de geração completa de instâncias (22:00–24:00), não há suporte para a geração de instâncias em tempo real. Você pode enviar e publicar nós, mas novos nós não são convertidos automaticamente em instâncias.	T+1
Timeout	integer	Não	O período de tempo limite definido na configuração de agendamento.	1
RerunMode	string	Não	A configuração que especifica se o nó pode ser reexecutado. Valores válidos: AllDenied: o nó não pode ser reexecutado, independentemente de ser bem-sucedido ou falhar. FailureAllowed: o nó pode ser reexecutado apenas se falhar. AllAllowed: o nó pode ser reexecutado, independentemente de ser bem-sucedido ou falhar.	AllAllowed
RerunTimes	integer	Não	O número de tentativas. Este parâmetro entra em vigor apenas quando o nó está configurado para permitir reexecuções.	3
RerunInterval	integer	Não	O intervalo entre novas tentativas, em milissegundos. O valor não pode exceder 1800000.	60000
Script	object	Não	As informações do script de execução.
Content `deprecated`	string	Não	O conteúdo do script.	echo "helloWorld"
Parameters	string	Não	A lista de parâmetros do script.	para1=$bizdate
Trigger	object	Não	O método de acionamento do nó.
Cron	string	Não	A expressão cron. Este parâmetro entra em vigor quando Type é definido como Scheduler.	00 00 00 * * ?
CycleType	string	Não	O tipo de ciclo de agendamento. Este parâmetro entra em vigor quando Type é definido como Scheduler e a expressão cron especifica um agendamento em um horário específico. Valor padrão: Daily. Valores válidos: Daily: agendamento diário. NotDaily: agendamento por hora.	Daily
EndTime	string	Não	O horário em que o acionamento periódico expira. Este parâmetro entra em vigor quando Type é definido como Scheduler. O formato é yyyy-mm-dd hh:mm:ss.	9999-01-01 00:00:00
Recurrence	string	Não	O modo de execução quando o acionamento é disparado. Este parâmetro entra em vigor quando Type é definido como Scheduler. Valores válidos: Pause: pausado. Skip: dry run. Normal: execução normal.	Normal
StartTime	string	Não	O horário em que o acionamento agendado entra em vigor. Este parâmetro entra em vigor quando Type é definido como Scheduler. O formato é yyyy-mm-dd hh:mm:ss.	1970-01-01 00:00:00
Type	string	Não	O tipo de acionamento. Valores válidos: Scheduler: acionamento periódico agendado. Manual: acionamento manual.	BySchedule
RuntimeResource	object	Não	A configuração do ambiente de execução, como as informações do grupo de recursos.
Cu	string	Não	O consumo de CU para a configuração de execução do nó.	0.25
Image	string	Não	O ID da imagem para a configuração de execução do nó.	i-xxxxxx
ResourceGroupId	string	Não	O identificador do grupo de recursos de agendamento para a configuração de execução do nó.	63900680
DataSource	object	Não	As informações da fonte de dados associada.
Name	string	Não	O nome da fonte de dados.	odps_test
Inputs	object	Não	As informações de entrada.
Variables	array<object>	Não	A lista de definições de variáveis.
	object	Não	A lista de definições de variáveis.
Name	string	Não	O nome da variável.	key1
Type	string	Sim	O tipo de variável. Valores válidos: Constant: constante. PassThrough: saída de um nó de passagem de parâmetros. System: variável do sistema. NodeOutput: saída do script.	Constant
Value	string	Não	O valor da variável.	value1
Outputs	object	Não	As informações de saída.
TaskOutputs	array<object>	Não	A lista de definições de saída do nó.
	object	Não	A lista de definições de saída do nó.
Output	string	Não	O identificador de saída.	pre.odps_sql_demo_0
Variables	array<object>	Não	A lista de definições de variáveis.
	object	Não	A lista de definições de variáveis.
Name	string	Não	O nome da variável.	key1
Type	string	Sim	O tipo de variável. Valores válidos: Constant: constante. PassThrough: saída de um nó de passagem de parâmetros. System: variável do sistema. NodeOutput: saída do script.	Constant
Value	string	Não	O valor da variável.	value1
Dependencies	array<object>	Não	As informações de dependência.
	object	Não	As informações de dependência.
Type	string	Sim	O tipo de dependência. Valores válidos: CrossCycleDependsOnChildren: dependência entre ciclos em nós filhos de primeiro nível. CrossCycleDependsOnSelf: dependência entre ciclos no próprio nó. CrossCycleDependsOnOtherNode: dependência entre ciclos em outros nós. Normal: dependência no mesmo ciclo.	Normal
UpstreamOutput	string	Não	O identificador de saída do nó upstream. Este campo é retornado para dependências no mesmo ciclo quando o conteúdo de entrada é configurado.	pre.odps_sql_demo_0
UpstreamTaskId	integer	Não	O ID do nó upstream. Este campo é retornado para dependências entre ciclos em outros nós e para dependências no mesmo ciclo quando nenhum conteúdo de entrada é configurado. Não é retornado em outros casos.	1234
Tags	array<object>	Não	A lista de tags de ativos de dados a serem anexadas.
	object	Não	A lista de tags do nó.
Key	string	Sim	A chave da tag.	tagKey
Value	string	Não	O valor da tag.	value

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
OperationId	string	O ID da operação, usado para recuperar o resultado da atualização assíncrona do nó. Você pode obter este valor a partir da operação UpdateTaskAsync.	e15ad21c-b0e9-4792-8f55-b037xxxxxxxx
RequestId	string	O ID exclusivo desta solicitação. Se ocorrer um erro, você pode usar este ID para solucionar o problema.	10000001

Exemplos

Resposta de sucesso

JSON formato

{
  "OperationId": "e15ad21c-b0e9-4792-8f55-b037xxxxxxxx",
  "RequestId": "10000001"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.