チームをアーカイブするArchive team

指定されたチームをアーカイブします。Archive the specified team. チームをアーカイブすると、ユーザーはチームのチャネルでメッセージを送信したり、いいねしたり、チームの名前、説明、またはその他の設定、通常、チームへの変更がほとんどできなくなります。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. チームへのメンバーシップの変更はそのまま許可されます。Membership changes to the team continue to be allowed.

アーカイブは非同期操作です。Archiving is an async operation. 非同期操作が正常に完了すると、チームがアーカイブされます。この API の応答に続いて発生する可能性があります。A team is archived once the async operation completes successfully, which may occur subsequent to a response from this API.

チームをアーカイブできるのは、チームとグループが所有者の場合です。In order to archive team, the team and group must have an owner.

アーカイブした状態からチームを復元するには、API を使用してアーカイブを解除します。To restore a team from its archived state, use the API to unarchive.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Group.ReadWrite.AllGroup.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication Group.ReadWrite.AllGroup.ReadWrite.All

: この API は、管理者のアクセス許可をサポートします。Note: This API supports admin permissions. グローバル管理者と Microsoft Teams サービス管理者は、メンバーではないチームにアクセスできます。Global admins and Microsoft Teams service admins can access teams that they are not a member of.

HTTP 要求HTTP request

POST /teams/{id}/archive

要求ヘッダーRequest headers

ヘッダーHeader Value
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.

要求本文Request body

次のように、リクエストでは_オプションで_ JSON の本文にshouldSetSpoSiteReadOnlyForMembersパラメーターを入力できます。In the request, you may optionally include the shouldSetSpoSiteReadOnlyForMembers parameter in a JSON body, as follows.

{
    "shouldSetSpoSiteReadOnlyForMembers": true
}

このオプションのパラメーターは、チーム メンバーのアクセス許可を、チームに関連付けられている Sharepoint Online サイトで読み取り専用に設定するかどうかを定義します。This optional parameter defines whether to set permissions for team members to read-only on the Sharepoint Online site associated with the team. False に設定したり、本文を完全に省略したりすると、この手順がスキップされます。Setting it to false or omitting the body altogether will result in this step being skipped.

応答Response

アーカイブが正常に開始された場合、このメソッドは202 Accepted応答コードを返します。If archiving is started successfully, this method returns a 202 Accepted response code. 応答には、チームのアーカイブを処理するのに作成された teamsAsyncOperation の場所を含むLocationヘッダーも含まれます。The response will also contain a Location header, which contains the location of the teamsAsyncOperation that was created to handle archiving of the team. この場所に GET 要求を作成して、アーカイブ操作の状態を確認します。Check the status of the archiving operation by making a GET request to this location.

Example

要求Request

要求の例を次に示します。The following is an example of a request.

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

応答Response

応答の例を次に示します。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