Atualiza uma tarefa de sincronização de dados.
Depuração
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:
|
|
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:
|
|
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.