命名空间:microsoft.graph
Microsoft Teams 异步操作是超越单个 API 请求生存期的操作。 这些操作运行时间长或成本过高,无法在发起请求的时间范围内完成。
启动异步操作时,该方法将返回 202 Accepted 响应代码。 响应还将包含 Location 标头,其中包含 teamsAsyncOperation 的位置。 通过对此位置发出 GET 请求,定期检查操作的状态;在检查之间等待 >30 秒。 请求成功完成后,状态将为“成功”,并且 targetResourceLocation 将指向已创建/修改的资源。
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| attemptsCount | Int32 | 在标记为成功或失败之前尝试操作的次数。 |
| createdDateTime | DateTimeOffset | 创建操作的时间。 |
| error | operationError | 导致异步操作失败的任何错误。 |
| id | string | 唯一的操作 ID。 |
| lastActionDateTime | DateTimeOffset | 上次更新异步操作的时间。 |
| operationType | teamsAsyncOperationType | 表示所述操作的类型。 可取值为:invalid、cloneTeam、archiveTeam、unarchiveTeam、createTeam、unknownFutureValue、teamifyGroup、createChannel、archiveChannel、unarchiveChannel。 使用 Prefer: include-unknown-enum-members 请求标头获取此 可演变枚举中的以下值: teamifyGroup、 createChannel、 archiveChannel、 unarchiveChannel。 |
| status | teamsAsyncOperationStatus | 操作状态。 |
| targetResourceId | String | 由于此异步操作而创建或修改的对象(通常是 团队)的 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"
}