使用英语阅读

通过


团队:克隆

命名空间:microsoft.graph

创建 团队的副本。 此操作还会创建相应 的副本。 可以指定要克隆团队的哪些部分:

  • 应用 - 复制团队中安装的 Microsoft Teams 应用。
  • 通道 – 复制通道结构 (但不复制通道) 中的消息。
  • members – 复制组的成员和所有者。
  • settings – 复制团队中的所有设置以及密钥组设置。
  • 选项卡 – 复制通道中的选项卡。

备注

组织范围的团队不支持此方法。

备注

与克隆团队所有者相关的已知问题与此方法相关联。 有关详细信息,请参阅已知问题

克隆选项卡时,不会配置它们。 选项卡显示在 Microsoft Teams 中的选项卡栏上,用户第一次打开它们时,必须浏览配置屏幕。 如果打开选项卡的用户没有配置应用的权限,他们会看到一条消息,指出未配置选项卡。

克隆是一项长时间运行的操作。 POST 克隆返回后,需要获取标头返回Location:的操作,以查看它是 runningsucceeded还是 failed。 应继续获取,直到状态不 running为 。 建议在 GET 之间延迟 5 秒。

此 API 可用于以下国家级云部署

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) Team.Create Directory.ReadWrite.All、Group.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 Team.Create Directory.ReadWrite.All、Group.ReadWrite.All

备注

仅出于向后兼容性而支持 Group.ReadWrite.All 和 Directory.ReadWrite.All。 建议更新解决方案,以使用上表中列出的替代权限,并避免今后使用这些权限。

HTTP 请求

POST /teams/{id}/clone

请求标头

标头
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权
Content-Type application/json

请求正文

属性 类型 说明
classification 字符串 (可选) 描述组 (的分类,例如低、中或高业务影响) 。 如果未指定分类,则会从原始团队/组复制分类。
说明 字符串 (可选) 可选的组说明。 如果未指定此属性,则将其留空。
displayName String 组的显示名称。 创建组时,此属性是必需的,在更新期间无法清除该属性。 支持 $filter 和 $orderby。
mailNickname String 组的邮件别名,在组织中是唯一的。 创建组时必须指定此属性。 支持 filter。 如果未指定此属性,则从 displayName 进行计算。 此属性当前被忽略。
partsToClone clonableTeamParts 要克隆的部件的逗号分隔列表。 法律部分是“应用、选项卡、设置、频道、成员”。
visibility teamVisibilityType (可选) 指定组的可见性。 可能的值为: PrivatePublic。 如果未指定可见性,则会从原始团队/组复制可见性。 如果克隆的团队是 educationClass 团队,则忽略可见性参数,并且新组的可见性将设置为 HiddenMembership。

备注

如果未在请求正文中指定 description 属性,它将从请求有效负载中获取 displayName 属性的值。

响应

如果成功,此方法返回响应代码, 202 Accepted 其中包含指向 操作 资源的 Location: 标头。 操作完成后,操作资源会告知已创建团队的 ID。

示例

请求

以下示例显示了一个请求。

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 特定于服务的节流限制