engagementAsyncOperation-Ressourcentyp

Namespace: microsoft.graph

Stellt die status eines Viva Engage asynchronen Vorgangs dar, bei dem es sich um einen Vorgang handelt, der die Lebensdauer einer einzelnen API-Anforderung überschreitet. Diese Vorgänge sind lang 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 von engagementAsyncOperation enthält. Überprüfen Sie regelmäßig die status des Vorgangs, indem Sie eine GET-Anforderung an diesen Speicherort stellen. Warten Sie >zwischen den Überprüfungen 30 Sekunden. Wenn die Anforderung erfolgreich abgeschlossen wird, gibt der Vorgang status ansucceeded, und 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 Anforderung mit langer Ausführungszeit nachzuverfolgen.

Eigenschaften

Eigenschaft	Typ	Beschreibung
createdDateTime	DateTimeOffset	Datum und Uhrzeit der Erstellung des Vorgangs. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Geerbt von longRunningOperation.
id	String	Der eindeutige Bezeichner für den Vorgang. Geerbt von longRunningOperation.
lastActionDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Aktualisierung des asynchronen Vorgangs. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist 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 zeitintensiven Vorgangs. 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	String	Die Position des Objekts, das als Ergebnis dieses asynchronen Vorgangs erstellt oder geändert wurde. Geerbt von longRunningOperation.
status	longRunningOperationStatus	Die status des Vorgangs. Mögliche Werte sind: notStarted, running, succeeded, failed, skipped, unknownFutureValue. Geerbt von longRunningOperation.
statusDetail	String	Details zur status des Vorgangs. Geerbt von longRunningOperation.

engagementAsyncOperationType-Werte

Member	Beschreibung
createCommunity	Vorgang zum Erstellen einer Viva Engage Community.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

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