teamsAsyncOperation Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Ein asynchroner Microsoft Teams-Vorgang ist ein Vorgang, der über die Lebensdauer einer einzelnen API-Anforderung hinausgeht. Diese Vorgänge haben eine lange Laufzeit oder sind zu teuer, um sie innerhalb des Zeitrahmens ihrer ursprünglichen Anforderung abzuschließen.

Wenn ein asynchroner Vorgang initiiert wird, gibt die Methode den Antwortcode 202 Accepted zurück. Die Antwort enthält auch einen Location-Header, der den Speicherort der teamsAsyncOperation enthält. Überprüfen Sie regelmäßig den Status des Vorgangs, indem Sie eine GET-Anforderung an diesen Speicherort senden; warten Sie >30 Sekunden zwischen den Überprüfungen. Wenn die Anforderung erfolgreich abgeschlossen wurde, lautet der Status "erfolgreich" und targetResourceLocation verweist auf die erstellte/geänderte Ressource.

Methoden

Methode Rückgabetyp Beschreibung
Vorgänge auflisten resourceSpecificPermissionGrant-Sammlung Auflisten asynchroner Vorgänge, die für einen bestimmten Chat ausgeführt wurden oder ausgeführt werden.
Vorgang abrufen resourceSpecificPermissionGrant-Sammlung Rufen Sie einen asynchronen Vorgang ab, der für eine bestimmte Ressource ausgeführt wurde oder ausgeführt wird.

Eigenschaften

Eigenschaft Typ Beschreibung
attempts Anzahl Int32 Gibt an, wie oft der Vorgang versucht wurde, bevor er als erfolgreich oder fehlgeschlagen gekennzeichnet wurde.
createdDateTime DateTimeOffset Zeitpunkt, zu dem der Vorgang erstellt wurde.
error operationError Jeder Fehler, der dazu führt, dass der asynchrone Vorgang fehlschlägt.
id string Eindeutige Vorgangs-ID.
lastActionDateTime DateTimeOffset Zeitpunkt, zu dem der asynchrone Vorgang zuletzt aktualisiert wurde.
operationType teamsAsyncOperationType Bezeichnet den beschriebenen Vorgangstyp. Die möglichen Werte sind: invalid, cloneTeam, archiveTeam, unarchiveTeam, createTeam, unknownFutureValuearchiveChannelteamifyGroupcreateChatcreateChannelunarchiveChannel. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte in dieser entwicklungsfähigen Aufzählung zu erhalten: teamifyGroup, createChannel, createChat, unarchiveChannelarchiveChannel, .
status teamsAsyncOperationStatus Operation status.
targetResourceId Zeichenfolge Die ID des Objekts, das als Ergebnis dieses asynchronen Vorgangs erstellt oder geändert wird, in der Regel ein Team.
targetResourceLocation string Der Speicherort des Objekts, das als Ergebnis dieses asynchronen Vorgangs erstellt oder geändert wird. Diese URL sollte als nicht transparenter Wert behandelt und nicht in seine Komponentenpfade analysiert werden.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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