Archivar equipo

Espacio de nombres: microsoft.graph

Archivar el equipo especificado. Cuando se archiva un equipo, los usuarios pierden la capacidad de enviar mensajes o marcarlos como me gusta en cualquier canal del equipo, de editar el nombre del equipo, su descripción y otras opciones de configuración y, en general, de realizar todo tipo de cambios en el equipo. Podrán seguir realizando cambios de pertenencia al equipo.

Archivar es una operación asincrónica. Un equipo se archiva una vez que la operación asincrónica se completa correctamente, lo cual puede producirse con posterioridad a una respuesta de la API.

Para archivar un equipo, el equipo y el grupo deben tener un propietario.

Para restaurar un equipo de su estado archivado, use la API para desarchivar.

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All**
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	TeamSettings.ReadWrite.Group*, TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All**

Notas:

• Los permisos marcados con * usan el consentimiento específico del recurso.
• Los permisos marcados con ** solo se admiten para la compatibilidad con versiones anteriores. Se recomienda actualizar las soluciones para usar un permiso alternativo enumerado en la tabla anterior y así evitar el uso de estos permisos en el futuro.

Nota: esta API admite permisos de administrador. Los administradores globales y de servicios de Microsoft Teams pueden acceder a los equipos de los que no son miembros.

Solicitud HTTP

POST /teams/{id}/archive

Encabezados de solicitud

Encabezado	Valor
Authorization	{token} de portador. Obligatorio.

Cuerpo de la solicitud

En la solicitud, opcionalmente puede incluir el parámetro shouldSetSpoSiteReadOnlyForMembers en un cuerpo JSON, como se indica a continuación.

{
    "shouldSetSpoSiteReadOnlyForMembers": true
}

Este parámetro opcional define si se deben establecer permisos de solo lectura para los miembros del equipo en el sitio de SharePoint Online asociado con el equipo. Si se establece en falso o se omite el cuerpo por completo, se omitirá este paso.

Importante

El parámetro shouldSetSpoSiteReadOnlyForMembers no es compatible con el contexto de la aplicación.

Respuesta

Si el archivado se inicia correctamente, este método devuelve un código de respuesta 202 Accepted. La respuesta también contiene un encabezado Location, que contiene la ubicación de la teamsAsyncOperation, creada para controlar el archivado del equipo. Compruebe el estado de la operación de archivado mediante una solicitud GET a esta ubicación.

Ejemplo

Solicitud

A continuación se muestra un ejemplo de una solicitud.

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);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

CLI

// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc teams archive post --team-id {team-id}

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Ir

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)

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Java

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

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

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

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

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

PHP

<?php

// THIS SNIPPET IS A PREVIEW VERSION OF THE SDK. NON-PRODUCTION USE ONLY
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->teams()->byTeamId('team-id')->archive()->post()->wait();

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

PowerShell

Import-Module Microsoft.Graph.Teams

Invoke-MgArchiveTeam -TeamId $teamId

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Python

# THE PYTHON SDK IS IN PREVIEW. FOR NON-PRODUCTION USE ONLY

graph_client = GraphServiceClient(request_adapter)


await graph_client.teams.by_team_id('team-id').archive.post()

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

Aquí tiene un ejemplo de una respuesta.

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