Partilhar via


tipo de recurso teamsAsyncOperation

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Uma operação assíncrona do Microsoft Teams é uma operação que transcende a duração de um único pedido de API. Estas operações são de execução prolongada ou são demasiado dispendiosas para serem concluídas dentro do período de tempo do pedido de origem.

Quando uma operação assíncrona é iniciada, o método devolve um código de resposta 202 Aceite. A resposta também conterá um cabeçalho Localização, que contém a localização do teamsAsyncOperation. Verifique periodicamente o estado da operação ao fazer um pedido GET para esta localização; aguarde >30 segundos entre as verificações. Quando o pedido for concluído com êxito, o estado será "bem-sucedido" e targetResourceLocation apontará para o recurso criado/modificado.

Métodos

Método Tipo de retorno Descrição
Listar operações Coleção resourceSpecificPermissionGrant Listar operações assíncronas executadas ou em execução numa conversa específica.
Obter operação Coleção resourceSpecificPermissionGrant Obtenha uma operação assíncrona executada ou em execução num recurso específico.

Propriedades

Propriedade Tipo Descrição
attemptsCount Int32 Número de vezes que a operação foi tentada antes de ser marcada com êxito ou falhada.
createdDateTime DateTimeOffset Hora em que a operação foi criada.
erro operationError Qualquer erro que faça com que a operação assíncrona falhe.
id string ID de operação exclusivo.
lastActionDateTime DateTimeOffset Hora em que a operação assíncrona foi atualizada pela última vez.
operationType teamsAsyncOperationType Indica o tipo de operação descrito. Os valores possíveis são: invalid, cloneTeam, archiveTeam, unarchiveTeam, createTeam, unknownFutureValue, teamifyGroup, createChannel, createChat, archiveChannel, unarchiveChannel. Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores nesta enumeração evoluível: teamifyGroup, createChannel, createChat, archiveChannel, unarchiveChannel.
status teamsAsyncOperationStatus Estado da operação.
targetResourceId Cadeia de caracteres O ID do objeto que é criado ou modificado como resultado desta operação assíncrona, normalmente uma equipa.
targetResourceLocation string A localização do objeto que é criado ou modificado como resultado desta operação assíncrona. Este URL deve ser tratado como um valor opaco e não analisado nos respetivos caminhos de componente.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "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"
}