type de ressource synchronizationJob

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans 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 Version .

Effectue la synchronisation en exécutant régulièrement en arrière-plan, en interrogeant les modifications dans un répertoire et en les poussant vers un autre répertoire. Le travail de synchronisation est toujours spécifique à une instance particulière d’une application dans votre locataire. Dans le cadre de la configuration du travail de synchronisation, vous devez autoriser la lecture et l’écriture d’objets dans votre répertoire cible, et personnaliser le schéma de synchronisation du travail.

Méthodes

Méthode Type renvoyé Description
List synchronizationJob, collection Répertorier les travaux existants pour une instance d’application donnée (principal de service).
Obtenir synchronizationJob Lit les propriétés et les relations d’un objet synchronizationJob.
Create synchronizationJob Créez un travail pour une application donnée.
Start Aucune Démarrez la synchronisation. Si le travail est dans un état suspendu, il continue à partir du point où le travail a été suspendu. Si le travail est en quarantaine, l’état de la quarantaine est effacé.
Pause Aucune Arrêt temporaire de la synchronisation. Toute la progression, y compris l’état du travail, est persistante et le travail continue là où il s’est arrêté lorsqu’un appel de démarrage est effectué.
Restart Aucune Forcez le travail à recommencer et à traiter à nouveau tous les objets du répertoire.
Supprimer Aucune Arrêtez la synchronisation et supprimez définitivement tous les états associés au travail.
Provisionner à la demande collection synchronizationJobApplicationParameters Représente les objets qui seront provisionnés et les règles de synchronisation exécutées. La ressource est principalement utilisée pour l’approvisionnement à la demande.
Valider les informations d’identification Aucune Testez les informations d’identification fournies par rapport au répertoire cible.

Propriétés

Propriété Type Description
id Chaîne Identificateur unique du travail de synchronisation. En lecture seule.
planifier synchronizationSchedule Planification utilisée pour exécuter le travail. En lecture seule.
status synchronizationStatus État du travail, qui inclut la date de la dernière exécution du travail, l’état actuel du travail et les erreurs.
synchronizationJobSettings keyValuePair Paramètres associés au travail. Certains paramètres sont hérités du modèle.
templateId Chaîne Identificateur du modèle de synchronisation sur lequel ce travail est basé.

Relations

Relation Type Description
bulkUpload bulkUpload Opération de chargement en bloc pour le travail.
schéma synchronizationSchema Schéma de synchronisation configuré pour le travail.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "id": "String (identifier)",
  "schedule": {
    "@odata.type": "microsoft.graph.synchronizationSchedule"
  },
  "status": {
    "@odata.type": "microsoft.graph.synchronizationStatus"
  },
  "synchronizationJobSettings": {
    "@odata.type": "microsoft.graph.keyValuePair"
  },
  "templateId": "String"
}