名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
fileStorageContainer 内の特定のジョブの移行イベントの一覧を取得します。 移行イベントは 4 日間有効であり、有効期間内に必要な頻度でクエリを実行できます。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | FileStorageContainer.Selected | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | FileStorageContainer.Selected | 注意事項なし。 |
HTTP 要求
GET /storage/fileStorage/containers/{fileStorageContainerId}/migrationJobs/{migrationJobId}/progressEvents
オプションのクエリ パラメーター
このメソッドは、 $skipToken OData クエリ パラメーターをサポートし、結果のページ分割に役立ちます。 一般的な情報については、「OData クエリ パラメーター」を参照してください。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文の sharePointMigrationEvent オブジェクトのコレクションを返します。
例
要求
次の例は、コンテナー ID b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Zによって識別される fileStorageContainer で実行される ID 7b04bfdd-5f8c-4bd9-97faa166a7922c61によって識別される sharePointMigrationJob に関連する sharePointMigrationEvent インスタンスの一覧を取得する方法を示しています。
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/migrationJobs/7b04bfdd-5f8c-4bd9-97faa166a7922c61/progressEvents
応答
次の例は応答を示しています。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.sharePointMigrationJobStartEvent",
"id": "ef788cc0-ff2c-02a7-5150-7aeb53a89445",
"jobId": "7b04bfdd-5f8c-4bd9-97fa-a166a7922c61",
"eventDateTime": "2025-05-08T09:08:04.451Z",
"correlationId": "3f24ae21-8e47-4147-aa3d-31ce6b675337",
"isRestarted": false,
"totalRetryCount": 0
},
{
"@odata.type": "#microsoft.graph.sharePointMigrationJobCancelledEvent",
"id": "8ae8a944-1d91-4e16-3447-0e31ba915e1f",
"jobId": "7b04bfdd-5f8c-4bd9-97fa-a166a7922c61",
"eventDateTime": "2025-05-08T09:13:18.333Z",
"correlationId": "3f24ae21-8e47-4147-aa3d-31ce6b675337",
"totalRetryCount": 0,
"isCancelledByUser": true
},
{
"@odata.type": "#microsoft.graph.sharePointMigrationJobProgressEvent",
"id": "e439f60c-1022-4eaa-dbbf-75c51361effe",
"jobId": "7b04bfdd-5f8c-4bd9-97fa-a166a7922c61",
"eventDateTime": "2025-05-08T09:13:45.565Z",
"correlationId": "3f24ae21-8e47-4147-aa3d-31ce6b675337",
"isCompleted": false,
"filesProcessed": 12,
"bytesProcessed": 12,
"objectsProcessed": 23,
"totalExpectedObjects": 15,
"totalErrors": 1,
"totalWarnings": 0,
"totalRetryCount": 0,
"waitTimeOnSqlThrottlingMs": 0,
"totalDurationMs": 0,
"cpuDurationMs": 0,
"sqlDurationMs": 0,
"sqlQueryCount": 0,
"totalExpectedBytes": 0,
"filesProcessedOnlyCurrentVersion": 11,
"bytesProcessedOnlyCurrentVersion": 11
},
{
"@odata.type": "#microsoft.graph.sharePointMigrationJobErrorEvent",
"id": "8e37738c-76b2-bb16-346a-5b21cff6d1d0",
"jobId": "7b04bfdd-5f8c-4bd9-97fa-a166a7922c61",
"eventDateTime": "2025-05-08T09:13:46.028Z",
"correlationId": "3f24ae21-8e47-4147-aa3d-31ce6b675337",
"errorLevel": "FatalError",
"totalRetryCount": 0,
"objectType": "UnknownFutureValue",
"error":
{
"code": "-2147213196",
"errorType": "microsoft.SharePoint.SPException",
"message": "Operation canceled."
}
},
{
"@odata.type": "#microsoft.graph.sharePointMigrationJobProgressEvent",
"id": "16ea963f-b78d-5016-e8b7-3c663ca30fd5",
"jobId": "7b04bfdd-5f8c-4bd9-97fa-a166a7922c61",
"eventDateTime": "2025-05-08T09:13:46.509Z",
"correlationId": "3f24ae21-8e47-4147-aa3d-31ce6b675337",
"isCompleted": true,
"filesProcessed": 12,
"bytesProcessed": 12,
"objectsProcessed": 24,
"totalExpectedObjects": 15,
"totalErrors": 2,
"totalWarnings": 0,
"totalRetryCount": 0,
"waitTimeOnSqlThrottlingMs": 0,
"totalDurationMs": 0,
"cpuDurationMs": 0,
"sqlDurationMs": 0,
"sqlQueryCount": 0,
"totalExpectedBytes": 0,
"filesProcessedOnlyCurrentVersion": 12,
"bytesProcessedOnlyCurrentVersion": 12
}
],
"@odata.nextLink": "https://graph.microsoft.com/beta/storage/fileStorage/containers/{fileStorageContainerId}/migrationJobs/{migrationJobId}/progressEvents?$skiptoken=ODY4MA"
}