Type de ressource teamsAsyncOperation

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Une opération asynchrone Microsoft Teams est une opération qui transcende la durée de vie d’une seule requête d’API. Ces opérations sont longues ou trop coûteuses pour être effectuées dans le délai de leur demande d’origine.

Lorsqu’une opération asynchrone est lancée, la méthode retourne un code de réponse 202 Accepté. La réponse contient également un en-tête Location, qui contient l’emplacement de teamsAsyncOperation. Vérifiez régulièrement l’état de l’opération en effectuant une requête GET à cet emplacement ; attendez >30 secondes entre les vérifications. Une fois la demande terminée, l’état est « réussi » et l’objet targetResourceLocation pointe vers la ressource créée/modifiée.

Méthodes

Méthode Type renvoyé Description
Répertorier les opérations Collection resourceSpecificPermissionGrant Répertorie les opérations asynchrones exécutées ou en cours d’exécution sur une conversation spécifique.
Opération d’obtention Collection resourceSpecificPermissionGrant Obtient une opération asynchrone qui s’est exécutée ou s’exécute sur une ressource spécifique.

Propriétés

Propriété Type Description
attemptsCount Int32 Nombre de tentatives d’opération avant d’être marquées comme ayant réussi ou échoué.
createdDateTime DateTimeOffset Heure de création de l’opération.
error operationError Toute erreur qui provoque l’échec de l’opération asynchrone.
id string ID d’opération unique.
lastActionDateTime DateTimeOffset Heure de la dernière mise à jour de l’opération asynchrone.
operationType teamsAsyncOperationType Indique le type d’opération décrit. Valeurs possibles : invalid, cloneTeam, archiveTeam, unarchiveTeam, createTeam, unknownFutureValue, teamifyGroup, createChannel, createChat, archiveChannel, unarchiveChannel. Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes dans cette énumération évolutive : teamifyGroup, createChannel, createChat, archiveChannel, unarchiveChannel.
status teamsAsyncOperationStatus État de l’opération.
targetResourceId Chaîne ID de l’objet créé ou modifié à la suite de cette opération asynchrone, généralement une équipe.
targetResourceLocation string Emplacement de l’objet créé ou modifié à la suite de cette opération asynchrone. Cette URL doit être traitée comme une valeur opaque et non analysée dans ses chemins d’accès de composants.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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