チームをアーカイブする
名前空間: microsoft.graph
指定されたチームをアーカイブします。 チームがアーカイブされると、ユーザーはチームにほとんどの変更を加えなくなります。 たとえば、ユーザーは、チーム内の任意のチャネルでメッセージを送信したり、好きになったりすることはできません。チームの名前または説明を編集する。他の設定を編集することもありません。 ただし、チームへのメンバーシップの変更は引き続き許可されます。
アーカイブは非同期操作です。 非同期操作が正常に完了すると、チームはアーカイブされます。これは、この API からの応答の後に発生する可能性があります。
チームをアーカイブできるのは、チームとグループが所有者の場合です。
アーカイブした状態からチームを復元するには、API を使用してアーカイブを解除します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
この API では、管理者のアクセス許可がサポートされています。 グローバル管理者と Microsoft Teams サービス管理者は、メンバーではないチームにアクセスできます。
アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
---|---|---|
委任 (職場または学校のアカウント) | TeamSettings.ReadWrite.All | Directory.ReadWrite.All、Group.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
アプリケーション | TeamSettings.ReadWrite.Group | Directory.ReadWrite.All、Group.ReadWrite.All、TeamSettings.ReadWrite.All |
注:
- TeamSettings.ReadWrite.Group アクセス許可では 、リソース固有の同意が使用されます。
- Group.ReadWrite.All および Directory.ReadWrite.All のアクセス許可は、下位互換性のためにのみサポートされます。 前の表に記載されている別のアクセス許可を使用するようにソリューションを更新し、今後これらのアクセス許可を使用しないようにすることをお勧めします。
HTTP 要求
POST /teams/{id}/archive
要求ヘッダー
ヘッダー | 値 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
要求本文
要求では、 必要に応じて 、次のように JSON 本文に パラメーターを含 shouldSetSpoSiteReadOnlyForMembers
めることができます。
{
"shouldSetSpoSiteReadOnlyForMembers": true
}
このオプションのパラメーターは、チーム メンバーのアクセス許可を、チームに関連付けられている Sharepoint Online サイトで読み取り専用に設定するかどうかを定義します。 false に設定するか、本文を完全に省略すると、この手順はスキップされます。
重要
shouldSetSpoSiteReadOnlyForMembers
パラメーターは、アプリケーション コンテキストではサポートされていません。
応答
アーカイブが正常に開始された場合、このメソッドは202 Accepted
応答コードを返します。 応答には、チームのアーカイブを Location
処理するために作成された teamsAsyncOperation の場所を含むヘッダーも含まれています。 この場所に GET 要求を作成して、アーカイブ操作の状態を確認します。
例
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/teams/{id}/archive
{
}
応答
次の例は応答を示しています。
HTTP/1.1 202 Accepted
Location: /teams({id})/operations({opId})
Content-Type: text/plain
Content-Length: 0
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示