synchronizationJob resource type
Namespace: microsoft.graph
Important
APIs under the /beta
version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
Performs synchronization by periodically running in the background, polling for changes in one directory, and pushing them to another directory. The synchronization job is always specific to a particular instance of an application in your tenant. As part of the synchronization job setup, you need to give authorization to read and write objects in your target directory, and customize the job's synchronization schema.
Methods
Method | Return Type | Description |
---|---|---|
List | synchronizationJob collection | List existing jobs for a given application instance (service principal). |
Get | synchronizationJob | Read properties and relationships of a synchronizationJob object. |
Create | synchronizationJob | Create new job for a given application. |
Start | None | Start synchronization. If the job is in a paused state, it continues from the point where the job was paused. If the job is in quarantine, the quarantine status is cleared. |
Restart | None | Force the job to start over and re-process all the objects in the directory. |
Pause | None | Temporarily stop synchronization. All the progress, including job state, is persisted, and the job will continue from where it left off when a Start call is made. |
Delete | None | Stop synchronization, and permanently delete all the state associated with the job. |
Get schema | synchronizationSchema | Retrieve the job's effective synchronization schema. |
Update schema | None | Update the job's synchronization schema. |
Validate credentials | None | Test provided credentials against target directory. |
Provision on demand | synchronizationJobApplicationParameters collection | Represents the objects that will be provisioned and the synchronization rules executed. The resource is primarily used for on-demand provisioning. |
Properties
Property | Type | Description |
---|---|---|
id | String | Unique synchronization job identifier. Read-only. |
schedule | synchronizationSchedule | Schedule used to run the job. Read-only. |
status | synchronizationStatus | Status of the job, which includes when the job was last run, current job state, and errors. |
synchronizationJobSettings | keyValuePair | Settings associated with the job. Some settings are inherited from the template. |
templateId | String | Identifier of the synchronization template this job is based on. |
Relationships
Relationship | Type | Description |
---|---|---|
bulkUpload | bulkUpload | The bulk upload operation for the job. |
schema | synchronizationSchema | The synchronization schema configured for the job. |
JSON representation
The following is a JSON representation of the resource.
{
"id": "String (identifier)",
"schedule": {
"@odata.type": "microsoft.graph.synchronizationSchedule"
},
"status": {
"@odata.type": "microsoft.graph.synchronizationStatus"
},
"synchronizationJobSettings": {
"@odata.type": "microsoft.graph.keyValuePair"
},
"templateId": "String"
}
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla