команда: клонирование
Пространство имен: microsoft.graph
Создайте копию команды. Эта операция также создает копию соответствующей группы. Можно указать, какие части команды следует клонировать:
- 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 | Строка (необязательно) | Описывает классификацию для группы (например, низкий, средний или высокий уровень влияния на бизнес). Если классификация не указана, классификация копируется из исходной команды или группы. |
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/v1.0/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
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по