callRecord: getPstnBlockedUsersLog

  • Статья

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

Важно!

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

Получите журнал пользователей, которым заблокировано или запрещено совершать звонки по телефонной сети общего пользования (ТСОП) в Microsoft Teams, в виде коллекции записей pstnBlockedUsersLogRow . Журнал содержит сведения о каждом заблокированном пользователе, например его назначенный номер телефона и причину, по которой он был заблокирован или разблокирован для совершения звонков.

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

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

Разрешения

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

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

HTTP-запрос

GET /communications/callRecords/getPstnBlockedUsersLog(fromDateTime={fromDateTime},toDateTime={toDateTime})

Параметры функции

В URL-адресе запроса укажите перечисленные ниже параметры запроса и их значения.

Параметр Тип Описание
fromDateTime DateTimeOffset Начало диапазона времени для запроса. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Обязательный.
toDateTime DateTimeOffset Конец диапазона времени для запроса. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Обязательный.

Важно!

Значения fromDateTime и toDateTime не могут превышать диапазон дат в 90 дней.

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

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

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

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

Отклик

В случае успешного 200 OK выполнения эта функция возвращает код отклика и коллекцию записей microsoft.graph.callRecords.pstnBlockedUsersLogRow в тексте ответа.

Если функция возвращает более 1000 записей для указанного диапазона дат, текст также включает @odata.nextLink с URL-адресом для запроса следующей страницы записей. Последняя страница в диапазоне дат не имеет @odata.nextLink. Дополнительные сведения см. в разделе Разбиение данных Microsoft Graph в приложении по страницам.

Пример

В следующем примере показано, как получить коллекцию записей для пользователей, заблокированных ТСОП, которые произошли в указанном диапазоне дат. Ответ включает "@odata.count": 1000 перечисление количества записей в первом ответе и значение для @odata.nextLink получения записей, превышающих первые 1000. Для удобства чтения объект ответа содержит только коллекцию из двух записей.

Запрос

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

GET https://graph.microsoft.com/beta/communications/callRecords/getPstnBlockedUsersLog(fromDateTime=2022-11-01,toDateTime=2022-12-01)

Отклик

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

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.callRecords.pstnBlockedUsersLogRow)",
    "@odata.count": 1000,
    "@odata.nextLink": "https://graph.microsoft.com/beta/communications/callRecords/getPstnBlockedUsersLog(fromDateTime=2022-11-01,toDateTime=2022-12-01)?$skip=1000",
    "value": [
        {
            "userId": "76efb13c-64ba-4305-9149-4e8f854004a9",
            "userPrincipalName": "andre.lawson@contoso.com",
            "userDisplayName": "Andre Lawson",
            "blockDateTime": "2022-11-23T13:51:09.796Z",
            "userTelephoneNumber": "+37212345678",
            "userBlockMode": "Blocked",
            "blockReason": "High Overall Usage",
            "remediationId": "c98e1515-a937-4b81-b8a8-3992afde64e0",
        },
        {
            "userId": "76efb13c-64ba-4305-9149-4e8f854004a9",
            "userPrincipalName": "ruwini.perera@contoso.com",
            "userDisplayName": "Ruwini Perera",
            "blockDateTime": "2022-11-23T13:51:09.796Z",
            "userTelephoneNumber": "+37212345678",
            "userBlockMode": "Unblocked",
            "blockReason": "Tenant Requested",
            "remediationId": "c98e1515-a937-4b81-b8a8-3992afde64e0",
        }
    ]
}

Связанные материалы