存档团队

命名空间：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 请求，查看存档操作的状态。

示例

请求

请求示例如下所示。

HTTP

POST https://graph.microsoft.com/v1.0/teams/{id}/archive

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

await graphClient.Teams["{team-id}"]
    .Archive(null)
    .Request()
    .PostAsync();

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

await client.api('/teams/{id}/archive')
    .post();

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

Objective-C

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 文档。

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

graphClient.teams("{id}")
    .archive(TeamArchiveParameterSet
        .newBuilder()
        .withShouldSetSpoSiteReadOnlyForMembers(null)
        .build())
    .buildRequest()
    .post();

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

Go

//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 文档。

PowerShell

Import-Module Microsoft.Graph.Teams

Invoke-MgArchiveTeam -TeamId $teamId

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

响应

响应示例如下所示。

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