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


Создание или замена расписания

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

Создание или замена объекта schedule .

Процесс создания расписания соответствует руководству One API для длительных операций на основе ресурсов (RELO). Если клиенты используют метод PUT, при подготовке расписания операция заменяет расписание; В противном случае операция запускает процесс подготовки расписания в фоновом режиме.

Во время подготовки по расписанию клиенты могут использовать метод GET , чтобы получить расписание и просмотреть provisionStatus текущее состояние подготовки в свойстве. Если подготовка завершилась сбоем, клиенты могут получить дополнительные сведения из provisionStatusCode свойства .

Клиенты также могут проверить конфигурацию расписания.

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

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

Разрешения

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

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

HTTP-запрос

PUT /teams/{teamId}/schedule

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

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

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

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

Отклик

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

Пример

Запрос

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

PUT https://graph.microsoft.com/v1.0/teams/{teamId}/schedule
Content-type: application/json

{
  "enabled": true,
  "timeZone": "America/Chicago"
}

Отклик

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

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

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

{
  "id": "833fc4df-c88b-4398-992f-d8afcfe41df2",
  "enabled": true,
  "timeZone": "America/Chicago",
  "provisionStatus": "Completed",
  "provisionStatusCode": null,
  "timeClockEnabled": true,
  "openShiftsEnabled": true,
  "swapShiftsRequestsEnabled": true,
  "offerShiftRequestsEnabled": true,
  "timeOffRequestsEnabled": true
}

Ограничения регулирования для служб, связанных с Microsoft Graph