Bicep-Ressourcendefinition
Der dataConnectorDefinitions-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Um eine Microsoft.SecurityInsights/dataConnectorDefinitions-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.
resource symbolicname 'Microsoft.SecurityInsights/dataConnectorDefinitions@2025-09-01' = {
etag: 'string'
name: 'string'
kind: 'string'
// For remaining properties, see Microsoft.SecurityInsights/dataConnectorDefinitions objects
}
Microsoft.SecurityInsights/dataConnectorDefinitions-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für Anpassbare:
{
kind: 'Customizable'
properties: {
connectionsConfig: {
templateSpecName: 'string'
templateSpecVersion: 'string'
}
connectorUiConfig: {
availability: {
isPreview: bool
status: int
}
connectivityCriteria: [
{
type: 'string'
value: [
'string'
]
}
]
dataTypes: [
{
lastDataReceivedQuery: 'string'
name: 'string'
}
]
descriptionMarkdown: 'string'
graphQueries: [
{
baseQuery: 'string'
legend: 'string'
metricName: 'string'
}
]
id: 'string'
instructionSteps: [
{
description: 'string'
innerSteps: [
...
]
instructions: [
{
parameters: any(...)
type: 'string'
}
]
title: 'string'
}
]
isConnectivityCriteriasMatchSome: bool
logo: 'string'
permissions: {
customs: [
{
description: 'string'
name: 'string'
}
]
licenses: [
'string'
]
resourceProvider: [
{
permissionsDisplayText: 'string'
provider: 'string'
providerDisplayName: 'string'
requiredPermissions: {
action: bool
delete: bool
read: bool
write: bool
}
scope: 'string'
}
]
tenant: [
'string'
]
}
publisher: 'string'
title: 'string'
}
createdTimeUtc: 'string'
lastModifiedUtc: 'string'
}
}
Eigenschaftswerte
Microsoft.SecurityInsights/dataConnectorDefinitions
| Name |
Beschreibung |
Wert |
| etag |
Etag der Azure-Ressource |
Schnur |
| Art |
Legen Sie für den Typ CustomizeableConnectorDefinitionauf "Anpassbar" fest. |
"Anpassbar" (erforderlich) |
| Name |
Der Ressourcenname |
Schnur
Zwänge: Pattern = ^[a-z0-9A-Z-_]*$ (erforderlich) |
| Umfang |
Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. |
Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden. |
ConnectivityKriterium
| Name |
Beschreibung |
Wert |
| Art |
Dient zum Abrufen oder Festlegen des Verbindungstyps. |
Zeichenfolge (erforderlich) |
| Wert |
Ruft die Abfragen für die Überprüfung der Konnektivität ab oder legt sie fest. |
Zeichenfolge[] |
ConnectorDataType
| Name |
Beschreibung |
Wert |
| lastDataReceivedQuery |
Dient zum Abrufen oder Festlegen der Abfrage, die angibt, wann relevante Daten zuletzt im Arbeitsbereich empfangen wurden. |
Zeichenfolge (erforderlich) |
| Name |
Ruft den Namen des Datentyps ab, der im Diagramm angezeigt werden soll, oder legt diesen fest. |
Zeichenfolge (erforderlich) |
KonnektorDefinitionenVerfügbarkeit
| Name |
Beschreibung |
Wert |
| isVorschau |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Connector eine Vorschau ist. |
Bool |
| Status |
Der Belichtungsstatus des Verbinders für die Kunden. Verfügbare Werte sind 0-4 (0=None, 1=Available, 2=FeatureFlag, 3=Internal). |
Int |
KonnektorDefinitionenBerechtigungen
| Name |
Beschreibung |
Wert |
| Zoll |
Ruft die zollrechtlichen Berechtigungen ab, die für den Benutzer zum Erstellen von Verbindungen erforderlich sind, oder legt diese fest. |
CustomPermissionDetails[] |
| Lizenzen |
Ruft die erforderlichen Lizenzen für den Benutzer ab, um Verbindungen zu erstellen, oder legt diese fest. |
Zeichenfolge[] |
| Ressourcenanbieter |
Dient zum Abrufen oder Festlegen der Ressourcenanbieterberechtigungen, die für den Benutzer zum Erstellen von Verbindungen erforderlich sind. |
ConnectorDefinitionsResourceProvider[] |
| Mieter |
Ruft die erforderlichen Mandantenberechtigungen für den Connector ab oder legt diese fest. |
Zeichenfolge[] |
ConnectorDefinitionsResourceProvider
| Name |
Beschreibung |
Wert |
| BerechtigungenDisplayText |
Dient zum Abrufen oder Festlegen des Berechtigungsbeschreibungstexts. |
Zeichenfolge (erforderlich) |
| Anbieter |
Dient zum Abrufen oder Festlegen des Anbieternamens. |
Zeichenfolge (erforderlich) |
| providerAnzeigename |
Dient zum Abrufen oder Festlegen des Anzeigenamens des Berechtigungsanbieters. |
Zeichenfolge (erforderlich) |
| requiredBerechtigungen |
Erforderliche Berechtigungen für den Connectorressourcenanbieter, der in ResourceProviders definiert ist. Weitere Informationen zu den Berechtigungen finden Sie <unter href="/azure/role-based-access-control/role-definitions#actions-format">hier</see>. |
ResourceProviderRequiredPermissions- (erforderlich) |
| Umfang |
Der Bereich, für den der Benutzer über Berechtigungen verfügen soll, um Verbindungen erstellen zu können. |
"ResourceGroup" "Abonnement" "Arbeitsbereich" (erforderlich) |
CustomizeableConnectionsConfig
| Name |
Beschreibung |
Wert |
| templateSpecName |
Dient zum Abrufen oder Festlegen des Vorlagennamens. Die Vorlage enthält ARM-Vorlagen, die vom Connector erstellt werden können. In der Regel handelt es sich um die ARM-Vorlagen für dataConnectors. |
Zeichenfolge (erforderlich) |
| templateSpecVersion |
Ruft die Vorlagenversion ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
CustomizeableConnectorDefinition
CustomizeableConnectorDefinitionProperties
| Name |
Beschreibung |
Wert |
| connectionsConfig |
Die UiConfig für die Connectordefinitionsart 'Customizeable'. |
CustomizeableConnectionsConfig- |
| connectorUiConfig |
Die UiConfig für die Connectordefinitionsart 'Customizeable'. |
CustomizeableConnectorUiConfig (erforderlich) |
| createdTimeUtc |
Ruft das Erstellungsdatum der Connectordefinition im UTC-Format ab, oder legt diese fest. |
Schnur |
| lastModifiedUtc |
Ruft das Datum der letzten Änderung des Verbinders im UTC-Format ab oder legt diese fest. |
Schnur |
CustomizeableConnectorUiConfig
| Name |
Beschreibung |
Wert |
| Verfügbarkeit |
Der Belichtungsstatus des Verbinders für die Kunden. |
ConnectorDefinitionsAvailability- |
| KonnektivitätKriterien |
Ruft ab oder legt fest, wie der Verbinder überprüft, ob der Verbinder verbunden ist. |
ConnectivityCriterion-[] (erforderlich) |
| Datentypen |
Ruft die Datentypen ab, die auf die zuletzt empfangenen Daten überprüft werden sollen, oder legt diese fest. |
ConnectorDataType-[] (erforderlich) |
| BeschreibungMarkdown |
Ruft die Verbinderbeschreibung im Markdown-Format ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
| graphQueries |
Ruft die Diagrammabfragen ab, um das aktuelle Datenvolumen im Laufe der Zeit anzuzeigen, oder legt diese fest. |
GraphQuery[] (erforderlich) |
| id |
Ruft die benutzerdefinierte Connector-ID ab oder legt diese fest. Optionales Feld. |
Schnur |
| instructionSchritte |
Ruft die Anweisungsschritte ab, um den Connector zu aktivieren, oder legt diese fest. |
InstructionStep[] (erforderlich) |
| isConnectivityCriteriaMatchSome |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob 'OR'(SOME) oder 'AND' zwischen ConnectivityCriteria-Elementen verwendet werden soll. |
Bool |
| Logo |
Ruft das Connectorlogo ab, das beim Anzeigen des Verbinders im Katalog des Connectors von Azure Sentinel verwendet werden soll, oder legt dieses fest. Der Logowert sollte im SVG-Format vorliegen. |
Schnur |
| Erlaubnisse |
Die erforderlichen Berechtigungen für den Connector. |
ConnectorDefinitionsPermissions- (erforderlich) |
| Verlag |
Ruft den Herausgebernamen des Verbinders ab oder legt den Namen fest. |
Zeichenfolge (erforderlich) |
| Titel |
Ruft den Titel des Verbinderblatts ab oder legt den Titel fest. |
Zeichenfolge (erforderlich) |
CustomPermissionDetails
| Name |
Beschreibung |
Wert |
| Beschreibung |
Ruft die beschreibung der benutzerdefinierten Berechtigungen ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
| Name |
Dient zum Abrufen oder Festlegen des benutzerdefinierten Berechtigungsnamens. |
Zeichenfolge (erforderlich) |
Graph-Abfrage
| Name |
Beschreibung |
Wert |
| baseQuery (englisch) |
Ruft die Basisabfrage für das Diagramm ab oder legt sie fest. Die Basisabfrage wird von Sentinel-UI-Infrastruktur mit einer KQL-Abfrage umschlossen, die das Volumen im Laufe der Zeit misst. |
Zeichenfolge (erforderlich) |
| Legende |
Ruft die Legende für das Diagramm ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
| metricName |
Ruft den Metriknamen ab, den die Abfrage überprüft, oder legt diesen fest. Beispiel: "Gesamtdaten empfangen". |
Zeichenfolge (erforderlich) |
Anweisungsschritt
| Name |
Beschreibung |
Wert |
| Beschreibung |
Dient zum Abrufen oder Festlegen der Beschreibung des Anweisungsschritts. |
Schnur |
| innerSteps |
Ruft die Details der inneren Anweisungsschritte ab oder legt diese fest. Beispiel: Anweisungsschritt 1 kann innere Anweisungsschritte enthalten: [Anweisungsschritt 1.1, Anweisungsschritt 1.2]. |
Anweisungsschritt[] |
| Anweisungen |
Ruft die Details des Anweisungsschritts ab oder legt diese fest. |
AnweisungSchrittDetails[] |
| Titel |
Dient zum Abrufen oder Festlegen des Titels des Anweisungsschritts. |
Schnur |
AnleitungSchrittDetails
| Name |
Beschreibung |
Wert |
| Parameter |
Ruft die Parametereinstellungen für den Anweisungstyp ab oder legt diese fest. |
beliebig (erforderlich) |
| Art |
Ruft den Namen des Anweisungstyps ab oder legt den Namen fest. |
Zeichenfolge (erforderlich) |
ResourceProviderRequiredPermissions
| Name |
Beschreibung |
Wert |
| Aktion |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung benutzerdefinierte Aktionen (POST) ist. |
Bool |
| löschen |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung Löschaktion (DELETE) ist. |
Bool |
| lesen |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung leseaktion (GET) ist. |
Bool |
| schreiben |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung Schreibaktion (PUT oder PATCH) ist. |
Bool |
ARM-Vorlagenressourcendefinition
Der dataConnectorDefinitions-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Um eine Microsoft.SecurityInsights/dataConnectorDefinitions-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"etag": "string",
"name": "string",
"kind": "string"
// For remaining properties, see Microsoft.SecurityInsights/dataConnectorDefinitions objects
}
Microsoft.SecurityInsights/dataConnectorDefinitions-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für Anpassbare:
{
"kind": "Customizable",
"properties": {
"connectionsConfig": {
"templateSpecName": "string",
"templateSpecVersion": "string"
},
"connectorUiConfig": {
"availability": {
"isPreview": "bool",
"status": "int"
},
"connectivityCriteria": [
{
"type": "string",
"value": [ "string" ]
}
],
"dataTypes": [
{
"lastDataReceivedQuery": "string",
"name": "string"
}
],
"descriptionMarkdown": "string",
"graphQueries": [
{
"baseQuery": "string",
"legend": "string",
"metricName": "string"
}
],
"id": "string",
"instructionSteps": [
{
"description": "string",
"innerSteps": [
...
],
"instructions": [
{
"parameters": {},
"type": "string"
}
],
"title": "string"
}
],
"isConnectivityCriteriasMatchSome": "bool",
"logo": "string",
"permissions": {
"customs": [
{
"description": "string",
"name": "string"
}
],
"licenses": [ "string" ],
"resourceProvider": [
{
"permissionsDisplayText": "string",
"provider": "string",
"providerDisplayName": "string",
"requiredPermissions": {
"action": "bool",
"delete": "bool",
"read": "bool",
"write": "bool"
},
"scope": "string"
}
],
"tenant": [ "string" ]
},
"publisher": "string",
"title": "string"
},
"createdTimeUtc": "string",
"lastModifiedUtc": "string"
}
}
Eigenschaftswerte
Microsoft.SecurityInsights/dataConnectorDefinitions
| Name |
Beschreibung |
Wert |
| apiVersion (Englisch) |
Die API-Version |
'2025-09-01' |
| etag |
Etag der Azure-Ressource |
Schnur |
| Art |
Legen Sie für den Typ CustomizeableConnectorDefinitionauf "Anpassbar" fest. |
"Anpassbar" (erforderlich) |
| Name |
Der Ressourcenname |
Schnur
Zwänge: Pattern = ^[a-z0-9A-Z-_]*$ (erforderlich) |
| Art |
Der Ressourcentyp |
"Microsoft.SecurityInsights/dataConnectorDefinitions" |
ConnectivityKriterium
| Name |
Beschreibung |
Wert |
| Art |
Dient zum Abrufen oder Festlegen des Verbindungstyps. |
Zeichenfolge (erforderlich) |
| Wert |
Ruft die Abfragen für die Überprüfung der Konnektivität ab oder legt sie fest. |
Zeichenfolge[] |
ConnectorDataType
| Name |
Beschreibung |
Wert |
| lastDataReceivedQuery |
Dient zum Abrufen oder Festlegen der Abfrage, die angibt, wann relevante Daten zuletzt im Arbeitsbereich empfangen wurden. |
Zeichenfolge (erforderlich) |
| Name |
Ruft den Namen des Datentyps ab, der im Diagramm angezeigt werden soll, oder legt diesen fest. |
Zeichenfolge (erforderlich) |
KonnektorDefinitionenVerfügbarkeit
| Name |
Beschreibung |
Wert |
| isVorschau |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Connector eine Vorschau ist. |
Bool |
| Status |
Der Belichtungsstatus des Verbinders für die Kunden. Verfügbare Werte sind 0-4 (0=None, 1=Available, 2=FeatureFlag, 3=Internal). |
Int |
KonnektorDefinitionenBerechtigungen
| Name |
Beschreibung |
Wert |
| Zoll |
Ruft die zollrechtlichen Berechtigungen ab, die für den Benutzer zum Erstellen von Verbindungen erforderlich sind, oder legt diese fest. |
CustomPermissionDetails[] |
| Lizenzen |
Ruft die erforderlichen Lizenzen für den Benutzer ab, um Verbindungen zu erstellen, oder legt diese fest. |
Zeichenfolge[] |
| Ressourcenanbieter |
Dient zum Abrufen oder Festlegen der Ressourcenanbieterberechtigungen, die für den Benutzer zum Erstellen von Verbindungen erforderlich sind. |
ConnectorDefinitionsResourceProvider[] |
| Mieter |
Ruft die erforderlichen Mandantenberechtigungen für den Connector ab oder legt diese fest. |
Zeichenfolge[] |
ConnectorDefinitionsResourceProvider
| Name |
Beschreibung |
Wert |
| BerechtigungenDisplayText |
Dient zum Abrufen oder Festlegen des Berechtigungsbeschreibungstexts. |
Zeichenfolge (erforderlich) |
| Anbieter |
Dient zum Abrufen oder Festlegen des Anbieternamens. |
Zeichenfolge (erforderlich) |
| providerAnzeigename |
Dient zum Abrufen oder Festlegen des Anzeigenamens des Berechtigungsanbieters. |
Zeichenfolge (erforderlich) |
| requiredBerechtigungen |
Erforderliche Berechtigungen für den Connectorressourcenanbieter, der in ResourceProviders definiert ist. Weitere Informationen zu den Berechtigungen finden Sie <unter href="/azure/role-based-access-control/role-definitions#actions-format">hier</see>. |
ResourceProviderRequiredPermissions- (erforderlich) |
| Umfang |
Der Bereich, für den der Benutzer über Berechtigungen verfügen soll, um Verbindungen erstellen zu können. |
"ResourceGroup" "Abonnement" "Arbeitsbereich" (erforderlich) |
CustomizeableConnectionsConfig
| Name |
Beschreibung |
Wert |
| templateSpecName |
Dient zum Abrufen oder Festlegen des Vorlagennamens. Die Vorlage enthält ARM-Vorlagen, die vom Connector erstellt werden können. In der Regel handelt es sich um die ARM-Vorlagen für dataConnectors. |
Zeichenfolge (erforderlich) |
| templateSpecVersion |
Ruft die Vorlagenversion ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
CustomizeableConnectorDefinition
CustomizeableConnectorDefinitionProperties
| Name |
Beschreibung |
Wert |
| connectionsConfig |
Die UiConfig für die Connectordefinitionsart 'Customizeable'. |
CustomizeableConnectionsConfig- |
| connectorUiConfig |
Die UiConfig für die Connectordefinitionsart 'Customizeable'. |
CustomizeableConnectorUiConfig (erforderlich) |
| createdTimeUtc |
Ruft das Erstellungsdatum der Connectordefinition im UTC-Format ab, oder legt diese fest. |
Schnur |
| lastModifiedUtc |
Ruft das Datum der letzten Änderung des Verbinders im UTC-Format ab oder legt diese fest. |
Schnur |
CustomizeableConnectorUiConfig
| Name |
Beschreibung |
Wert |
| Verfügbarkeit |
Der Belichtungsstatus des Verbinders für die Kunden. |
ConnectorDefinitionsAvailability- |
| KonnektivitätKriterien |
Ruft ab oder legt fest, wie der Verbinder überprüft, ob der Verbinder verbunden ist. |
ConnectivityCriterion-[] (erforderlich) |
| Datentypen |
Ruft die Datentypen ab, die auf die zuletzt empfangenen Daten überprüft werden sollen, oder legt diese fest. |
ConnectorDataType-[] (erforderlich) |
| BeschreibungMarkdown |
Ruft die Verbinderbeschreibung im Markdown-Format ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
| graphQueries |
Ruft die Diagrammabfragen ab, um das aktuelle Datenvolumen im Laufe der Zeit anzuzeigen, oder legt diese fest. |
GraphQuery[] (erforderlich) |
| id |
Ruft die benutzerdefinierte Connector-ID ab oder legt diese fest. Optionales Feld. |
Schnur |
| instructionSchritte |
Ruft die Anweisungsschritte ab, um den Connector zu aktivieren, oder legt diese fest. |
InstructionStep[] (erforderlich) |
| isConnectivityCriteriaMatchSome |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob 'OR'(SOME) oder 'AND' zwischen ConnectivityCriteria-Elementen verwendet werden soll. |
Bool |
| Logo |
Ruft das Connectorlogo ab, das beim Anzeigen des Verbinders im Katalog des Connectors von Azure Sentinel verwendet werden soll, oder legt dieses fest. Der Logowert sollte im SVG-Format vorliegen. |
Schnur |
| Erlaubnisse |
Die erforderlichen Berechtigungen für den Connector. |
ConnectorDefinitionsPermissions- (erforderlich) |
| Verlag |
Ruft den Herausgebernamen des Verbinders ab oder legt den Namen fest. |
Zeichenfolge (erforderlich) |
| Titel |
Ruft den Titel des Verbinderblatts ab oder legt den Titel fest. |
Zeichenfolge (erforderlich) |
CustomPermissionDetails
| Name |
Beschreibung |
Wert |
| Beschreibung |
Ruft die beschreibung der benutzerdefinierten Berechtigungen ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
| Name |
Dient zum Abrufen oder Festlegen des benutzerdefinierten Berechtigungsnamens. |
Zeichenfolge (erforderlich) |
Graph-Abfrage
| Name |
Beschreibung |
Wert |
| baseQuery (englisch) |
Ruft die Basisabfrage für das Diagramm ab oder legt sie fest. Die Basisabfrage wird von Sentinel-UI-Infrastruktur mit einer KQL-Abfrage umschlossen, die das Volumen im Laufe der Zeit misst. |
Zeichenfolge (erforderlich) |
| Legende |
Ruft die Legende für das Diagramm ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
| metricName |
Ruft den Metriknamen ab, den die Abfrage überprüft, oder legt diesen fest. Beispiel: "Gesamtdaten empfangen". |
Zeichenfolge (erforderlich) |
Anweisungsschritt
| Name |
Beschreibung |
Wert |
| Beschreibung |
Dient zum Abrufen oder Festlegen der Beschreibung des Anweisungsschritts. |
Schnur |
| innerSteps |
Ruft die Details der inneren Anweisungsschritte ab oder legt diese fest. Beispiel: Anweisungsschritt 1 kann innere Anweisungsschritte enthalten: [Anweisungsschritt 1.1, Anweisungsschritt 1.2]. |
Anweisungsschritt[] |
| Anweisungen |
Ruft die Details des Anweisungsschritts ab oder legt diese fest. |
AnweisungSchrittDetails[] |
| Titel |
Dient zum Abrufen oder Festlegen des Titels des Anweisungsschritts. |
Schnur |
AnleitungSchrittDetails
| Name |
Beschreibung |
Wert |
| Parameter |
Ruft die Parametereinstellungen für den Anweisungstyp ab oder legt diese fest. |
beliebig (erforderlich) |
| Art |
Ruft den Namen des Anweisungstyps ab oder legt den Namen fest. |
Zeichenfolge (erforderlich) |
ResourceProviderRequiredPermissions
| Name |
Beschreibung |
Wert |
| Aktion |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung benutzerdefinierte Aktionen (POST) ist. |
Bool |
| löschen |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung Löschaktion (DELETE) ist. |
Bool |
| lesen |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung leseaktion (GET) ist. |
Bool |
| schreiben |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung Schreibaktion (PUT oder PATCH) ist. |
Bool |
Verwendungsbeispiele
Der dataConnectorDefinitions-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Um eine Microsoft.SecurityInsights/dataConnectorDefinitions-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
resource "azapi_resource" "symbolicname" {
etag = "string"
name = "string"
kind = "string"
// For remaining properties, see Microsoft.SecurityInsights/dataConnectorDefinitions objects
}
Microsoft.SecurityInsights/dataConnectorDefinitions-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für Anpassbare:
{
kind = "Customizable"
properties = {
connectionsConfig = {
templateSpecName = "string"
templateSpecVersion = "string"
}
connectorUiConfig = {
availability = {
isPreview = bool
status = int
}
connectivityCriteria = [
{
type = "string"
value = [
"string"
]
}
]
dataTypes = [
{
lastDataReceivedQuery = "string"
name = "string"
}
]
descriptionMarkdown = "string"
graphQueries = [
{
baseQuery = "string"
legend = "string"
metricName = "string"
}
]
id = "string"
instructionSteps = [
{
description = "string"
innerSteps = [
...
]
instructions = [
{
parameters = ?
type = "string"
}
]
title = "string"
}
]
isConnectivityCriteriasMatchSome = bool
logo = "string"
permissions = {
customs = [
{
description = "string"
name = "string"
}
]
licenses = [
"string"
]
resourceProvider = [
{
permissionsDisplayText = "string"
provider = "string"
providerDisplayName = "string"
requiredPermissions = {
action = bool
delete = bool
read = bool
write = bool
}
scope = "string"
}
]
tenant = [
"string"
]
}
publisher = "string"
title = "string"
}
createdTimeUtc = "string"
lastModifiedUtc = "string"
}
}
Eigenschaftswerte
Microsoft.SecurityInsights/dataConnectorDefinitions
| Name |
Beschreibung |
Wert |
| etag |
Etag der Azure-Ressource |
Schnur |
| Art |
Legen Sie für den Typ CustomizeableConnectorDefinitionauf "Anpassbar" fest. |
"Anpassbar" (erforderlich) |
| Name |
Der Ressourcenname |
Schnur
Zwänge: Pattern = ^[a-z0-9A-Z-_]*$ (erforderlich) |
| Eltern-ID |
Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. |
Zeichenfolge (erforderlich) |
| Art |
Der Ressourcentyp |
"Microsoft.SecurityInsights/dataConnectorDefinitions@2025-09-01" |
ConnectivityKriterium
| Name |
Beschreibung |
Wert |
| Art |
Dient zum Abrufen oder Festlegen des Verbindungstyps. |
Zeichenfolge (erforderlich) |
| Wert |
Ruft die Abfragen für die Überprüfung der Konnektivität ab oder legt sie fest. |
Zeichenfolge[] |
ConnectorDataType
| Name |
Beschreibung |
Wert |
| lastDataReceivedQuery |
Dient zum Abrufen oder Festlegen der Abfrage, die angibt, wann relevante Daten zuletzt im Arbeitsbereich empfangen wurden. |
Zeichenfolge (erforderlich) |
| Name |
Ruft den Namen des Datentyps ab, der im Diagramm angezeigt werden soll, oder legt diesen fest. |
Zeichenfolge (erforderlich) |
KonnektorDefinitionenVerfügbarkeit
| Name |
Beschreibung |
Wert |
| isVorschau |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Connector eine Vorschau ist. |
Bool |
| Status |
Der Belichtungsstatus des Verbinders für die Kunden. Verfügbare Werte sind 0-4 (0=None, 1=Available, 2=FeatureFlag, 3=Internal). |
Int |
KonnektorDefinitionenBerechtigungen
| Name |
Beschreibung |
Wert |
| Zoll |
Ruft die zollrechtlichen Berechtigungen ab, die für den Benutzer zum Erstellen von Verbindungen erforderlich sind, oder legt diese fest. |
CustomPermissionDetails[] |
| Lizenzen |
Ruft die erforderlichen Lizenzen für den Benutzer ab, um Verbindungen zu erstellen, oder legt diese fest. |
Zeichenfolge[] |
| Ressourcenanbieter |
Dient zum Abrufen oder Festlegen der Ressourcenanbieterberechtigungen, die für den Benutzer zum Erstellen von Verbindungen erforderlich sind. |
ConnectorDefinitionsResourceProvider[] |
| Mieter |
Ruft die erforderlichen Mandantenberechtigungen für den Connector ab oder legt diese fest. |
Zeichenfolge[] |
ConnectorDefinitionsResourceProvider
| Name |
Beschreibung |
Wert |
| BerechtigungenDisplayText |
Dient zum Abrufen oder Festlegen des Berechtigungsbeschreibungstexts. |
Zeichenfolge (erforderlich) |
| Anbieter |
Dient zum Abrufen oder Festlegen des Anbieternamens. |
Zeichenfolge (erforderlich) |
| providerAnzeigename |
Dient zum Abrufen oder Festlegen des Anzeigenamens des Berechtigungsanbieters. |
Zeichenfolge (erforderlich) |
| requiredBerechtigungen |
Erforderliche Berechtigungen für den Connectorressourcenanbieter, der in ResourceProviders definiert ist. Weitere Informationen zu den Berechtigungen finden Sie <unter href="/azure/role-based-access-control/role-definitions#actions-format">hier</see>. |
ResourceProviderRequiredPermissions- (erforderlich) |
| Umfang |
Der Bereich, für den der Benutzer über Berechtigungen verfügen soll, um Verbindungen erstellen zu können. |
"ResourceGroup" "Abonnement" "Arbeitsbereich" (erforderlich) |
CustomizeableConnectionsConfig
| Name |
Beschreibung |
Wert |
| templateSpecName |
Dient zum Abrufen oder Festlegen des Vorlagennamens. Die Vorlage enthält ARM-Vorlagen, die vom Connector erstellt werden können. In der Regel handelt es sich um die ARM-Vorlagen für dataConnectors. |
Zeichenfolge (erforderlich) |
| templateSpecVersion |
Ruft die Vorlagenversion ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
CustomizeableConnectorDefinition
CustomizeableConnectorDefinitionProperties
| Name |
Beschreibung |
Wert |
| connectionsConfig |
Die UiConfig für die Connectordefinitionsart 'Customizeable'. |
CustomizeableConnectionsConfig- |
| connectorUiConfig |
Die UiConfig für die Connectordefinitionsart 'Customizeable'. |
CustomizeableConnectorUiConfig (erforderlich) |
| createdTimeUtc |
Ruft das Erstellungsdatum der Connectordefinition im UTC-Format ab, oder legt diese fest. |
Schnur |
| lastModifiedUtc |
Ruft das Datum der letzten Änderung des Verbinders im UTC-Format ab oder legt diese fest. |
Schnur |
CustomizeableConnectorUiConfig
| Name |
Beschreibung |
Wert |
| Verfügbarkeit |
Der Belichtungsstatus des Verbinders für die Kunden. |
ConnectorDefinitionsAvailability- |
| KonnektivitätKriterien |
Ruft ab oder legt fest, wie der Verbinder überprüft, ob der Verbinder verbunden ist. |
ConnectivityCriterion-[] (erforderlich) |
| Datentypen |
Ruft die Datentypen ab, die auf die zuletzt empfangenen Daten überprüft werden sollen, oder legt diese fest. |
ConnectorDataType-[] (erforderlich) |
| BeschreibungMarkdown |
Ruft die Verbinderbeschreibung im Markdown-Format ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
| graphQueries |
Ruft die Diagrammabfragen ab, um das aktuelle Datenvolumen im Laufe der Zeit anzuzeigen, oder legt diese fest. |
GraphQuery[] (erforderlich) |
| id |
Ruft die benutzerdefinierte Connector-ID ab oder legt diese fest. Optionales Feld. |
Schnur |
| instructionSchritte |
Ruft die Anweisungsschritte ab, um den Connector zu aktivieren, oder legt diese fest. |
InstructionStep[] (erforderlich) |
| isConnectivityCriteriaMatchSome |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob 'OR'(SOME) oder 'AND' zwischen ConnectivityCriteria-Elementen verwendet werden soll. |
Bool |
| Logo |
Ruft das Connectorlogo ab, das beim Anzeigen des Verbinders im Katalog des Connectors von Azure Sentinel verwendet werden soll, oder legt dieses fest. Der Logowert sollte im SVG-Format vorliegen. |
Schnur |
| Erlaubnisse |
Die erforderlichen Berechtigungen für den Connector. |
ConnectorDefinitionsPermissions- (erforderlich) |
| Verlag |
Ruft den Herausgebernamen des Verbinders ab oder legt den Namen fest. |
Zeichenfolge (erforderlich) |
| Titel |
Ruft den Titel des Verbinderblatts ab oder legt den Titel fest. |
Zeichenfolge (erforderlich) |
CustomPermissionDetails
| Name |
Beschreibung |
Wert |
| Beschreibung |
Ruft die beschreibung der benutzerdefinierten Berechtigungen ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
| Name |
Dient zum Abrufen oder Festlegen des benutzerdefinierten Berechtigungsnamens. |
Zeichenfolge (erforderlich) |
Graph-Abfrage
| Name |
Beschreibung |
Wert |
| baseQuery (englisch) |
Ruft die Basisabfrage für das Diagramm ab oder legt sie fest. Die Basisabfrage wird von Sentinel-UI-Infrastruktur mit einer KQL-Abfrage umschlossen, die das Volumen im Laufe der Zeit misst. |
Zeichenfolge (erforderlich) |
| Legende |
Ruft die Legende für das Diagramm ab oder legt sie fest. |
Zeichenfolge (erforderlich) |
| metricName |
Ruft den Metriknamen ab, den die Abfrage überprüft, oder legt diesen fest. Beispiel: "Gesamtdaten empfangen". |
Zeichenfolge (erforderlich) |
Anweisungsschritt
| Name |
Beschreibung |
Wert |
| Beschreibung |
Dient zum Abrufen oder Festlegen der Beschreibung des Anweisungsschritts. |
Schnur |
| innerSteps |
Ruft die Details der inneren Anweisungsschritte ab oder legt diese fest. Beispiel: Anweisungsschritt 1 kann innere Anweisungsschritte enthalten: [Anweisungsschritt 1.1, Anweisungsschritt 1.2]. |
Anweisungsschritt[] |
| Anweisungen |
Ruft die Details des Anweisungsschritts ab oder legt diese fest. |
AnweisungSchrittDetails[] |
| Titel |
Dient zum Abrufen oder Festlegen des Titels des Anweisungsschritts. |
Schnur |
AnleitungSchrittDetails
| Name |
Beschreibung |
Wert |
| Parameter |
Ruft die Parametereinstellungen für den Anweisungstyp ab oder legt diese fest. |
beliebig (erforderlich) |
| Art |
Ruft den Namen des Anweisungstyps ab oder legt den Namen fest. |
Zeichenfolge (erforderlich) |
ResourceProviderRequiredPermissions
| Name |
Beschreibung |
Wert |
| Aktion |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung benutzerdefinierte Aktionen (POST) ist. |
Bool |
| löschen |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung Löschaktion (DELETE) ist. |
Bool |
| lesen |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung leseaktion (GET) ist. |
Bool |
| schreiben |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Berechtigung Schreibaktion (PUT oder PATCH) ist. |
Bool |