Démarrer la synchronisationJob

Espace de noms: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur de version .

Démarrez un travail de synchronisation existant. Si le travail est en pause, il continuera à traiter les modifications à partir du point où il a été suspendu. Si le travail est en quarantaine, l’état de mise en quarantaine est effacé. Ne créez pas de scripts pour appeler le travail de démarrage en continu pendant son exécution, car cela peut entraîner l’arrêt de l’exécution du service. Utilisez le travail de démarrage uniquement lorsque le travail est actuellement en pause ou en quarantaine.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	Directory.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	Application.ReadWrite.OwnedBy, Directory.ReadWrite.All

Requête HTTP

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

En-têtes de demande

Nom	Type	Description
Autorisation	string	Porteur {token}. Obligatoire.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, renvoie une 204 No Content réponse. Elle ne renvoie rien dans le corps de la réponse.

Exemple

Demande

Voici un exemple de requête.

HTTP

POST https://graph.microsoft.com/beta/servicePrincipals/{id}/synchronization/jobs/{jobId}/start

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

await graphClient.ServicePrincipals["{servicePrincipal-id}"].Synchronization.Jobs["{synchronizationJob-id}"]
    .Start()
    .Request()
    .PostAsync();

Important

Les Kits de développement logiciel (SDK) Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

await client.api('/servicePrincipals/{id}/synchronization/jobs/{jobId}/start')
    .version('beta')
    .post();

Important

Les Kits de développement logiciel (SDK) Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/servicePrincipals/{id}/synchronization/jobs/{jobId}/start"]]];
[urlRequest setHTTPMethod:@"POST"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Important

Les Kits de développement logiciel (SDK) Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

graphClient.servicePrincipals("{id}").synchronization().jobs("{jobId}")
    .start()
    .buildRequest()
    .post();

Important

Les Kits de développement logiciel (SDK) Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

servicePrincipalId := "servicePrincipal-id"
synchronizationJobId := "synchronizationJob-id"
graphClient.ServicePrincipalsById(&servicePrincipalId).Synchronization().JobsById(&synchronizationJobId).Start(servicePrincipal-id, synchronizationJob-id).Post()

Important

Les Kits de développement logiciel (SDK) Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

PowerShell

Import-Module Microsoft.Graph.Applications

Start-MgServicePrincipalSynchronizationJob -ServicePrincipalId $servicePrincipalId -SynchronizationJobId $synchronizationJobId

Important

Les Kits de développement logiciel (SDK) Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le Kit de développement logiciel (SDK), consultez Utiliser les Kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur l’ajout du Kit de développement logiciel (SDK ) à votre projet et la création d’une instance authProvider , consultez la documentation du SDK.

Réponse

Voici un exemple de réponse.

HTTP/1.1 204 No Content