Data Connectors - List

Service:

Sentinel

API Version:

2024-03-01

Obtiene todos los conectores de datos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/dataConnectors?api-version=2024-03-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string	Identificador de la suscripción de destino.
workspaceName	path	True	string	El nombre del área de trabajo. Regex pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version	query	True	string	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	DataConnectorList	Correcto, operación completada correctamente
Other Status Codes	CloudError	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Get all data connectors.

Sample Request

HTTP

GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors?api-version=2024-03-01

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/763f9fa1-c2d3-4fa2-93e9-bccd4899aa12",
      "name": "763f9fa1-c2d3-4fa2-93e9-bccd4899aa12",
      "type": "Microsoft.SecurityInsights/dataConnectors",
      "kind": "AzureSecurityCenter",
      "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
      "properties": {
        "subscriptionId": "d0cfe6b2-9ac0-4464-9919-dccaee2e48c0",
        "dataTypes": {
          "alerts": {
            "state": "Enabled"
          }
        }
      }
    },
    {
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/c345bf40-8509-4ed2-b947-50cb773aaf04",
      "name": "c345bf40-8509-4ed2-b947-50cb773aaf04",
      "type": "Microsoft.SecurityInsights/dataConnectors",
      "kind": "ThreatIntelligence",
      "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
      "properties": {
        "tenantId": "2070ecc9-b4d5-4ae4-adaa-936fa1954fa8",
        "dataTypes": {
          "indicators": {
            "state": "Enabled"
          }
        }
      }
    },
    {
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/f0cd27d2-5f03-4c06-ba31-d2dc82dcb51d",
      "name": "f0cd27d2-5f03-4c06-ba31-d2dc82dcb51d",
      "type": "Microsoft.SecurityInsights/dataConnectors",
      "kind": "AzureActiveDirectory",
      "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
      "properties": {
        "tenantId": "2070ecc9-b4d5-4ae4-adaa-936fa1954fa8",
        "dataTypes": {
          "alerts": {
            "state": "Enabled"
          }
        }
      }
    },
    {
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/73e01a99-5cd7-4139-a149-9f2736ff2ab5",
      "name": "73e01a99-5cd7-4139-a149-9f2736ff2ab5",
      "type": "Microsoft.SecurityInsights/dataConnectors",
      "kind": "Office365",
      "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
      "properties": {
        "tenantId": "2070ecc9-b4d5-4ae4-adaa-936fa1954fa8",
        "dataTypes": {
          "sharePoint": {
            "state": "Enabled"
          },
          "exchange": {
            "state": "Enabled"
          }
        }
      }
    },
    {
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/b96d014d-b5c2-4a01-9aba-a8058f629d42",
      "name": "b96d014d-b5c2-4a01-9aba-a8058f629d42",
      "type": "Microsoft.SecurityInsights/dataConnectors",
      "kind": "MicrosoftCloudAppSecurity",
      "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
      "properties": {
        "tenantId": "2070ecc9-b4d5-4ae4-adaa-936fa1954fa8",
        "dataTypes": {
          "alerts": {
            "state": "Enabled"
          },
          "discoveryLogs": {
            "state": "Enabled"
          }
        }
      }
    },
    {
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/07e42cb3-e658-4e90-801c-efa0f29d3d44",
      "name": "07e42cb3-e658-4e90-801c-efa0f29d3d44",
      "type": "Microsoft.SecurityInsights/dataConnectors",
      "kind": "AzureAdvancedThreatProtection",
      "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
      "properties": {
        "tenantId": "2070ecc9-b4d5-4ae4-adaa-936fa1954fa8",
        "dataTypes": {
          "alerts": {
            "state": "Enabled"
          }
        }
      }
    },
    {
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/c345bf40-8509-4ed2-b947-50cb773aaf04",
      "name": "c345bf40-8509-4ed2-b947-50cb773aaf04",
      "type": "Microsoft.SecurityInsights/dataConnectors",
      "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
      "kind": "AmazonWebServicesCloudTrail",
      "properties": {
        "awsRoleArn": "myAwsRoleArn",
        "dataTypes": {
          "logs": {
            "state": "Enabled"
          }
        }
      }
    },
    {
      "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/06b3ccb8-1384-4bcc-aec7-852f6d57161b",
      "name": "06b3ccb8-1384-4bcc-aec7-852f6d57161b",
      "type": "Microsoft.SecurityInsights/dataConnectors",
      "kind": "MicrosoftDefenderAdvancedThreatProtection",
      "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
      "properties": {
        "tenantId": "2070ecc9-b4d5-4ae4-adaa-936fa1954fa8",
        "dataTypes": {
          "alerts": {
            "state": "Enabled"
          }
        }
      }
    }
  ]
}

Definiciones

Nombre	Description
AADDataConnector	Representa el conector de datos de AAD (Azure Active Directory).
AATPDataConnector	Representa el conector de datos de AATP (Azure Advanced Threat Protection).
AlertsDataTypeOfDataConnector	Tipo de datos de alertas para conectores de datos.
ASCDataConnector	Representa el conector de datos de ASC (Azure Security Center).
AwsCloudTrailDataConnector	Representa el conector de datos de Amazon Web Services CloudTrail.
AwsCloudTrailDataConnectorDataTypes	Los tipos de datos disponibles para el conector de datos de Amazon Web Services CloudTrail.
CloudError	Estructura de respuesta de error.
CloudErrorBody	Detalles del error.
createdByType	Tipo de identidad que creó el recurso.
DataConnectorDataTypeCommon	Campo común para el tipo de datos en conectores de datos.
DataConnectorKind	El tipo del conector de datos
DataConnectorList	Enumere todos los conectores de datos.
DataTypeState	Describir si esta conexión de tipo de datos está habilitada o no.
Exchange	Conexión de tipo de datos de Exchange.
Indicators	Tipo de datos para la conexión de indicadores.
Logs	Registra el tipo de datos.
MCASDataConnector	Representa el conector de datos MCAS (Microsoft Cloud App Security).
MCASDataConnectorDataTypes	Los tipos de datos disponibles para el conector de datos mcAS (Microsoft Cloud App Security).
MDATPDataConnector	Representa el conector de datos MDATP (Microsoft Defender Advanced Threat Protection).
OfficeDataConnector	Representa el conector de datos de office.
OfficeDataConnectorDataTypes	Los tipos de datos disponibles para el conector de datos de Office.
SharePoint	Conexión de tipo de datos de SharePoint.
systemData	Metadatos relacionados con la creación y la última modificación del recurso.
Teams	Conexión de tipo de datos de Teams.
TIDataConnector	Representa el conector de datos de inteligencia sobre amenazas.
TIDataConnectorDataTypes	Los tipos de datos disponibles para el conector de datos ti (Inteligencia sobre amenazas).

AADDataConnector

Representa el conector de datos de AAD (Azure Active Directory).

Nombre	Tipo	Description
etag	string	Etag del recurso de Azure
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: AzureActiveDirectory	El tipo de conector de datos
name	string	Nombre del recurso.
properties.dataTypes	AlertsDataTypeOfDataConnector	Los tipos de datos disponibles para el conector.
properties.tenantId	string	Identificador de inquilino al que conectarse y obtener los datos.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AATPDataConnector

Representa el conector de datos de AATP (Azure Advanced Threat Protection).

Nombre	Tipo	Description
etag	string	Etag del recurso de Azure
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: AzureAdvancedThreatProtection	El tipo de conector de datos
name	string	Nombre del recurso.
properties.dataTypes	AlertsDataTypeOfDataConnector	Los tipos de datos disponibles para el conector.
properties.tenantId	string	Identificador de inquilino al que conectarse y obtener los datos.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AlertsDataTypeOfDataConnector

Tipo de datos de alertas para conectores de datos.

Nombre	Tipo	Description
alerts	DataConnectorDataTypeCommon	Alerta de conexión de tipo de datos.

ASCDataConnector

Representa el conector de datos de ASC (Azure Security Center).

Nombre	Tipo	Description
etag	string	Etag del recurso de Azure
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: AzureSecurityCenter	El tipo de conector de datos
name	string	Nombre del recurso.
properties.dataTypes	AlertsDataTypeOfDataConnector	Los tipos de datos disponibles para el conector.
properties.subscriptionId	string	El identificador de suscripción al que se va a conectar y obtener los datos.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AwsCloudTrailDataConnector

Representa el conector de datos de Amazon Web Services CloudTrail.

Nombre	Tipo	Description
etag	string	Etag del recurso de Azure
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: AmazonWebServicesCloudTrail	El tipo de conector de datos
name	string	Nombre del recurso.
properties.awsRoleArn	string	Aws Role Arn (con la directiva CloudTrailReadOnly) que se usa para acceder a la cuenta de Aws.
properties.dataTypes	AwsCloudTrailDataConnectorDataTypes	Los tipos de datos disponibles para el conector.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AwsCloudTrailDataConnectorDataTypes

Los tipos de datos disponibles para el conector de datos de Amazon Web Services CloudTrail.

Nombre	Tipo	Description
logs	Logs	Registra el tipo de datos.

CloudError

Estructura de respuesta de error.

Nombre	Tipo	Description
error	CloudErrorBody	Datos inválidos

CloudErrorBody

Detalles del error.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

createdByType

Tipo de identidad que creó el recurso.

Nombre	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DataConnectorDataTypeCommon

Campo común para el tipo de datos en conectores de datos.

Nombre	Tipo	Description
state	DataTypeState	Describir si esta conexión de tipo de datos está habilitada o no.

DataConnectorKind

El tipo del conector de datos

Nombre	Tipo	Description
AmazonWebServicesCloudTrail	string
AzureActiveDirectory	string
AzureAdvancedThreatProtection	string
AzureSecurityCenter	string
MicrosoftCloudAppSecurity	string
MicrosoftDefenderAdvancedThreatProtection	string
Office365	string
ThreatIntelligence	string

DataConnectorList

Enumere todos los conectores de datos.

Nombre	Tipo	Description
nextLink	string	Dirección URL para capturar el siguiente conjunto de conectores de datos.
value	DataConnector[]: AADDataConnector[] AATPDataConnector[] ASCDataConnector[] AwsCloudTrailDataConnector[] MCASDataConnector[] MDATPDataConnector[] OfficeDataConnector[] TIDataConnector[]	Matriz de conectores de datos.

DataTypeState

Describir si esta conexión de tipo de datos está habilitada o no.

Nombre	Tipo	Description
Disabled	string
Enabled	string

Exchange

Conexión de tipo de datos de Exchange.

Nombre	Tipo	Description
state	DataTypeState	Describir si esta conexión de tipo de datos está habilitada o no.

Indicators

Tipo de datos para la conexión de indicadores.

Nombre	Tipo	Description
state	DataTypeState	Describir si esta conexión de tipo de datos está habilitada o no.

Logs

Registra el tipo de datos.

Nombre	Tipo	Description
state	DataTypeState	Describir si esta conexión de tipo de datos está habilitada o no.

MCASDataConnector

Representa el conector de datos MCAS (Microsoft Cloud App Security).

Nombre	Tipo	Description
etag	string	Etag del recurso de Azure
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: MicrosoftCloudAppSecurity	El tipo de conector de datos
name	string	Nombre del recurso.
properties.dataTypes	MCASDataConnectorDataTypes	Los tipos de datos disponibles para el conector.
properties.tenantId	string	Identificador de inquilino al que conectarse y obtener los datos.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

MCASDataConnectorDataTypes

Los tipos de datos disponibles para el conector de datos mcAS (Microsoft Cloud App Security).

Nombre	Tipo	Description
alerts	DataConnectorDataTypeCommon	Alerta de conexión de tipo de datos.
discoveryLogs	DataConnectorDataTypeCommon	Conexión del tipo de datos del registro de detección.

MDATPDataConnector

Representa el conector de datos MDATP (Microsoft Defender Advanced Threat Protection).

Nombre	Tipo	Description
etag	string	Etag del recurso de Azure
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: MicrosoftDefenderAdvancedThreatProtection	El tipo de conector de datos
name	string	Nombre del recurso.
properties.dataTypes	AlertsDataTypeOfDataConnector	Los tipos de datos disponibles para el conector.
properties.tenantId	string	Identificador de inquilino al que conectarse y obtener los datos.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

OfficeDataConnector

Representa el conector de datos de office.

Nombre	Tipo	Description
etag	string	Etag del recurso de Azure
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: Office365	El tipo de conector de datos
name	string	Nombre del recurso.
properties.dataTypes	OfficeDataConnectorDataTypes	Los tipos de datos disponibles para el conector.
properties.tenantId	string	Identificador de inquilino al que conectarse y obtener los datos.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

OfficeDataConnectorDataTypes

Los tipos de datos disponibles para el conector de datos de Office.

Nombre	Tipo	Description
exchange	Exchange	Conexión de tipo de datos de Exchange.
sharePoint	SharePoint	Conexión de tipo de datos de SharePoint.
teams	Teams	Conexión de tipo de datos de Teams.

SharePoint

Conexión de tipo de datos de SharePoint.

Nombre	Tipo	Description
state	DataTypeState	Describir si esta conexión de tipo de datos está habilitada o no.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre	Tipo	Description
createdAt	string	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Teams

Conexión de tipo de datos de Teams.

Nombre	Tipo	Description
state	DataTypeState	Describir si esta conexión de tipo de datos está habilitada o no.

TIDataConnector

Representa el conector de datos de inteligencia sobre amenazas.

Nombre	Tipo	Description
etag	string	Etag del recurso de Azure
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
kind	string: ThreatIntelligence	El tipo de conector de datos
name	string	Nombre del recurso.
properties.dataTypes	TIDataConnectorDataTypes	Los tipos de datos disponibles para el conector.
properties.tenantId	string	Identificador de inquilino al que conectarse y obtener los datos.
properties.tipLookbackPeriod	string	Período de devolución de búsqueda para la fuente que se va a importar.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

TIDataConnectorDataTypes

Los tipos de datos disponibles para el conector de datos ti (Inteligencia sobre amenazas).

Nombre	Tipo	Description
indicators	Indicators	Tipo de datos para la conexión de indicadores.