Systems - Report Action Status

Dienst:

Sentinel

API-Version:

2025-04-01-preview

Melden Sie den Status der Aktion.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/businessApplicationAgents/{agentResourceName}/systems/{systemResourceName}/reportActionStatus?api-version=2025-04-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
agentResourceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9,-]*$	Name des Geschäftsanwendungs-Agents
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
systemResourceName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9,-]*$	Der Name des Systems.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Der Name des Arbeitsbereichs.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
actionId	string	Die auszuführende Aktions-ID
actionStatus	string	Der Status der Aktion, die vom Agent ausgeführt wurde
failureReason	string	Der Grund für den Fehler der Aktion. Leer, wenn die Aktion erfolgreich ist.

Antworten

Name	Typ	Beschreibung
204 No Content		Kein Inhalt
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

ReportActionStatus

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/businessApplicationAgents/247b377a-7137-4b3c-bf15-df1d3260ef1b/systems/3d69632b-0b60-4af3-8720-77f01a25d34a/reportActionStatus?api-version=2025-04-01-preview

Beispiel für eine Antwort

Statuscode:

204

Definitionen

Name	Beschreibung
CloudError	Fehlerantwortstruktur.
CloudErrorBody	Fehlerdetails.
ReportActionStatusPayload	Melden des Status einer Aktion, die vom Agent ausgeführt wurde

CloudError

Objekt

Fehlerantwortstruktur.

Name	Typ	Beschreibung
error	CloudErrorBody	Fehlerdaten

CloudErrorBody

Objekt

Fehlerdetails.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

ReportActionStatusPayload

Objekt

Melden des Status einer Aktion, die vom Agent ausgeführt wurde

Name	Typ	Beschreibung
actionId	string	Die auszuführende Aktions-ID
actionStatus	string	Der Status der Aktion, die vom Agent ausgeführt wurde
failureReason	string	Der Grund für den Fehler der Aktion. Leer, wenn die Aktion erfolgreich ist.