Systems - Get

Dienst:: Sentinel

API-Version:: 2025-04-01-preview

Ruft das System ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/businessApplicationAgents/{agentResourceName}/systems/{systemResourceName}?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.

Antworten

Name	Typ	Beschreibung
200 OK	SystemResource	Okay
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

Systems_Get

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/businessApplicationAgents/3123432b-0b60-4af3-8720-77f01a25d34a/systems/3d69632b-0b60-4af3-8720-77f01a25d34a?api-version=2025-04-01-preview

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/businessApplicationAgents/73e01a99-5cd7-4139-a149-9f2736ff2ab5/systems/3b6bed7b-3f1c-47fc-ab8e-2c57047ed446",
  "name": "3b6bed7b-3f1c-47fc-ab8e-2c57047ed446",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "type": "Microsoft.SecurityInsights/businessApplicationAgents/systems",
  "properties": {
    "status": "Running",
    "configuration": {
      "azureResourceId": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace",
      "connector": {
        "abapServerHost": "1.1.1.1",
        "systemNumber": "001",
        "systemId": "A4H",
        "client": "001",
        "authenticationType": "UsernamePassword",
        "type": "Rfc"
      },
      "logs": [
        {
          "type": "AbapAuditLog",
          "ingestionType": "Incremental",
          "status": "Enabled",
          "scheduleInterval": 60,
          "bulkSize": 100,
          "filters": [
            "filter1",
            "filter2"
          ]
        },
        {
          "type": "USR01",
          "ingestionType": "Incremental",
          "status": "Enabled",
          "scheduleInterval": 60,
          "bulkSize": 100,
          "filters": [
            "filter1",
            "filter2"
          ]
        }
      ],
      "type": "SAP"
    },
    "displayName": "A4H_System",
    "lastModifiedTimeUtc": "2024-03-01T13:00:30Z"
  }
}

Definitionen

Name	Beschreibung
CloudError	Fehlerantwortstruktur.
CloudErrorBody	Fehlerdetails.
ConfigurationType	Stellt die Konfigurationstypen für ein System dar.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
HttpsConfigurationType	Stellt die Typen der HTTPS-Konfiguration dar, um eine Verbindung mit dem SapControl-Dienst herzustellen.
IngestionType	Arten der Aufnahme.
Log	Beschreibt ein Protokoll.
LogStatusType	Typen des Protokollstatus.
LogType	Typen von Protokollen und Tabellen.
RfcConnector	Beschreibt den Rfc-Connector.
SapAuthenticationType	Authentifizierungstypen für SAP.
SapControlConnector	Beschreibt die SapControl-Connectorkonfiguration.
SapSystemsConfiguration	Beschreibt die SAP-Konfiguration.
SystemConfigurationConnectorType	Stellt die Typen von SAP-Systemen dar.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
SystemResource	Beschreibt das System innerhalb des Agents.
SystemStatusType	Der Status des Systems.

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.

ConfigurationType

Enumeration

Stellt die Konfigurationstypen für ein System dar.

Wert	Beschreibung
SAP

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

HttpsConfigurationType

Enumeration

Stellt die Typen der HTTPS-Konfiguration dar, um eine Verbindung mit dem SapControl-Dienst herzustellen.

Wert	Beschreibung
HttpOnly
HttpsWithSslVerification
HttpsWithoutSslVerification

IngestionType

Enumeration

Arten der Aufnahme.

Wert	Beschreibung
Full
Incremental

Log

Objekt

Beschreibt ein Protokoll.

Name	Typ	Beschreibung
bulkSize	integer (int32)	Die Massengröße für das Protokoll.
filters	string[]	Die Filter für das Protokoll.
ingestionType	IngestionType	Arten der Aufnahme.
scheduleInterval	integer (int32)	Das Zeitplanintervall in Sekunden.
status	LogStatusType	Typen des Protokollstatus.
type	LogType	Typen von Protokollen und Tabellen.

LogStatusType

Enumeration

Typen des Protokollstatus.

Wert	Beschreibung
Enabled
Disabled

LogType

Enumeration

Typen von Protokollen und Tabellen.

Wert	Beschreibung
AbapAuditLog
AbapJobLog
AbapSpoolLog
AbapSpoolOutputLog
AbapChangeDocsLog
AbapAppLog
AbapWorkflowLog
AbapCrLog
AbapTableDataLog
AbapFilesLogs
JavaFilesLogs
AGRTCODES
USR01
USR02
AGR1251
AGRUSERS
AGRPROF
UST04
USR21
ADR6
ADCP
USR05
USGRPUSER
USERADDR
DEVACCESS
AGRDEFINE
PAHI
AGRAGRS
USRSTAMP
AGRFLAGS
SNCSYSACL
USRACL

RfcConnector

Objekt

Beschreibt den Rfc-Connector.

Name	Typ	Beschreibung
abapServerHost	string	FQDN, Hostname oder IP-Adresse des CTRL-Servers.
authenticationType	SapAuthenticationType	Der Authentifizierungstyp für SAP.
client	string minLength: 1 pattern: ^[0-9]{3}$	Clientnummer des DICTIONARY-Servers. Beispiel - 001
codePage	string pattern: ^(?:[a-zA-Z0-9]{4}\|UTF-8)$	Die SAP-Codeseite, die für die Zeichencodierung verwendet wird. Beispiel - 1100
group	string	Anmeldegruppe des Nachrichtenservers.
messageServerHost	string	FQDN, Hostname oder IP-Adresse des Nachrichtenservers.
messageServerService	string	Portnummer oder Dienstname (von /etc/services) des Nachrichtenservers.
sncQop	string pattern: ^[1,2,3,8,9]$	SNC QOP. Optionen sind 1, 2, 3, 8, 9.
systemId	string minLength: 1 pattern: ^[a-zA-Z0-9]{3}$	System-ID des DICTIONARY-Servers. Beispiel - A4H
systemNumber	string minLength: 1 pattern: ^\d{1,3}$	Systemnummer des DICTIONARY-Servers.
type	SystemConfigurationConnectorType	Stellt die Typen von SAP-Systemen dar.

SapAuthenticationType

Enumeration

Authentifizierungstypen für SAP.

Wert	Beschreibung
UsernamePassword
Snc
SncWithUsernamePassword

SapControlConnector

Objekt

Beschreibt die SapControl-Connectorkonfiguration.

Name	Typ	Standardwert	Beschreibung
httpsConfiguration	HttpsConfigurationType		Stellt die Typen der HTTPS-Konfiguration dar, um eine Verbindung mit dem SapControl-Dienst herzustellen.
instance	string minLength: 1 pattern: ^\d{2}$		Die Instanznummer. Es sind nur 2 Ziffern zulässig.
port	string pattern: ^\d{1,5}$		Der Port der SOAP-Verbindung zu SAP Control.
server	string minLength: 1 pattern: ^([a-zA-Z0-9]+(-[a-zA-Z0-9]+)*\.)+[a-zA-Z]{2,}$\|^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$		Der Servername. FQDN oder IP-Adresse.
timezone	string pattern: ^GMT[+-]\d+$	GMT+0	Die Zeitzone. Beispiel: "GMT+0" oder "GMT-8" Standard: "GMT+0"
type	SystemConfigurationConnectorType		Stellt die Typen von SAP-Systemen dar.

SapSystemsConfiguration

Objekt

Beschreibt die SAP-Konfiguration.

Name	Typ	Beschreibung
azureResourceId	string pattern: ^\/?subscriptions\/([^\/]+)\/resourceGroups\/([^\/]+)\/providers\/([^\/]+)\/([^\/]+)\/([^\/]+)$	Beispiel für azure-Ressourcen-ID: "/subscriptions/0000000-0000-0000-00000-00000000000/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"
connector	SystemsConfigurationConnector: RfcConnector SapControlConnector	Basismodell für SAP System Connector.
logs	Log[]	Die Protokollkonfiguration.
type	ConfigurationType	Stellt die Konfigurationstypen für ein System dar.

SystemConfigurationConnectorType

Enumeration

Stellt die Typen von SAP-Systemen dar.

Wert	Beschreibung
Rfc
SapControl

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

SystemResource

Objekt

Beschreibt das System innerhalb des Agents.

Name	Typ	Beschreibung
etag	string	Etag der Azure-Ressource
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties.configuration	SystemsConfiguration: SapSystemsConfiguration	Die Konfiguration des Systems.
properties.displayName	string minLength: 1
properties.lastModifiedTimeUtc	string (date-time)
properties.status	SystemStatusType	Der Status des Systems.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

SystemStatusType

Enumeration

Der Status des Systems.

Wert	Beschreibung
Running
Stopped

Freigeben über

Systems - Get

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Systems_Get

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CloudError

CloudErrorBody

ConfigurationType

createdByType

HttpsConfigurationType

IngestionType

Log

LogStatusType

LogType

RfcConnector

SapAuthenticationType

SapControlConnector

SapSystemsConfiguration

SystemConfigurationConnectorType

systemData

SystemResource

SystemStatusType