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

Обновление shiftsRoleDefinition

  • Статья

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

Важно!

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

Обновление объекта shiftsRoleDefinition .

Разрешения

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

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

HTTP-запрос

PATCH /team/{teamId}/schedule/shiftsRoleDefinitions/{roleId}

Параметры пути

Параметр Тип Описание
teamId string Идентификатор команды для задания определений ролей.
roleId string Затронутая роль. Текущими поддерживаемыми значениями являются teamowner и scheduleowner.

Поддерживаемые значения для roleId

Имя Описание
scheduleOwner Задает определения для владельца расписания.
teamOwner Задает определения для владельца команды.

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.
MS-APP-ACTS-AS Идентификатор пользователя (GUID). Требуется только в том случае, если маркер авторизации является маркером приложения; В противном случае — необязательно.

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

В тексте запроса укажите представление объекта shiftsRoleDefinition в формате JSON.

При создании или обновлении shiftsRoleDefinition можно указать следующие свойства.

Свойство Тип Описание
shiftsRolePermissions коллекция microsoft.graph.shiftsRolePermission Содержит определение разрешений роли в роли. Обязательно.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content. Он не возвращает ничего в теле ответа.

Примеры

Пример 1. Установка разрешений для владельца расписания

Запрос

В следующем примере показан запрос, который позволяет изменять группы планирования и причины отгула владельцами расписаний.

PATCH https://graph.microsoft.com/beta/team/10c2c1cc-6384-48f6-aeba-ef7486344550/schedule/shiftsRoleDefinitions/scheduleowner
Content-Type: application/json

{
  "shiftsRolePermissions": [
    {
      "allowedResourceActions": [
        "CanModifySchedulingGroups",
        "CanModifyTimeOffReasons"
      ]
    }
  ]
}

Отклик

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

HTTP/1.1 204 No Content

Пример 2. Отключение всех разрешений для владельца расписания

Запрос

В следующем примере показан запрос, который отключает все разрешения путем передачи пустой коллекции в качестве значения для allowedResourceActions.

PATCH https://graph.microsoft.com/beta/team/10c2c1cc-6384-48f6-aeba-ef7486344550/schedule/shiftsRoleDefinitions/scheduleowner
Content-Type: application/json

{
  "shiftsRolePermissions": [
    {
      "allowedResourceActions": []
    }
  ]
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content