Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Listen Sie die Agent-Sitzungen auf, die für den angemeldeten Benutzer sichtbar sind. Dieser Vorgang verwendet die Agentic-Sitzungsressource .
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Perception.Read.All | Perception.Manage.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | Perception.Read.All | Perception.Manage.All |
Der angemeldete Benutzer muss Zugriff auf die angeforderten Ressourcen haben. Durch das Erteilen einer OAuth-Berechtigung werden die Zugriffssteuerungen des Diensts nicht außer Kraft gesetzt.
HTTP-Anforderung
GET /security/agenticSecurity/sessions
Optionale Abfrageparameter
Diese Methode unterstützt die folgenden OData-Abfrageparameter.
| Parameter | Beschreibung |
|---|---|
$filter |
Filtern nach Status mit eq, oroder in. Verwenden Sie status Gesamtwerte wie running or succeeded, nicht Unterstatuswerte wie inProgress or .completed Das Filtern nach statusDetail wird nicht unterstützt. |
$select |
Fordern Sie bestimmte Eigenschaften an. Schließen Sie sowohl status als auch statusDetail ein, wenn Sie den Gesamtverarbeitungsstatus und dessen Unterstatus benötigen. Das Anfordern einer Eigenschaft garantiert nicht, dass sie über einen ausgefüllten Wert verfügt. |
$top |
Anfordern einer Seitengröße Gehen Sie nicht davon aus, dass der Dienst genau die angeforderte Anzahl von Sitzungen zurückgibt, oder dass dadurch die Gesamtzahl auf alle Seiten beschränkt ist. |
$orderby, $search, $expand$count, $skip, und die Delta-Nachverfolgung werden nicht unterstützt.
Wenn eine Antwort enthält @odata.nextLink, senden Sie eine GET-Anforderung an diese vollständige URL, ohne sie zu ändern. Fahren Sie fort, bis eine Antwort nicht mehr enthält @odata.nextLink. Erstellen Sie keine Auslagerungs-URLs, extrahieren Sie keine Fortsetzungstoken, und fügen Sie nicht die ursprünglichen Abfrageparameter an einen zurückgegebenen Link an. Bestimmen Sie nicht anhand der Anzahl von Elementen auf einer Seite, ob eine andere Seite vorhanden ist. Weitere Informationen finden Sie unter Paging von Microsoft Graph-Daten.
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und eine Auflistung von Agent-Sitzungsobjekten im Antworttext zurück.
Beispiele
Leerzeichen in Filterausdrücken werden aus Gründen der Lesbarkeit uncodiert angezeigt. Codieren Sie sie wie %20 beim Erstellen einer Anforderungs-URL.
Beispiel 1: Auflisten von Agentsitzungen.
Anforderung
Im folgenden Beispiel sind Sitzungen aufgeführt, die für den angemeldeten Benutzer sichtbar sind. Die Antwortbeispiele verwenden fiktive Bezeichner, Szenarionamen und Tagwerte. Sie veranschaulichen Lebenszykluskombinationen zu verschiedenen Zeitpunkten, keine erfassten API-Antworten. Die Beispiele füllen statusDetail auf, um jedes Szenario zu erläutern. Tatsächliche Antworten können nicht verfügbare optionale Werte auslassen.
GET https://graph.microsoft.com/beta/security/agenticSecurity/sessions
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "847fca66-eb45-43af-93fb-4eca7bace70d",
"displayName": "Investigate incident 12345",
"status": "running",
"statusDetail": "inProgress",
"initiatedBy": {
"user": {
"id": "094c2f8f-1182-45ad-82d7-e01a6bdaba89"
}
},
"tags": [
"workflow-tag-01",
"workflow-tag-02"
]
}
]
}
Beispiel 2: Überwachen laufender Sitzungen
Anforderung
Verwenden Sie diese Abfrage, um laufende Arbeiten zu überwachen, ohne die vollständige Sitzungsressource abzurufen. Im folgenden Beispiel wird nach Status gefiltert, vier Eigenschaften angefordert und eine Seitengröße von zwei Sitzungen angefordert. Eine Sitzung, die auf eine Eingabe wartet, hat running ebenfalls einen Status. Untersuchen Sie statusDetail, um sie von der aktiven Verarbeitung zu unterscheiden. Informationen zu den Lebenszykluskombinationen finden Sie unter Abrufen einer Agentsitzung.
GET https://graph.microsoft.com/beta/security/agenticSecurity/sessions?$filter=status eq 'running'&$select=id,displayName,status,statusDetail&$top=2
Antwort
Das folgende Beispiel zeigt eine aktive Verarbeitungssitzung und eine Sitzung, die auf eine Eingabe wartet. Wenn statusDetail in einer tatsächlichen Antwort fehlt, schließen Sie nicht nur aus dem Status auf einen bestimmten Unterstatus. Folgen Sie @odata.nextLink , wenn sie zurückgegeben wird, auch wenn eine Seite weniger Sitzungen als angefordert enthält.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "847fca66-eb45-43af-93fb-4eca7bace70d",
"displayName": "Investigate incident 12345",
"status": "running",
"statusDetail": "inProgress"
},
{
"id": "a56adc7e-d1dc-4d4d-a1d3-763bf9222f2d",
"displayName": "Analyze threat intelligence article",
"status": "running",
"statusDetail": "waitingForInput"
}
]
}
Beispiel 3: Lesen einer einfachen status Momentaufnahme
Anforderung
Verwenden Sie diese $select Option, wenn eine Anwendung nur Sitzungs-IDs und den VerarbeitungsStatus benötigt, jedoch keine Sitzungsnamen, Zeitstempel, Tags oder Initiatordetails. In diesem Beispiel werden Sitzungen nicht nach Status gefiltert. Folgen Sie allen @odata.nextLink , um zusätzliche Seiten zu lesen und Unterstatuswerte zu behandeln, die nicht ausgefüllt sind.
GET https://graph.microsoft.com/beta/security/agenticSecurity/sessions?$select=id,status,statusDetail&$top=2
Antwort
Das folgende Beispiel zeigt eine Seite mit den angeforderten Eigenschaften.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "c396e931-e39a-48c0-b770-6ef2d66dc790",
"status": "succeeded",
"statusDetail": "completed"
},
{
"id": "847fca66-eb45-43af-93fb-4eca7bace70d",
"status": "running",
"statusDetail": "inProgress"
}
]
}
Beispiel 4: Überprüfen erfolgreich abgeschlossener Sitzungen
Anforderung
Verwenden Sie einen Status-Filter, um Sitzungen zu finden, deren Verarbeitung erfolgreich abgeschlossen wurde. Listen Sie die Ausgaben jeder Sitzung auf, um alle produzierten Dateien zu überprüfen.
In diesem Beispiel werden eq nur Bezeichner, Namen und der Status der Verarbeitung verwendet und succeeded zurückgegeben. Es wird nicht nach Zeitstempeln gefiltert oder sortiert und es handelt sich nicht um eine inkrementelle Synchronisierungsabfrage.
GET https://graph.microsoft.com/beta/security/agenticSecurity/sessions?$filter=status eq 'succeeded'&$select=id,displayName,status,statusDetail&$top=2
Antwort
Im folgenden Beispiel wird die Tabelle zum Sitzungslebenszyklus veranschaulichtsucceeded / completed. Fehlerhafte oder laufende Sitzungen und Fallbacks notStarted / completed sind nicht enthalten. Verwenden Sie den Status und nicht nur den Detailtext, um den erfolgreichen Abschluss zu identifizieren.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "c396e931-e39a-48c0-b770-6ef2d66dc790",
"displayName": "Investigate incident 12346",
"status": "succeeded",
"statusDetail": "completed"
},
{
"id": "a56adc7e-d1dc-4d4d-a1d3-763bf9222f2d",
"displayName": "Analyze threat intelligence article",
"status": "succeeded",
"statusDetail": "completed"
}
]
}