teamsAsyncOperation 资源类型
命名空间: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"
}