UpdateDISyncTask - - Centro de documentación de Alibaba Cloud

Actualiza una tarea de sincronización de datos.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	UpdateDISyncTask	La operación que desea ejecutar. Establezca el valor en UpdateDISyncTask.
ProjectId	Long	Sí	10000	El ID del espacio de trabajo de DataWorks. Inicie sesión en DataWorks console y vaya a la página Workspace para obtener el ID del espacio de trabajo. Configure este parámetro para especificar el espacio de trabajo de DataWorks al que se aplica la operación de API.
TaskType	String	Sí	DI_OFFLINE	El tipo de tarea de sincronización de datos. Establezca el valor en DI_OFFLINE. La operación UpdateDISyncTask solo permite actualizar tareas de sincronización por lotes.
TaskContent	String	No	{"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"}]}}	La configuración actualizada de la tarea de sincronización de datos. Llamar a esta operación de API equivale a actualizar la tarea mediante el editor de código en la consola de DataWorks. Para obtener más información, consulte Create a data synchronization task by using the code editor. La operación UpdateDISyncTask solo permite actualizar tareas de sincronización por lotes. Si no necesita actualizar la configuración de la tarea de sincronización de datos, deje este parámetro vacío.
TaskParam	String	No	{"ResourceGroup":"S_res_group_XXX_XXXX"}	La configuración para actualizar el resource group que utiliza la tarea de sincronización de datos. Configure este parámetro en formato JSON. Solo se admite el campo ResourceGroup. Este campo especifica el identificador del resource group de Data Integration que usa la tarea de sincronización de datos. Llame a la operación ListResourceGroups para consultar el identificador del resource group. Si no necesita actualizar el resource group de la tarea de sincronización de datos, deje este parámetro vacío.
FileId	Long	Sí	1000000	El ID de la tarea de sincronización de datos por actualizar. Llame a la operación ListFiles para consultar el ID.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Success	Boolean	true	Indica si la solicitud se realizó correctamente. Valores válidos: true false
RequestId	String	0bc1411515937635973****	El ID de la solicitud. Use este ID para localizar registros y solucionar problemas.
Data	Object		Información sobre si se actualizó la tarea de sincronización de datos.
Status	String	success	El estado de actualización de la tarea de sincronización de datos. Valores válidos: success fail
Message	String	ResourceGroup:[S_res_group_XXX] is invalid.	Mensaje de error devuelto si falla la actualización de la tarea de sincronización de datos. Si la tarea se actualiza correctamente, este parámetro queda vacío.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Invalid.DI.Parameter	The parameter is invalid.	Uno o más parámetros no son válidos.
403	Forbidden.DI.NoPrivilege	No access.	No tiene los permisos necesarios.
500	InternalError.DI.Parameter	A DI internal error occurred.	Se produjo un error interno en Data Integration.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.