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 permisos siguientes 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**

Nota:

  • 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 Portador {token}. 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.

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

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