Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: 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 | Directory.ReadWrite.All, Group.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | Team.Create | Directory.ReadWrite.All, Group.ReadWrite.All |
Примечание.
Разрешения 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