名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Teams の非同期操作は、1 つの API 要求の有効期間を超える操作です。 これらの操作は実行時間が長いか、送信元の要求の期間内に完了するにはコストがかかりすぎます。
非同期操作が開始されると、メソッドは 202 Accepted 応答コードを返します。 応答には、teamsAsyncOperation の場所を含む Location ヘッダーも含まれます。 定期的にこの場所に GET 要求を送信して、操作の状態を定期的にチェックします。チェックの間に >30 秒待ちます。 要求が正常に完了すると、状態は "succeeded" になり、targetResourceLocation は作成または変更されたリソースを指します。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| リスト操作 | resourceSpecificPermissionGrant コレクション | 特定のチャットで実行された、または実行されている非同期操作を一覧表示します。 |
| 操作を取得する | resourceSpecificPermissionGrant コレクション | 特定のリソースで実行された、または実行中の非同期操作を取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| attemptsCount | Int32 | 成功または失敗としてマークされる前に操作が試行された回数。 |
| createdDateTime | DateTimeOffset | 操作が作成された時刻。 |
| error | operationError | 非同期操作の失敗の原因となるエラー。 |
| id | string | 一意の操作 ID。 |
| lastActionDateTime | DateTimeOffset | 非同期操作が最後に更新された時刻。 |
| operationType | teamsAsyncOperationType | 説明されている操作の種類を示します。 有効な値は、 invalid、 cloneTeam、 archiveTeam、 unarchiveTeam、 createTeam、 unknownFutureValue、 teamifyGroup、 createChannel、 createChat、 archiveChannel、 unarchiveChannel です。
Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型の値を取得します: teamifyGroup、createChannel、createChat、archiveChannel、unarchiveChannel。 |
| status | teamsAsyncOperationStatus | 操作の状態。 |
| targetResourceId | 文字列 | この非同期操作の結果として作成または変更されたオブジェクト (通常は チーム) の ID。 |
| targetResourceLocation | string | この非同期操作の結果として作成または変更されたオブジェクトの場所。 この URL は不透明な値として扱う必要があり、コンポーネント パスに解析されません。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"attemptsCount": "Int32",
"createdDateTime": "String (timestamp)",
"error": { "@odata.type": "microsoft.graph.operationError" },
"id": "String (identifier)",
"lastActionDateTime": "String (timestamp)",
"operationType": "String",
"status": "String",
"targetResourceId": "String",
"targetResourceLocation": "String"
}