команда: клонирование

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

Важно!

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

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

  • apps — копирует приложения Microsoft Teams, установленные в команде.
  • channels — копирует структуру канала (но не сообщения в канале).
  • members — копирует участников и владельцев группы.
  • settings — копирует все параметры в команде, а также параметры группы ключей.
  • tabs — копирует вкладки в каналах.

Примечание: Этот метод не поддерживается для команд на уровне организации.

Примечание.

С этим методом связана известная проблема, связанная с владельцами клонированных команд. Дополнительные сведения см. в статье Известные проблемы.

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

Клонирование — это длительная операция. После возврата клона POST необходимо получить операцию , возвращаемую заголовком Location: , чтобы узнать, является runningли она , succeededили failed. Вы должны продолжать GET, пока состояние не runningбудет равно . Рекомендуемая задержка между ГЕТ составляет 5 секунд.

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

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

Разрешения

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

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

Примечание. Разрешения, отмеченные **, поддерживаются только для обратной совместимости. Рекомендуется обновить решения, чтобы использовать другое разрешение, указанное в предыдущей таблице, и избегать использования этих разрешений в будущем.

HTTP-запрос

POST /teams/{id}/clone

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

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json

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

Свойство Тип Описание
classification Строка (необязательно) Описывает классификацию для группы (например, низкий, средний или высокий уровень влияния на бизнес). Допустимые значения для этого свойства определяются путем создания значения параметра ClassificationList на основе определения шаблона. Если классификация не указана, классификация копируется из исходной команды или группы.
description Строка (необязательно) Необязательное описание для группы. Если это свойство не указано, оно остается пустым.
displayName String Отображаемое имя для группы. Это свойство является обязательным при создании группы и ее невозможно очистить во время обновлений. Поддерживает параметры $filter и $orderby.
mailNickname String Почтовый псевдоним для группы (уникальный в организации). Это свойство должно быть указано при создании группы. Поддерживает параметр $filter. Если это свойство не указано, оно вычисляется из displayName. Известная проблема: это свойство в настоящее время игнорируется.
partsToClone clonableTeamParts Разделенный запятыми список частей для клонирования. Юридическими частями являются "приложения, вкладки, параметры, каналы, участники".
visibility teamVisibilityType (необязательно) Указывает видимость группы. Возможные значения: Private, Public. Если видимость не указана, видимость копируется из исходной команды или группы. Если клонируется команда educationClass , параметр видимости игнорируется, а видимость новой группы будет иметь значение HiddenMembership.

Примечание.

Если свойство description не указано в тексте запроса, оно принимает значение свойства displayName из полезных данных запроса.

Отклик

В случае успешного 202 Accepted выполнения этот метод возвращает код ответа с заголовком Location: , указывающим на ресурс операции . После завершения операции ресурс операции сообщает идентификатор созданной команды.

Пример

Запрос

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

POST https://graph.microsoft.com/beta/teams/{id}/clone
Content-Type: application/json

{  
     "displayName": "Library Assist",
     "description": "Self help community for library",
     "mailNickname": "libassist",
     "partsToClone": "apps,tabs,settings,channels,members",
     "visibility": "public"
}

Отклик

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

HTTP/1.1 202 Accepted
Location: /teams({id})/operations({opId})
Content-Type: text/plain
Content-Length: 0

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