次の方法で共有


team: clone

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

チームのコピーを作成します。 この操作により、対応する グループのコピーも作成されます。 複製するチームのどの部分を指定できます。

  • apps - チームMicrosoft Teamsインストールされているアプリをコピーします。
  • channels – チャネル構造をコピーします (ただし、チャネル内のメッセージはコピーしません)。
  • members – グループのメンバーと所有者をコピーします。
  • settings – チーム内のすべての設定とキー グループ設定をコピーします。
  • tabs – チャネル内のタブをコピーします。

手記:このメソッドは、organization全体のチームではサポートされていません。

注:

複製されたチームの所有者に関連する既知の問題は、このメソッドに関連付けられています。 詳細については、「既知の問題」を参照してください。

タブが複製されると、タブは構成されません。 タブはMicrosoft Teamsのタブ バーに表示され、ユーザーが初めてタブを開く場合は、構成画面を通過する必要があります。 タブを開いたユーザーにアプリを構成するためのアクセス許可がない場合は、タブが構成されていないことを示すメッセージが表示されます。

複製は実行時間の長い操作です。 POST 複製が戻ったら、Location: ヘッダーから返された操作を取得して、runningsucceeded、またはfailedかどうかを確認する必要があります。 状態が runningされないまで、引き続き GET を行う必要があります。 GET 間の推奨遅延は 5 秒です。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) Team.Create Directory.ReadWrite.All、Group.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Team.Create Directory.ReadWrite.All、Group.ReadWrite.All

注:

Group.ReadWrite.All および Directory.ReadWrite.All のアクセス許可は、下位互換性のためにのみサポートされます。 前の表に記載されている別のアクセス許可を使用するようにソリューションを更新し、今後これらのアクセス許可を使用しないようにすることをお勧めします。

HTTP 要求

POST /teams/{id}/clone

要求ヘッダー

ヘッダー
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json

要求本文

プロパティ 説明
classification 文字列 (省略可能) グループの分類 (低、中、高のビジネスへの影響など) について説明します。 このプロパティの有効な値は、テンプレート定義に基づいて ClassificationList 設定値 を作成することによって 定義されます。 分類が指定されていない場合、分類は元のチーム/グループからコピーされます。
説明 文字列 (省略可能) グループに関するオプションの説明。 このプロパティが指定されていない場合は、空白のままです。
displayName 文字列 グループの表示名。 このプロパティは、グループが作成され、更新中にクリアできない場合に必要です。 $filter および $orderby をサポートします。
mailNickname String グループのメール エイリアスです (組織内で一意)。 このプロパティは、グループの作成時に指定する必要があります。 $filter をサポートします。 このプロパティが指定されていない場合は、displayName から計算されます。 既知の問題: このプロパティは現在無視されています。
partsToClone clonableTeamParts 複製するパーツのコンマ区切りのリスト。 法的な部分は、"アプリ、タブ、設定、チャネル、メンバー" です。
visibility teamVisibilityType (省略可能) グループの可視性を指定します。 使用可能な値は、 PrivatePublic です。 可視性が指定されていない場合、可視性は元のチーム/グループからコピーされます。 複製するチームが educationClass チームの場合、visibility パラメーターは無視され、新しいグループの可視性は HiddenMembership に設定されます。

注:

要求本文で description プロパティが指定されていない場合は、要求ペイロードから displayName プロパティの値を受け取ります。

応答

成功した場合、このメソッドは、Location: ヘッダーが操作リソースを指す202 Accepted応答コードを返します。 操作が完了すると、作成されたチームの ID が操作リソースに通知されます。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/beta/teams/{id}/clone
Content-Type: application/json

{  
     "displayName": "Library Assist",
     "description": "Self help community for library",
     "mailNickname": "libassist",
     "partsToClone": "apps,tabs,settings,channels,members",
     "visibility": "public"
}

応答

次の例は応答を示しています。 注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

Microsoft Graph サービス固有の調整制限