Todos os produtos
Search
Central de documentação

:UpdateDISyncTask

Última atualização: Jun 27, 2026

Atualiza uma tarefa de sincronização de dados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

UpdateDISyncTask

Operação a ser executada. Defina o valor como UpdateDISyncTask.

ProjectId

Long

Sim

10000

ID do workspace do DataWorks. Acesse o console do DataWorks e navegue até a página Workspace para obter esse ID.

Configure este parâmetro para especificar o workspace do DataWorks ao qual a operação de API se aplica.

TaskType

String

Sim

DI_OFFLINE

Tipo da tarefa de sincronização de dados.

Defina o valor como DI_OFFLINE. A operação UpdateDISyncTask atualiza apenas tarefas de sincronização em lote.

TaskContent

String

Não

{"type":"job","version":"2.0","steps":[{"stepType":"mysql","parameter":{"envType":1,"datasource":"mysql_pub","column":["id","name","create_time","age","score","t_01"],"connection":[{"datasource":"mysql_pub","table":["u_pk"]}],"where":"","splitPk":"id","encoding":"UTF-8"},"name":"Reader","category":"reader"},{"stepType":"odps","parameter":{"partition":"pt=${bizdate}","truncate":true,"datasource":"odps_source","envType":1,"column":["id","name","create_time","age","score","t_01"],"emptyAsNull":false,"tableComment":"null","table":"u_pk"},"name":"Writer","category":"writer"}],"setting":{"executeMode":null,"errorLimit":{"record":""},"speed":{"concurrent":2,"throttle":false}},"order":{"hops":[{"from":"Reader","to":"Writer"}]}}

Configurações atualizadas da tarefa de sincronização de dados. Chamar esta API para atualizar uma tarefa equivale a fazer essa atualização pelo editor de código no console do DataWorks. Para mais informações, consulte Criar uma tarefa de sincronização de dados usando o editor de código. A operação UpdateDISyncTask atualiza apenas tarefas de sincronização em lote. Caso não precise atualizar as configurações da tarefa, deixe este parâmetro vazio.

TaskParam

String

Não

{"ResourceGroup":"S_res_group_XXX_XXXX"}

Configuração para atualizar o grupo de recursos usado pela tarefa de sincronização de dados. Configure este parâmetro no formato JSON.

Somente o campo ResourceGroup é compatível. Esse campo especifica o identificador do grupo de recursos do Data Integration utilizado pela tarefa. Chame a operação ListResourceGroups para consultar o identificador do grupo de recursos.

Se não for necessário atualizar o grupo de recursos da tarefa de sincronização de dados, deixe este parâmetro vazio.

FileId

Long

Sim

1000000

ID da tarefa de sincronização de dados a ser atualizada. Chame a operação ListFiles para consultar o ID.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

Success

Boolean

true

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true

  • false

RequestId

String

0bc1411515937635973****

ID da solicitação. Use este ID para localizar logs e solucionar problemas.

Data

Object

Informações sobre a atualização da tarefa de sincronização de dados.

Status

String

success

Status de atualização da tarefa de sincronização de dados. Valores válidos:

  • success

  • fail

Message

String

ResourceGroup:[S_res_group_XXX] is invalid.

Mensagem de erro retornada caso a atualização da tarefa de sincronização de dados falhe. Se a tarefa for atualizada com sucesso, este parâmetro ficará vazio.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=UpdateDISyncTask
&FileId=1000000
&ProjectId=10000
&RegionId=cn-zhangjiakou
&TaskContent={"type":"job","version":"2.0","steps":[{"stepType":"mysql","parameter":{"envType":1,"datasource":"mysql_pub","column":["id","name","create_time","age","score","t_01"],"connection":[{"datasource":"mysql_pub","table":["u_pk"]}],"where":"","splitPk":"id","encoding":"UTF-8"},"name":"Reader","category":"reader"},{"stepType":"odps","parameter":{"partition":"pt=${bizdate}","truncate":true,"datasource":"odps_source","envType":1,"column":["id","name","create_time","age","score","t_01"],"emptyAsNull":false,"tableComment":"null","table":"u_pk"},"name":"Writer","category":"writer"}],"setting":{"executeMode":null,"errorLimit":{"record":""},"speed":{"concurrent":2,"throttle":false}},"order":{"hops":[{"from":"Reader","to":"Writer"}]}}
&TaskParam={"ResourceGroup":"S_res_group_XXX_XXXX"}
&TaskType=DI_OFFLINE
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>0bc1411515937635973****</RequestId>
<Data>
    <Status>success</Status>
    <Message>ResourceGroup:[S_res_group_XXX] is invalid.</Message>
</Data>
<Success>true</Success>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0bc1411515937635973****",
  "Data" : {
    "Status" : "success",
    "Message" : "ResourceGroup:[S_res_group_XXX] is invalid."
  },
  "Success" : true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

Invalid.DI.Parameter

The parameter is invalid.

Um ou mais parâmetros são inválidos.

403

Forbidden.DI.NoPrivilege

No access.

Você não tem as permissões necessárias.

500

InternalError.DI.Parameter

A DI internal error occurred.

Ocorreu um erro interno no Data Integration.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.