Поделиться через

Вывод списка отчетов о задачах

  • Статья

Пространство имен: microsoft.graph.identityGovernance

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Получение списка объектов taskReport и их свойств.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) LifecycleWorkflows.Read.All LifecycleWorkflows.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение LifecycleWorkflows.Read.All LifecycleWorkflows.ReadWrite.All

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением поддерживаемой роли. Глобальный читатель и администратор рабочих процессов жизненного цикла — это наименее привилегированные роли, поддерживаемые для этой операции.

HTTP-запрос

GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports

Необязательные параметры запросов

Этот метод поддерживает $selectпараметры запроса , $orderby, $expandи $filter OData для настройки ответа. Общие сведения см. в статье Параметры запроса OData.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов microsoft.graph.identityGovernance.taskReport в тексте ответа.

Примеры

Пример 1. Перечисление отчетов о задачах для рабочего процесса

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/14879e66-9ea9-48d0-804d-8fea672d0341/taskReports

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('14879e66-9ea9-48d0-804d-8fea672d0341')/taskReports",
    "@odata.count": 4,
    "value": [
        {
            "id": "3a3bea11-99ca-462d-86fb-d283db8d734a",
            "runId": "dad77a47-6eda-4de7-bc37-fe8eb5aaf17d",
            "processingStatus": "completed",
            "successfulUsersCount": 2,
            "failedUsersCount": 0,
            "unprocessedUsersCount": 0,
            "totalUsersCount": 2,
            "startedDateTime": "2022-08-24T23:28:04.5785337Z",
            "completedDateTime": "2022-08-24T23:28:11.1348863Z",
            "lastUpdatedDateTime": "2022-08-24T23:33:09.1980352Z"
        },
        {
            "id": "23f37fcb-040d-4ee9-91df-1234700ebeb6",
            "runId": "dad77a47-6eda-4de7-bc37-fe8eb5aaf17d",
            "processingStatus": "completed",
            "successfulUsersCount": 2,
            "failedUsersCount": 0,
            "unprocessedUsersCount": 0,
            "totalUsersCount": 2,
            "startedDateTime": "2022-08-24T23:28:04.5861287Z",
            "completedDateTime": "2022-08-24T23:28:11.1348863Z",
            "lastUpdatedDateTime": "2022-08-24T23:33:09.2051571Z"
        },
        {
            "id": "462e6deb-a7b4-4777-a494-389c495862b8",
            "runId": "a512bb50-3423-4bdc-ad5e-9731095b3b9a",
            "processingStatus": "completed",
            "successfulUsersCount": 2,
            "failedUsersCount": 0,
            "unprocessedUsersCount": 0,
            "totalUsersCount": 2,
            "startedDateTime": "2022-08-25T00:15:05.25581Z",
            "completedDateTime": "2022-08-25T00:15:11.8535443Z",
            "lastUpdatedDateTime": "2022-08-25T00:20:05.8759088Z"
        },
        {
            "id": "e3dd0719-a50a-463d-b32d-7176fa4519e4",
            "runId": "a512bb50-3423-4bdc-ad5e-9731095b3b9a",
            "processingStatus": "completed",
            "successfulUsersCount": 2,
            "failedUsersCount": 0,
            "unprocessedUsersCount": 0,
            "totalUsersCount": 2,
            "startedDateTime": "2022-08-25T00:15:05.2771389Z",
            "completedDateTime": "2022-08-25T00:15:11.8535443Z",
            "lastUpdatedDateTime": "2022-08-25T00:20:05.9002556Z"
        }
    ]
}

Пример 2. Перечисление отчетов о задачах для рабочего процесса

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/taskReports?$select=id,failedUsersCount,processingStatus,successfulUsersCount,totalUsersCount,unprocessedUsersCount,taskDefinition,taskProcessingResults

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('15239232-66ed-445b-8292-2f5bbb2eb833')/taskReports(id,failedUsersCount,processingStatus,successfulUsersCount,totalUsersCount,unprocessedUsersCount,taskDefinition,taskProcessingResults)",
    "value": [
        {
            "id": "443c7611-45df-48c0-bf5e-dc6068c402f0",
            "processingStatus": "completed",
            "successfulUsersCount": 1,
            "failedUsersCount": 0,
            "unprocessedUsersCount": 0,
            "totalUsersCount": 1
        },
        {
            "id": "92bbb4a0-3815-48a7-8f83-f5dadc4f6793",
            "processingStatus": "completed",
            "successfulUsersCount": 1,
            "failedUsersCount": 0,
            "unprocessedUsersCount": 0,
            "totalUsersCount": 1
        },
        {
            "id": "d64d2b78-3823-4ec8-b6d3-efd3d41a5e98",
            "processingStatus": "completed",
            "successfulUsersCount": 1,
            "failedUsersCount": 0,
            "unprocessedUsersCount": 0,
            "totalUsersCount": 1
        }
    ]
}