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 表示所述操作的类型。 可取值为:invalidcloneTeamarchiveTeamunarchiveTeamcreateTeamunknownFutureValueteamifyGroupcreateChannelarchiveChannelunarchiveChannel。 必须使用Prefer: include-unknown-enum-members请求标头来获取此可演变枚举中的以下值:teamifyGroupcreateChannel、、archiveChannelunarchiveChannel
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"
}