Data Connectors - Create Or Update

Cria ou atualiza o conector de dados.

PUT 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 do URI

Name Em Necessário Tipo Description
dataConnectorId
path True

string

ID do Conector

resourceGroupName
path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.

subscriptionId
path True

string

O ID da subscrição de destino.

workspaceName
path True

string

O nome da área de trabalho.

Padrão Regex: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

api-version
query True

string

A versão da API a utilizar para esta operação.

Corpo do Pedido

O corpo de pedido pode ser um dos seguintes:

Name Description
AADDataConnector

Representa o conector de dados do AAD (Azure Active Directory).

AATPDataConnector

Representa o conector de dados AATP (Azure Advanced Threat Protection).

ASCDataConnector

Representa o conector de dados do ASC (Centro de Segurança do Azure).

AwsCloudTrailDataConnector

Representa o conector de dados CloudTrail do Amazon Web Services.

MCASDataConnector

Representa o conector de dados MCAS (Microsoft Cloud App Security).

MDATPDataConnector

Representa o conector de dados MDATP (Microsoft Defender Advanced Threat Protection).

OfficeDataConnector

Representa o conector de dados do Office.

TIDataConnector

Representa o conector de dados de informações sobre ameaças.

AADDataConnector

Representa o conector de dados do AAD (Azure Active Directory).

Name Necessário Tipo Description
kind True string:

AzureActiveDirectory

O tipo de conector de dados

etag

string

Etag do recurso do Azure

properties.dataTypes

AlertsDataTypeOfDataConnector

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

AATPDataConnector

Representa o conector de dados AATP (Azure Advanced Threat Protection).

Name Necessário Tipo Description
kind True string:

AzureAdvancedThreatProtection

O tipo de conector de dados

etag

string

Etag do recurso do Azure

properties.dataTypes

AlertsDataTypeOfDataConnector

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

ASCDataConnector

Representa o conector de dados do ASC (Centro de Segurança do Azure).

Name Necessário Tipo Description
kind True string:

AzureSecurityCenter

O tipo de conector de dados

etag

string

Etag do recurso do Azure

properties.dataTypes

AlertsDataTypeOfDataConnector

Os tipos de dados disponíveis para o conector.

properties.subscriptionId

string

O ID da subscrição a partir do qual ligar e obter os dados.

AwsCloudTrailDataConnector

Representa o conector de dados CloudTrail do Amazon Web Services.

Name Necessário Tipo Description
kind True string:

AmazonWebServicesCloudTrail

O tipo de conector de dados

etag

string

Etag do recurso do Azure

properties.awsRoleArn

string

O Arn de Função do Aws (com a política CloudTrailReadOnly) que é utilizado para aceder à conta do Aws.

properties.dataTypes

AwsCloudTrailDataConnectorDataTypes

Os tipos de dados disponíveis para o conector.

MCASDataConnector

Representa o conector de dados MCAS (Microsoft Cloud App Security).

Name Necessário Tipo Description
kind True string:

MicrosoftCloudAppSecurity

O tipo de conector de dados

etag

string

Etag do recurso do Azure

properties.dataTypes

MCASDataConnectorDataTypes

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

MDATPDataConnector

Representa o conector de dados MDATP (Microsoft Defender Advanced Threat Protection).

Name Necessário Tipo Description
kind True string:

MicrosoftDefenderAdvancedThreatProtection

O tipo de conector de dados

etag

string

Etag do recurso do Azure

properties.dataTypes

AlertsDataTypeOfDataConnector

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

OfficeDataConnector

Representa o conector de dados do Office.

Name Necessário Tipo Description
kind True string:

Office365

O tipo de conector de dados

etag

string

Etag do recurso do Azure

properties.dataTypes

OfficeDataConnectorDataTypes

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

TIDataConnector

Representa o conector de dados de informações sobre ameaças.

Name Necessário Tipo Description
kind True string:

ThreatIntelligence

O tipo de conector de dados

etag

string

Etag do recurso do Azure

properties.dataTypes

TIDataConnectorDataTypes

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

properties.tipLookbackPeriod

string

O período de procura para que o feed seja importado.

Respostas

Name Tipo Description
200 OK DataConnector:

OK, Operação concluída com êxito

201 Created DataConnector:

Criado

Other Status Codes

CloudError

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Creates or updates an Office365 data connector.
Creates or updates an Threat Intelligence Platform data connector.

Creates or updates an Office365 data connector.

Pedido de amostra

PUT 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

{
  "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"
      }
    }
  }
}

Resposta da amostra

{
  "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"
      }
    }
  }
}
{
  "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"
      }
    }
  }
}

Creates or updates an Threat Intelligence Platform data connector.

Pedido de amostra

PUT 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

{
  "kind": "ThreatIntelligence",
  "properties": {
    "tenantId": "06b3ccb8-1384-4bcc-aec7-852f6d57161b",
    "tipLookbackPeriod": "2020-01-01T13:00:30.123Z",
    "dataTypes": {
      "indicators": {
        "state": "Enabled"
      }
    }
  }
}

Resposta da amostra

{
  "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": "ThreatIntelligence",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "properties": {
    "tenantId": "06b3ccb8-1384-4bcc-aec7-852f6d57161b",
    "tipLookbackPeriod": "2020-01-01T13:00:30.123Z",
    "dataTypes": {
      "indicators": {
        "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": "ThreatIntelligence",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "properties": {
    "tenantId": "06b3ccb8-1384-4bcc-aec7-852f6d57161b",
    "tipLookbackPeriod": "2020-01-01T13:00:30.123Z",
    "dataTypes": {
      "indicators": {
        "state": "Enabled"
      }
    }
  }
}

Definições

Name Description
AADDataConnector

Representa o conector de dados do AAD (Azure Active Directory).

AATPDataConnector

Representa o conector de dados AATP (Azure Advanced Threat Protection).

AlertsDataTypeOfDataConnector

Tipo de dados de alertas para conectores de dados.

ASCDataConnector

Representa o conector de dados do ASC (Centro de Segurança do Azure).

AwsCloudTrailDataConnector

Representa o conector de dados CloudTrail do Amazon Web Services.

AwsCloudTrailDataConnectorDataTypes

Os tipos de dados disponíveis para o conector de dados CloudTrail do Amazon Web Services.

CloudError

Estrutura de resposta a erros.

CloudErrorBody

Detalhes do erro.

createdByType

O tipo de identidade que criou o recurso.

DataConnectorDataTypeCommon

Campo comum para o tipo de dados nos conectores de dados.

DataConnectorKind

O tipo de conector de dados

DataTypeState

Descreva se esta ligação de tipo de dados está ativada ou não.

Exchange

Ligação de tipo de dados do Exchange.

Indicators

Tipo de dados para ligação de indicadores.

Logs

Regista o tipo de dados.

MCASDataConnector

Representa o conector de dados MCAS (Microsoft Cloud App Security).

MCASDataConnectorDataTypes

Os tipos de dados disponíveis para o conector de dados MCAS (Microsoft Cloud App Security).

MDATPDataConnector

Representa o conector de dados MDATP (Microsoft Defender Advanced Threat Protection).

OfficeDataConnector

Representa o conector de dados do Office.

OfficeDataConnectorDataTypes

Os tipos de dados disponíveis para o conector de dados do Office.

SharePoint

Ligação do tipo de dados do SharePoint.

systemData

Metadados relativos à criação e última modificação do recurso.

Teams

Ligação do tipo de dados do Teams.

TIDataConnector

Representa o conector de dados de informações sobre ameaças.

TIDataConnectorDataTypes

Os tipos de dados disponíveis para o conector de dados ti (Threat Intelligence).

AADDataConnector

Representa o conector de dados do AAD (Azure Active Directory).

Name Tipo Description
etag

string

Etag do recurso do Azure

id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

AzureActiveDirectory

O tipo de conector de dados

name

string

O nome do recurso

properties.dataTypes

AlertsDataTypeOfDataConnector

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AATPDataConnector

Representa o conector de dados AATP (Azure Advanced Threat Protection).

Name Tipo Description
etag

string

Etag do recurso do Azure

id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

AzureAdvancedThreatProtection

O tipo de conector de dados

name

string

O nome do recurso

properties.dataTypes

AlertsDataTypeOfDataConnector

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AlertsDataTypeOfDataConnector

Tipo de dados de alertas para conectores de dados.

Name Tipo Description
alerts

DataConnectorDataTypeCommon

Ligação de tipo de dados de alertas.

ASCDataConnector

Representa o conector de dados do ASC (Centro de Segurança do Azure).

Name Tipo Description
etag

string

Etag do recurso do Azure

id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

AzureSecurityCenter

O tipo de conector de dados

name

string

O nome do recurso

properties.dataTypes

AlertsDataTypeOfDataConnector

Os tipos de dados disponíveis para o conector.

properties.subscriptionId

string

O ID da subscrição a partir do qual ligar e obter os dados.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AwsCloudTrailDataConnector

Representa o conector de dados CloudTrail do Amazon Web Services.

Name Tipo Description
etag

string

Etag do recurso do Azure

id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

AmazonWebServicesCloudTrail

O tipo de conector de dados

name

string

O nome do recurso

properties.awsRoleArn

string

O Arn de Função do Aws (com a política CloudTrailReadOnly) que é utilizado para aceder à conta do Aws.

properties.dataTypes

AwsCloudTrailDataConnectorDataTypes

Os tipos de dados disponíveis para o conector.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

type

string

O 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.

Name Tipo Description
logs

Logs

Regista o tipo de dados.

CloudError

Estrutura de resposta a erros.

Name Tipo Description
error

CloudErrorBody

Dados de erro

CloudErrorBody

Detalhes do erro.

Name Tipo Description
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.

message

string

Uma mensagem que descreve o erro, que se destina a ser adequada para ser apresentada numa interface de utilizador.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

DataConnectorDataTypeCommon

Campo comum para o tipo de dados nos conectores de dados.

Name Tipo Description
state

DataTypeState

Descreva se esta ligação de tipo de dados está ativada ou não.

DataConnectorKind

O tipo de conector de dados

Name Tipo Description
AmazonWebServicesCloudTrail

string

AzureActiveDirectory

string

AzureAdvancedThreatProtection

string

AzureSecurityCenter

string

MicrosoftCloudAppSecurity

string

MicrosoftDefenderAdvancedThreatProtection

string

Office365

string

ThreatIntelligence

string

DataTypeState

Descreva se esta ligação de tipo de dados está ativada ou não.

Name Tipo Description
Disabled

string

Enabled

string

Exchange

Ligação de tipo de dados do Exchange.

Name Tipo Description
state

DataTypeState

Descreva se esta ligação de tipo de dados está ativada ou não.

Indicators

Tipo de dados para ligação de indicadores.

Name Tipo Description
state

DataTypeState

Descreva se esta ligação de tipo de dados está ativada ou não.

Logs

Regista o tipo de dados.

Name Tipo Description
state

DataTypeState

Descreva se esta ligação de tipo de dados está ativada ou não.

MCASDataConnector

Representa o conector de dados MCAS (Microsoft Cloud App Security).

Name Tipo Description
etag

string

Etag do recurso do Azure

id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

MicrosoftCloudAppSecurity

O tipo de conector de dados

name

string

O nome do recurso

properties.dataTypes

MCASDataConnectorDataTypes

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

type

string

O 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).

Name Tipo Description
alerts

DataConnectorDataTypeCommon

Ligação de tipo de dados de alertas.

discoveryLogs

DataConnectorDataTypeCommon

Ligação do tipo de dados de registo de deteção.

MDATPDataConnector

Representa o conector de dados MDATP (Microsoft Defender Advanced Threat Protection).

Name Tipo Description
etag

string

Etag do recurso do Azure

id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

MicrosoftDefenderAdvancedThreatProtection

O tipo de conector de dados

name

string

O nome do recurso

properties.dataTypes

AlertsDataTypeOfDataConnector

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

OfficeDataConnector

Representa o conector de dados do Office.

Name Tipo Description
etag

string

Etag do recurso do Azure

id

string

ID de recurso completamente qualificado 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

OfficeDataConnectorDataTypes

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

type

string

O 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.

Name Tipo Description
exchange

Exchange

Ligação de tipo de dados do Exchange.

sharePoint

SharePoint

Ligação do tipo de dados do SharePoint.

teams

Teams

Ligação do tipo de dados do Teams.

SharePoint

Ligação do tipo de dados do SharePoint.

Name Tipo Description
state

DataTypeState

Descreva se esta ligação de tipo de dados está ativada ou não.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

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

createdByType

O tipo de identidade que modificou o recurso pela última vez.

Teams

Ligação do tipo de dados do Teams.

Name Tipo Description
state

DataTypeState

Descreva se esta ligação de tipo de dados está ativada ou não.

TIDataConnector

Representa o conector de dados de informações sobre ameaças.

Name Tipo Description
etag

string

Etag do recurso do Azure

id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:

ThreatIntelligence

O tipo de conector de dados

name

string

O nome do recurso

properties.dataTypes

TIDataConnectorDataTypes

Os tipos de dados disponíveis para o conector.

properties.tenantId

string

O ID do inquilino ao qual se ligar e a partir do qual obter os dados.

properties.tipLookbackPeriod

string

O período de procura para que o feed seja importado.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

type

string

O 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 (Threat Intelligence).

Name Tipo Description
indicators

Indicators

Tipo de dados para ligação de indicadores.