Data Connectors - Connect

Serviço:

Sentinel

Versão da API:

2025-01-01-preview

Conecta um conector de dados.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/dataConnectors/{dataConnectorId}/connect?api-version=2025-01-01-preview

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 diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string uuid	A ID da assinatura de destino. O valor deve ser um UUID.
workspaceName	path	True	string	O nome do espaço 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 ser usada para esta operação.

Corpo do Pedido

Name	Tipo	Description
apiKey	string	A chave API do servidor de auditoria.
authorizationCode	string	O código de autorização usado no fluxo de código OAuth 2.0 para emitir um token.
clientId	string	A ID do cliente do aplicativo OAuth 2.0.
clientSecret	string	O segredo do cliente do aplicativo OAuth 2.0.
dataCollectionEndpoint	string	Usado no conector de logs v2. Representa o ponto de extremidade de ingestão de coleta de dados na análise de log.
dataCollectionRuleImmutableId	string	Usado no conector de logs v2. A regra de coleta de dados id imutável, a regra define a transformação e o destino dos dados.
kind	ConnectAuthKind	O tipo de autenticação usado para sondar os dados
outputStream	string	Usado no conector de logs v2. O fluxo para o qual estamos enviando os dados, este é o nome do streamDeclarations definido no DCR.
password	string	A senha do usuário no servidor de log de auditoria.
requestConfigUserInputValues	object[]
userName	string	O nome de usuário no servidor de log de auditoria.

Respostas

Name	Tipo	Description
200 OK		OK, Operação concluída com êxito
Other Status Codes	CloudError	Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Connect an APIPolling data connector

Connect an APIPolling V2 logs data connector

Connect an APIPolling data connector

Pedido de amostra

HTTP

POST https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/316ec55e-7138-4d63-ab18-90c8a60fd1c8/connect?api-version=2025-01-01-preview

{
  "kind": "APIKey",
  "apiKey": "123456789",
  "requestConfigUserInputValues": [
    {
      "displayText": "Organization Name",
      "placeHolderName": "{{placeHolder1}}",
      "placeHolderValue": "somePlaceHolderValue",
      "requestObjectKey": "apiEndpoint"
    }
  ]
}

Resposta da amostra

Código de estado:

200

Connect an APIPolling V2 logs data connector

Pedido de amostra

HTTP

POST https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/dataConnectors/316ec55e-7138-4d63-ab18-90c8a60fd1c8/connect?api-version=2025-01-01-preview

{
  "kind": "APIKey",
  "apiKey": "123456789",
  "dataCollectionEndpoint": "https://test.eastus.ingest.monitor.azure.com",
  "dataCollectionRuleImmutableId": "dcr-34adsj9o7d6f9de204478b9cgb43b631",
  "outputStream": "Custom-MyTableRawData",
  "requestConfigUserInputValues": [
    {
      "displayText": "Organization Name",
      "placeHolderName": "{{placeHolder1}}",
      "placeHolderValue": "somePlaceHolderValue",
      "requestObjectKey": "apiEndpoint"
    }
  ]
}

Resposta da amostra

Código de estado:

200

Definições

Name	Description
CloudError	Estrutura de resposta a erros.
CloudErrorBody	Detalhes do erro.
ConnectAuthKind	O tipo de autenticação usado para sondar os dados
DataConnectorConnectBody	Representa o conector de dados Codeless API Polling.

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 descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.

ConnectAuthKind

O tipo de autenticação usado para sondar os dados

Name	Tipo	Description
APIKey	string
Basic	string
OAuth2	string

DataConnectorConnectBody

Representa o conector de dados Codeless API Polling.

Name	Tipo	Description
apiKey	string	A chave API do servidor de auditoria.
authorizationCode	string	O código de autorização usado no fluxo de código OAuth 2.0 para emitir um token.
clientId	string	A ID do cliente do aplicativo OAuth 2.0.
clientSecret	string	O segredo do cliente do aplicativo OAuth 2.0.
dataCollectionEndpoint	string	Usado no conector de logs v2. Representa o ponto de extremidade de ingestão de coleta de dados na análise de log.
dataCollectionRuleImmutableId	string	Usado no conector de logs v2. A regra de coleta de dados id imutável, a regra define a transformação e o destino dos dados.
kind	ConnectAuthKind	O tipo de autenticação usado para sondar os dados
outputStream	string	Usado no conector de logs v2. O fluxo para o qual estamos enviando os dados, este é o nome do streamDeclarations definido no DCR.
password	string	A senha do usuário no servidor de log de auditoria.
requestConfigUserInputValues	object[]
userName	string	O nome de usuário no servidor de log de auditoria.