engagementAsyncOperation 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.

Stellt den Status eines asynchronen Viva Engage-Vorgangs dar, bei dem es sich um einen Vorgang handelt, der über die Lebensdauer einer einzelnen API-Anforderung hinausgeht. Diese Vorgänge sind langwierig oder zu teuer, um sie innerhalb des Zeitrahmens ihrer ursprünglichen Anforderung abzuschließen.

Wenn ein asynchroner Vorgang initiiert wird, gibt die Methode einen 202 Accepted Antwortcode und einen Operation-Location Header zurück, der den Speicherort der engagementAsyncOperation 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, gibt der Status des Vorgangs an succeeded und der resourceLocation verweist auf die erstellte oder geänderte Ressource.

Erbt von longRunningOperation.

Methoden

Methode Rückgabetyp Beschreibung
Get engagementAsyncOperation Rufen Sie eine engagementAsyncOperation ab, um eine Vorgangsanforderung mit langer Ausführungszeit nachzuverfolgen.

Eigenschaften

Eigenschaft Typ Beschreibung
createdDateTime DateTimeOffset Datum und Uhrzeit, wann der Vorgang erstellt wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Geerbt von longRunningOperation.
id Zeichenfolge Der eindeutige Bezeichner für den Vorgang. Geerbt von longRunningOperation.
lastActionDateTime DateTimeOffset Datum und Uhrzeit, zu dem der asynchrone Vorgang zuletzt aktualisiert wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Geerbt von longRunningOperation.
operationType engagementAsyncOperationType Der Typ des Vorgangs mit langer Ausführungszeit. Die möglichen Werte sind: createCommunity, unknownFutureValue.
resourceId String Die ID des Objekts, das als Ergebnis dieses asynchronen Vorgangs erstellt oder geändert wurde.
resourceLocation Zeichenfolge Der Speicherort des Objekts, das als Ergebnis dieses asynchronen Vorgangs erstellt oder geändert wurde. Geerbt von longRunningOperation.
status longRunningOperationStatus Der Status des Vorgangs. Mögliche Werte sind: notStarted, running, succeeded, failed, skipped, unknownFutureValue. Geerbt von longRunningOperation.
statusDetail Zeichenfolge Details zum Status des Vorgangs. Geerbt von longRunningOperation.

engagementAsyncOperationType-Werte

Member Beschreibung
createCommunity Vorgang zum Erstellen einer Viva Engage-Community.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.engagementAsyncOperation",
  "createdDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "lastActionDateTime": "String (timestamp)",
  "operationType": "String",
  "resourceId": "String",
  "resourceLocation": "String",
  "status": "String",
  "statusDetail": "String"
}
  • Last updated on