type de ressource synchronizationJob
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"
}