Reiniciar synchronizationJobRestart synchronizationJob

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported. Para determinar si una API está disponible en v1.0, usa el selector de versiones.To determine whether an API is available in v1.0, use the Version selector.

Reinicie el trabajo de sincronización, forzándolo a volver a procesar todos los objetos del directorio.Restart the synchronization job, forcing it to reprocess all the objects in the directory. Opcionalmente borra el estado de sincronización existente y los errores anteriores.Optionally clears existing synchronization state and previous errors.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) Directory.ReadWrite.AllDirectory.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication Application.ReadWrite.OwnedBy, Directory.ReadWrite.AllApplication.ReadWrite.OwnedBy, Directory.ReadWrite.All

Solicitud HTTPHTTP Request

POST /servicePrincipals/{id}/synchronization/jobs/{jobId}/restart

Encabezados de solicitudRequest headers

NombreName TipoType DescripciónDescription
AuthorizationAuthorization stringstring {token} de portador. Obligatorio.Bearer {token}. Required.

Cuerpo de solicitudRequest body

En el cuerpo de la solicitud, proporcione un objeto JSON con el siguiente parámetro.In the request body, provide a JSON object with the following parameter.

ParámetroParameter TipoType DescripciónDescription
criterioscriteria synchronizationJobRestartCriteriasynchronizationJobRestartCriteria Criterios de reinicioRestart criteria

RespuestaResponse

Si se realiza correctamente, devuelve una 204 No Content respuesta.If successful, returns a 204 No Content response. No devuelve nada en el cuerpo de la respuesta.It does not return anything in the response body.

EjemploExample

SolicitudRequest

A continuación se muestra un ejemplo de una solicitud.The following is an example of a request.

POST https://graph.microsoft.com/beta/servicePrincipals/{id}/synchronization/jobs/{jobId}/restart
Authorization: Bearer <token>
Content-type: application/json

{
   "criteria": {
       "resetScope": "Watermark, Escrows, QuarantineState"
   }
}
RespuestaResponse

Aquí tiene un ejemplo de una respuesta.The following is an example of a response.

HTTP/1.1 204 No Content