Data Connectors - Get
Obtém um conector de dados.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/dataConnectors/{dataConnectorId}?api-version=2024-03-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
data
|
path | True |
string |
ID do Conector |
resource
|
path | True |
string |
O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas. |
subscription
|
path | True |
string |
A ID da assinatura de destino. |
workspace
|
path | True |
string |
O nome do workspace. Regex pattern: |
api-version
|
query | True |
string |
A versão da API a ser usada para esta operação. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK | DataConnector: |
OK, operação concluída com êxito |
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo do OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
Get a ASC data connector.
Sample Request
GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/763f9fa1-c2d3-4fa2-93e9-bccd4899aa12?api-version=2024-03-01
Sample Response
{
"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": "c0688291-89d7-4bed-87a2-a7b1bff43f4c",
"dataTypes": {
"alerts": {
"state": "Enabled"
}
}
}
}
Get a MCAS data connector.
Sample Request
GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/b96d014d-b5c2-4a01-9aba-a8058f629d42?api-version=2024-03-01
Sample Response
{
"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"
}
}
}
}
Get a MDATP data connector
Sample Request
GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/06b3ccb8-1384-4bcc-aec7-852f6d57161b?api-version=2024-03-01
Sample Response
{
"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"
}
}
}
}
Get a TI data connector.
Sample Request
GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/c345bf40-8509-4ed2-b947-50cb773aaf04?api-version=2024-03-01
Sample Response
{
"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",
"tipLookbackPeriod": "2020-01-01T13:00:30.123Z",
"dataTypes": {
"indicators": {
"state": "Enabled"
}
}
}
}
Get an AAD data connector.
Sample Request
GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/f0cd27d2-5f03-4c06-ba31-d2dc82dcb51d?api-version=2024-03-01
Sample Response
{
"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"
}
}
}
}
Get an AATP data connector.
Sample Request
GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/07e42cb3-e658-4e90-801c-efa0f29d3d44?api-version=2024-03-01
Sample Response
{
"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"
}
}
}
}
Get an AwsCloudTrail data connector.
Sample Request
GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/c345bf40-8509-4ed2-b947-50cb773aaf04?api-version=2024-03-01
Sample Response
{
"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"
}
}
}
}
Get an Office365 data connector.
Sample Request
GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/73e01a99-5cd7-4139-a149-9f2736ff2ab5?api-version=2024-03-01
Sample Response
{
"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"
},
"teams": {
"state": "Enabled"
}
}
}
}
Definições
Nome | Description |
---|---|
AADData |
Representa o conector de dados do AAD (Azure Active Directory). |
AATPData |
Representa o conector de dados AATP (Proteção Avançada contra Ameaças do Azure). |
Alerts |
Tipo de dados de alertas para conectores de dados. |
ASCData |
Representa o conector de dados ASC (Central de Segurança do Azure). |
Aws |
Representa o conector de dados CloudTrail do Amazon Web Services. |
Aws |
Os tipos de dados disponíveis para o conector de dados CloudTrail do Amazon Web Services. |
Cloud |
Estrutura de resposta de erro. |
Cloud |
Detalhes do erro. |
created |
O tipo de identidade que criou o recurso. |
Data |
Campo comum para tipo de dados em conectores de dados. |
Data |
O tipo do conector de dados |
Data |
Descreva se essa conexão de tipo de dados está habilitada ou não. |
Exchange |
Conexão de tipo de dados do Exchange. |
Indicators |
Tipo de dados para conexão de indicadores. |
Logs |
Tipo de dados de logs. |
MCASData |
Representa o conector de dados MCAS (Microsoft Cloud App Security). |
MCASData |
Os tipos de dados disponíveis para o conector de dados MCAS (Microsoft Cloud App Security). |
MDATPData |
Representa o conector de dados MDATP (Microsoft Defender Proteção Avançada contra Ameaças). |
Office |
Representa o conector de dados do Office. |
Office |
Os tipos de dados disponíveis para o conector de dados do Office. |
Share |
Conexão de tipo de dados do SharePoint. |
system |
Metadados relativos à criação e à última modificação do recurso. |
Teams |
Conexão de tipo de dados do Teams. |
TIData |
Representa o conector de dados de inteligência contra ameaças. |
TIData |
Os tipos de dados disponíveis para o conector de dados ti (Inteligência contra Ameaças). |
AADDataConnector
Representa o conector de dados do AAD (Azure Active Directory).
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag do recurso do azure |
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
kind |
string:
Azure |
O tipo de conector de dados |
name |
string |
O nome do recurso |
properties.dataTypes |
Os tipos de dados disponíveis para o conector. |
|
properties.tenantId |
string |
A ID do locatário à qual se conectar e obter os dados. |
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
AATPDataConnector
Representa o conector de dados AATP (Proteção Avançada contra Ameaças do Azure).
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag do recurso do azure |
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
kind |
string:
Azure |
O tipo de conector de dados |
name |
string |
O nome do recurso |
properties.dataTypes |
Os tipos de dados disponíveis para o conector. |
|
properties.tenantId |
string |
A ID do locatário à qual se conectar e obter os dados. |
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
AlertsDataTypeOfDataConnector
Tipo de dados de alertas para conectores de dados.
Nome | Tipo | Description |
---|---|---|
alerts |
Alertas de conexão de tipo de dados. |
ASCDataConnector
Representa o conector de dados ASC (Central de Segurança do Azure).
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag do recurso do azure |
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
kind |
string:
Azure |
O tipo de conector de dados |
name |
string |
O nome do recurso |
properties.dataTypes |
Os tipos de dados disponíveis para o conector. |
|
properties.subscriptionId |
string |
A ID da assinatura à qual se conectar e obter os dados. |
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
AwsCloudTrailDataConnector
Representa o conector de dados CloudTrail do Amazon Web Services.
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag do recurso do azure |
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
kind |
string:
Amazon |
O tipo de conector de dados |
name |
string |
O nome do recurso |
properties.awsRoleArn |
string |
A Aws Role Arn (com a política CloudTrailReadOnly) usada para acessar a conta da Aws. |
properties.dataTypes |
Os tipos de dados disponíveis para o conector. |
|
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
AwsCloudTrailDataConnectorDataTypes
Os tipos de dados disponíveis para o conector de dados CloudTrail do Amazon Web Services.
Nome | Tipo | Description |
---|---|---|
logs |
Tipo de dados de logs. |
CloudError
Estrutura de resposta de erro.
Nome | Tipo | Description |
---|---|---|
error |
Dados do erro |
CloudErrorBody
Detalhes do erro.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente. |
message |
string |
Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário. |
createdByType
O tipo de identidade que criou o recurso.
Nome | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataConnectorDataTypeCommon
Campo comum para tipo de dados em conectores de dados.
Nome | Tipo | Description |
---|---|---|
state |
Descreva se essa conexão de tipo de dados está habilitada ou não. |
DataConnectorKind
O tipo do conector de dados
Nome | Tipo | Description |
---|---|---|
AmazonWebServicesCloudTrail |
string |
|
AzureActiveDirectory |
string |
|
AzureAdvancedThreatProtection |
string |
|
AzureSecurityCenter |
string |
|
MicrosoftCloudAppSecurity |
string |
|
MicrosoftDefenderAdvancedThreatProtection |
string |
|
Office365 |
string |
|
ThreatIntelligence |
string |
DataTypeState
Descreva se essa conexão de tipo de dados está habilitada ou não.
Nome | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
Exchange
Conexão de tipo de dados do Exchange.
Nome | Tipo | Description |
---|---|---|
state |
Descreva se essa conexão de tipo de dados está habilitada ou não. |
Indicators
Tipo de dados para conexão de indicadores.
Nome | Tipo | Description |
---|---|---|
state |
Descreva se essa conexão de tipo de dados está habilitada ou não. |
Logs
Tipo de dados de logs.
Nome | Tipo | Description |
---|---|---|
state |
Descreva se essa conexão de tipo de dados está habilitada ou não. |
MCASDataConnector
Representa o conector de dados MCAS (Microsoft Cloud App Security).
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag do recurso do azure |
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
kind |
string:
Microsoft |
O tipo de conector de dados |
name |
string |
O nome do recurso |
properties.dataTypes |
Os tipos de dados disponíveis para o conector. |
|
properties.tenantId |
string |
A ID do locatário à qual se conectar e obter os dados. |
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
MCASDataConnectorDataTypes
Os tipos de dados disponíveis para o conector de dados MCAS (Microsoft Cloud App Security).
Nome | Tipo | Description |
---|---|---|
alerts |
Alertas de conexão de tipo de dados. |
|
discoveryLogs |
Conexão de tipo de dados de log de descoberta. |
MDATPDataConnector
Representa o conector de dados MDATP (Microsoft Defender Proteção Avançada contra Ameaças).
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag do recurso do azure |
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
kind |
string:
Microsoft |
O tipo de conector de dados |
name |
string |
O nome do recurso |
properties.dataTypes |
Os tipos de dados disponíveis para o conector. |
|
properties.tenantId |
string |
A ID do locatário à qual se conectar e obter os dados. |
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
OfficeDataConnector
Representa o conector de dados do Office.
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag do recurso do azure |
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
kind |
string:
Office365 |
O tipo de conector de dados |
name |
string |
O nome do recurso |
properties.dataTypes |
Os tipos de dados disponíveis para o conector. |
|
properties.tenantId |
string |
A ID do locatário à qual se conectar e obter os dados. |
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
OfficeDataConnectorDataTypes
Os tipos de dados disponíveis para o conector de dados do Office.
Nome | Tipo | Description |
---|---|---|
exchange |
Conexão de tipo de dados do Exchange. |
|
sharePoint |
Conexão de tipo de dados do SharePoint. |
|
teams |
Conexão de tipo de dados do Teams. |
SharePoint
Conexão de tipo de dados do SharePoint.
Nome | Tipo | Description |
---|---|---|
state |
Descreva se essa conexão de tipo de dados está habilitada ou não. |
systemData
Metadados relativos à criação e à última modificação do recurso.
Nome | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
Teams
Conexão de tipo de dados do Teams.
Nome | Tipo | Description |
---|---|---|
state |
Descreva se essa conexão de tipo de dados está habilitada ou não. |
TIDataConnector
Representa o conector de dados de inteligência contra ameaças.
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag do recurso do azure |
id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
kind |
string:
Threat |
O tipo de conector de dados |
name |
string |
O nome do recurso |
properties.dataTypes |
Os tipos de dados disponíveis para o conector. |
|
properties.tenantId |
string |
A ID do locatário à qual se conectar e obter os dados. |
properties.tipLookbackPeriod |
string |
O período de pesquisa para o feed a ser importado. |
systemData |
Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy. |
|
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
TIDataConnectorDataTypes
Os tipos de dados disponíveis para o conector de dados ti (Inteligência contra Ameaças).
Nome | Tipo | Description |
---|---|---|
indicators |
Tipo de dados para conexão de indicadores. |