名前空間: microsoft.graph
バックグラウンドで定期的に実行し、あるディレクトリの変更をポーリングし、別のディレクトリにプッシュすることで同期を実行します。 同期ジョブは、常にテナント内のアプリケーションの特定のインスタンスに固有です。 同期ジョブのセットアップの一環として、ターゲット ディレクトリ内のオブジェクトの読み取りと書き込みを許可し、ジョブの同期スキーマをカスタマイズする必要があります。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | synchronizationJob コレクション | 特定のアプリケーション インスタンス (サービス プリンシパル) の既存のジョブを一覧表示します。 |
| Get | synchronizationJob | synchronizationJob オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Create | synchronizationJob | 特定のアプリケーションの新しいジョブを作成します。 |
| Start | なし | 同期を開始します。 ジョブが一時停止状態の場合は、ジョブが一時停止された時点から続行されます。 ジョブが検疫中の場合、検疫の状態はクリアされます。 |
| Pause | なし | 同期を一時的に停止します。 ジョブの状態を含むすべての進行状況が保持され、 Start 呼び出しが行われたときにジョブが中断された場所からジョブが続行されます。 |
| Restart | なし | ジョブを強制的にやり直し、ディレクトリ内のすべてのオブジェクトを再処理します。 |
| Delete | なし | 同期を停止し、ジョブに関連付けられているすべての状態を完全に削除します。 |
| オンデマンドプロビジョニング | synchronizationJobApplicationParameters コレクション | プロビジョニングされるオブジェクトと、実行される同期規則を表します。 このリソースは、主にオンデマンド プロビジョニングに使用されます。 |
| 資格情報を検証する | なし | ターゲット ディレクトリに対して指定された資格情報をテストします。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | 一意の同期ジョブ識別子。 読み取り専用です。 |
| schedule | synchronizationSchedule | ジョブの実行に使用されるスケジュール。 読み取り専用です。 |
| status | synchronizationStatus | ジョブの状態。ジョブが最後に実行されたとき、現在のジョブの状態、エラーが含まれます。 |
| synchronizationJobSettings | keyValuePair | ジョブに関連付けられている設定。 一部の設定はテンプレートから継承されます。 |
| templateId | String | このジョブが基になっている 同期テンプレート の識別子。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| bulkUpload | bulkUpload | ジョブの一括アップロード操作。 |
| スキーマ | synchronizationSchema | ジョブ用に構成された同期スキーマ。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"id": "String (identifier)",
"schedule": {
"@odata.type": "microsoft.graph.synchronizationSchedule"
},
"status": {
"@odata.type": "microsoft.graph.synchronizationStatus"
},
"synchronizationJobSettings": {
"@odata.type": "microsoft.graph.keyValuePair"
},
"templateId": "String"
}