team: clone

名前空間: microsoft.graph

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

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

注:

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

応答

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

要求

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

POST https://graph.microsoft.com/v1.0/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 サービス固有の調整制限