Team archivierenArchive team

Archivieren Sie das angegebene Team.Archive the specified team. Wenn ein Team archiviert wird, können die Benutzer auf keinem der Kanäle des Teams Nachrichten versenden oder diese mit „Gefällt mir“ kommentieren, sie können den Namen, die Beschreibung oder sonstige Einstellungen nicht ändern und im Allgemeinen können Sie die meisten Änderungen am Team nicht vornehmen.When a team is archived, users can no longer send or like messages on any channel in the team, edit the team's name, description, or other settings, or in general make most changes to the team. Änderungen an der Mitgliedschaft in dem Team sind weiterhin zulässig.Membership changes to the team continue to be allowed.

Die Archivierung ist ein asynchroner Vorgang.Archiving is an async operation. Ein Team wird archiviert sobald der asynchrone Vorgang erfolgreich abgeschlossen, das nach einer Antwort von dieser API auftreten könnte.A team is archived once the async operation completes successfully, which may occur subsequent to a response from this API.

Um ein Team zu archivieren, müssen das Team und die Gruppe einen Besitzer haben.In order to archive team, the team and group must have an owner.

Um ein Team aus dem Zustand „archiviert“ wieder herzustellen, verwenden Sie die API, um die Archivierung aufzuheben.To restore a team from its archived state, use the API to unarchive.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Group.ReadWrite.AllGroup.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Group.ReadWrite.AllGroup.ReadWrite.All

Hinweis: Diese API unterstützt Administratorberechtigungen.Note: This API supports admin permissions. Globale Administratoren und Microsoft Teams-Dienstadministratoren können auf Teams zugreifen, in denen sie kein Mitglied sind.Global admins and Microsoft Teams service admins can access teams that they are not a member of.

HTTP-AnforderungHTTP request

POST /teams/{id}/archive

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

In der Anforderung können Sie optional den Parameter shouldSetSpoSiteReadOnlyForMembers in einem JSON-Nachrichtentext wie unten beschrieben hinzufügen.In the request, you may optionally include the shouldSetSpoSiteReadOnlyForMembers parameter in a JSON body, as follows.

{
    "shouldSetSpoSiteReadOnlyForMembers": true
}

Dieser optionale Parameter gibt an, ob die Berechtigungen der Teammitglieder auf der Sharepoint Online-Seite, die mit dem Team verknüpft ist, in „Schreibgeschützt“ geändert werden.This optional parameter defines whether to set permissions for team members to read-only on the Sharepoint Online site associated with the team. Wenn Sie ihn auf „false“ festlegen oder wenn Sie den Nachrichtentext einfach weglassen, wird dieser Schritt übersprungen.Setting it to false or omitting the body altogether will result in this step being skipped.

AntwortResponse

Wenn die Archivierung erfolgreich gestartet wird, gibt diese Methode eine 202 Accepted Antwortcode.If archiving is started successfully, this method returns a 202 Accepted response code. Die Antwort enthält außerdem eine Location Kopfzeile, die den Speicherort von TeamsAsyncOperation enthält, der zur Verarbeitung der Teamarchivierung erstellt wurde.The response will also contain a Location header, which contains the location of the teamsAsyncOperation that was created to handle archiving of the team. Überprüfen Sie den Status des Archivierungsvorgangs, indem Sie eine GET-Anforderung an diesen Speicherort stellen.Check the status of the archiving operation by making a GET request to this location.

BeispielExample

AnforderungRequest

Nachfolgend ist ein Beispiel für eine Anforderung dargestellt.The following is an example of a request.

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

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort einer Anforderung.The following is an example of a response.

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