Архивация команды

Пространство имен: microsoft.graph

Архивация указанной команды. При архивации команды пользователь больше не сможет отправлять сообщения в любой канал команды или присваивать сообщениям отметку "Нравится", изменять название команды, описание, другие параметры и в целом вносить большинство изменений в команду. Изменение участия в команде по-прежнему допускается.

Архивация — это асинхронная операция. Команда архивируется после успешного завершения асинхронной операции, которая может выполняться после отклика этого API.

Чтобы архивировать команду, у команды и группы должен быть владелец.

Чтобы восстановить команду из архивированного состояния, используйте API для распаковки.

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All**
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Приложение	TeamSettings.ReadWrite.Group*, TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All**

Примечание.

• Разрешения, отмеченные *, используют согласие для конкретного ресурса.
• Разрешения, помеченные **, поддерживаются только для обратной совместимости. Рекомендуется обновить решения, чтобы использовать другое разрешение, указанное в предыдущей таблице, и избегать использования этих разрешений в будущем.

Примечание. Этот API поддерживает разрешения администратора. Глобальные администраторы и администраторы службы Microsoft Teams могут получать доступ к командам, в которых они не состоят.

HTTP-запрос

POST /teams/{id}/archive

Заголовки запросов

Заголовок	Значение
Авторизация	Носитель {token}. Обязательно.

Текст запроса

В запросе можно при необходимости включить параметр shouldSetSpoSiteReadOnlyForMembers в текст JSON следующим образом.

{
    "shouldSetSpoSiteReadOnlyForMembers": true
}

Этот необязательный параметр определяет, следует ли для участников команды задать разрешения только для чтения на сайте SharePoint Online, связанном с командой. Если присвоить ему значение false или не указать текст, этот этап будет пропущен.

Важно!

Параметр shouldSetSpoSiteReadOnlyForMembers не поддерживается в контексте приложения.

Отклик

Если архивация начата успешно, этот метод возвращает код отклика 202 Accepted. Отклик также будет содержать заголовок Location, в котором указывается расположение ресурса teamsAsyncOperation, созданного для обработки архивации команды. Проверьте состояние операции архивации, выполнив запрос GET для этого расположения.

Пример

Запрос

Ниже приведен пример запроса.

HTTP

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

C#

// Code snippets are only available for the latest version. Current version is 5.x

var graphClient = new GraphServiceClient(requestAdapter);

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

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



graphClient.Teams().ByTeamId("team-id").Archive().Post(context.Background(), nil)

Дополнительные сведения о добавлении пакета 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.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

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

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW FOR THE KIOTA BASED SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($requestAdapter);


$graphServiceClient->teams()->byTeamId('team-id')->archive()->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