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

Atualiza um nó especificado. As modificações são sincronizadas com o DataStudio, onde uma nova versão salva é criada.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dataworks:*

update

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Id	integer	Sim	O ID do nó.	1234
ClientUniqueCode	string	Não	O código único do cliente do nó, usado para identificar exclusivamente um nó. Este código é usado para implementar operações assíncronas e idempotência. Se não for especificado durante a criação, o sistema gera um automaticamente, e o código é vinculado exclusivamente ao ID do recurso. Ao atualizar ou excluir um recurso, se este parâmetro for especificado, ele deve ser consistente com o código único do cliente usado durante a criação.	Task_0bc5213917368545132902xxxxxxxx
EnvType	string	Não	O ambiente do projeto. Valores válidos: Prod: produção. Dev: desenvolvimento.	Prod
Name	string	Não	O nome.	SQL node
Description	string	Não	A descrição.	test
Owner	string	Não	O ID da conta do proprietário do nó.	1000
InstanceMode	string	Não	O modo de geração de instância. Valores válidos: T+1: A instância é gerada no dia seguinte. Immediately: A instância é gerada imediatamente. Observação: Apenas instâncias periódicas cujo horário agendado seja pelo menos dez minutos após o horário de publicação do nó são geradas normalmente. Durante o período completo de geração de instâncias (22:00 às 24:00), a geração de instâncias em tempo real não está disponível. Você pode enviar e publicar nós, mas novos nós não geram instâncias automaticamente.	T+1
Timeout	integer	Não	O período de tempo limite de execução do nó, em segundos. O valor deve ser maior que 3600.	3600
RerunMode	string	Não	Especifica se o nó pode ser reexecutado. Valores válidos: AllDenied: O nó não pode ser reexecutado, independentemente de ter sucesso ou falhar. FailureAllowed: O nó pode ser reexecutado apenas quando falha. AllAllowed: O nó pode ser reexecutado, independentemente de ter sucesso ou falhar.	AllAllowed
RerunTimes	integer	Não	O número de tentativas. Este parâmetro entra em vigor quando o nó está configurado para permitir reexecuções.	3
RerunInterval	integer	Não	O intervalo de tempo entre tentativas, em milissegundos. O valor não pode exceder 1800000.	60000
Script	object	Não	As informações do script.
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ó.
Type	string	Não	O tipo de acionamento. Valores válidos: Scheduler: acionamento de agendamento periódico. Manual: acionamento manual.	Scheduler
Recurrence	string	Não	O modo de execução quando acionado. Este parâmetro entra em vigor quando Type está definido como Scheduler. Valores válidos: Pause: pausado. Skip: dry run. Normal: execução normal.	Normal
Cron	string	Não	A expressão cron. Este parâmetro entra em vigor quando Type está definido como Scheduler.	00 00 00 * * ?
StartTime	string	Não	O período de vigência do acionamento periódico. Este parâmetro entra em vigor quando Type está definido como Scheduler. Formato: `yyyy-mm-dd hh:mm:ss`.	1970-01-01 00:00:00
EndTime	string	Não	O horário de expiração do acionamento periódico. Este parâmetro entra em vigor quando Type está definido como Scheduler. Formato: `yyyy-mm-dd hh:mm:ss`.	9999-01-01 00:00:00
CycleType	string	Não	O tipo de ciclo. Este parâmetro entra em vigor quando Type está definido como Scheduler e a expressão cron especifica agendamento cronometrado em uma hora específica. Valor padrão: Daily. Valores válidos: Daily: agendamento diário. NotDaily: agendamento por hora.	Daily
RuntimeResource	object	Não	A configuração do ambiente, como informações do grupo de recursos.
ResourceGroupId	string	Não	O identificador do grupo de recursos de agendamento configurado para o nó.	S_res_group_524258031846018_1684XXXXXXXXX
Image	string	Não	O ID da imagem configurada para o nó.	i-xxxxxx
Cu	string	Não	O consumo de CU configurado para o nó.	0.25
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
Type	string	Sim	O tipo. Valores válidos: Constant: constante. PassThrough: saída do nó de parâmetro. System: variável. NodeOutput: saída do script.	Constant
Value	string	Não	O valor da variável.	value1
Name	string	Não	O nome da variável.	key1
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
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
Type	string	Sim	O tipo. Valores válidos: Constant: constante. PassThrough: saída do nó de parâmetro. System: variável. NodeOutput: saída do script.	Constant
Value	string	Não	O valor da variável.	value1
Name	string	Não	O nome da variável.	key1
Dependencies	array<object>	Não	As informações de dependência.
	object	Não
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 quando o tipo de dependência é dependência no mesmo ciclo e o conteúdo de entrada está configurado.	pre.odps_sql_demo_0
UpstreamTaskId	integer	Não	O ID do nó upstream. Este campo é retornado quando o tipo de dependência é dependência entre ciclos em outros nós, ou dependência no mesmo ciclo sem conteúdo de entrada configurado. Não é retornado em outros casos.	1234
Tags	array<object>	Não	A lista de tags do nó.
	object	Não
Value	string	Não	O valor da tag.	value1
Key	string	Sim	A chave da tag.	key1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação, usado para localizar logs e solucionar problemas.	22C97E95-F023-56B5-8852-B1A77A17XXXX
Success	boolean	Indica se a operação foi bem-sucedida.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "22C97E95-F023-56B5-8852-B1A77A17XXXX",
  "Success": true
}

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.