Вывод списка объектов trainingCampaign

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

Важно!

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

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

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

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

Разрешения

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

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

HTTP-запрос

GET /security/attackSimulation/trainingCampaigns

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

Этот метод поддерживает $countпараметры запроса OData , $filter$orderby, $skipToken, , $topи $select для настройки ответа. Параметры запроса и $orderby можно использовать $filter в свойствах campaignSchedule/completionDateTime, displayName, campaignSchedule/launchDateTime и campaignSchedule/status.

Если результирующий набор охватывает несколько страниц, текст ответа содержит @odata.nextLink объект , который можно использовать для страницы в результирующем наборе.

В следующем списке приведены некоторые примеры запросов, использующих поддерживаемые параметры запроса OData.

GET /security/attackSimulation/trainingCampaigns?$count=true
GET /security/attackSimulation/trainingCampaigns?$filter={property} eq '{property-value}'
GET /security/attackSimulation/trainingCampaigns?$filter={property} eq '{property-value}'&$top=5
GET /security/attackSimulation/trainingCampaigns?$orderby={property}
GET /security/attackSimulation/trainingCampaigns?$skipToken={skipToken}
GET /security/attackSimulation/trainingCampaigns?$top=1
GET /security/attackSimulation/trainingCampaigns?$select={property}

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

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

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

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

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/security/attackSimulation/trainingCampaigns

Отклик

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

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

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

{
    "value": [
        {
            "@odata.etag": "W/\"dub9zfj4Rk68MmY/KYwXKgADRgyGsw==\"",
            "id": "81c59451-2929-5b39-86f0-5a2b15f1314f",
            "displayName": "Sample Training Campaign",
            "description": "Sample Training Campaign Description",
            "createdDateTime": "2024-02-18T08:36:07.6534871Z",
            "lastModifiedDateTime": "2024-02-19T08:00:01.9417887Z",
            "endUserNotificationSetting": null,
            "includedAccountTarget": null,
            "excludedAccountTarget": null,
            "trainingSetting": null,
            "campaignSchedule": {
                "launchDateTime": "2024-02-18T08:37:44Z",
                "completionDateTime": "2024-02-19T07:59:44Z",
                "status": "completed"
            },
            "createdBy": {
              "id": "99af58b9-ef1a-412b-a581-cb42fe8c8e21",
              "displayName": "Reed Flores",
              "email": "reed@contoso.com"
            },
            "lastModifiedBy": {
              "id": "99af58b9-ef1a-412b-a581-cb42fe8c8e21",
              "displayName": "Reed Flores",
              "email": "reed@contoso.com"
            },
        }
    ]
}
  • Last updated on