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