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