存档团队
本文内容
命名空间:microsoft.graph
将指定团队 存档。存档团队后,用户将无法再在团队中的任意频道中发送或点赞消息,无法再编辑团队名称、说明和其他设置,且通常也无法再对团队进行大部分更改。将继续允许对团队进行成员身份更改。
存档是异步操作。该异步操作成功完成后,团队即已存档,此 API 作出响应后就可能出现此情况。
要存档团队,团队和 组 必须具有一个所有者。
要从存档状态还原团队,请使用 API 取消存档 。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限 。
权限类型
权限(从最低特权到最高特权)
委派(工作或学校帐户)
TeamSettings.ReadWrite.All,Group.ReadWrite.All ,Directory.ReadWrite.All
委派(个人 Microsoft 帐户)
不支持。
应用程序
TeamSettings.ReadWrite.Group 、TeamSettings.ReadWrite.All、Group.ReadWrite.All *、Directory.ReadWrite.All**
注意 :
标记为 * 的权限使用 特定于资源的许可 。
只有向后兼容性才支持使用 ** 标记的权限。 建议更新解决方案,以使用上表中列出的替代权限,并避免今后使用这些权限。
注意 :此 API 支持管理员权限。全局管理员和 Microsoft Teams 服务管理员可以访问自己不是其中成员的团队。
HTTP 请求
POST /teams/{id}/archive
标头
值
Authorization
Bearer {token}。必需。
请求正文
在请求中,可 选择性地 在 JSON 正文中包括 shouldSetSpoSiteReadOnlyForMembers
参数,如下所示。
{
"shouldSetSpoSiteReadOnlyForMembers": true
}
此可选参数定义了是否在与团队关联的 SharePoint Online 网站上将团队成员的权限设置为“只读”。 如果将其设置为 false 或完全省略正文,将导致跳过此步骤。
重要
应用程序上下文不支持 shouldSetSpoSiteReadOnlyForMembers
参数。
响应
如果成功开始存档,此方法将返回一个 202 Accepted
响应代码。 响应还将包含一个 Location
标头,后者包含创建用于处理团队存档操作的 teamsAsyncOperation 的位置。 可通过向此位置发出 GET 请求,查看存档操作的状态。
示例
请求
请求示例如下所示。
POST https://graph.microsoft.com/v1.0/teams/{id}/archive
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
await graphClient.Teams["{team-id}"]
.Archive(null)
.Request()
.PostAsync();
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/teams/{id}/archive')
.post();
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/teams/{id}/archive"]]];
[urlRequest setHTTPMethod:@"POST"];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
graphClient.teams("{id}")
.archive(TeamArchiveParameterSet
.newBuilder()
.withShouldSetSpoSiteReadOnlyForMembers(null)
.build())
.buildRequest()
.post();
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
teamId := "team-id"
graphClient.TeamsById(&teamId).Archive(team-id).Post()
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档 。
响应
响应示例如下所示。
HTTP/1.1 202 Accepted
Location: /teams({id})/operations({opId})
Content-Type: text/plain
Content-Length: 0