Partilhar via


Criar um ponto final privado gerido para o Azure Data Explorer

Os pontos finais privados geridos são necessários para ligar a recursos do Azure altamente protegidos. São ligações privadas unidirecionais que permitem ao Azure Data Explorer ligar a outros serviços protegidos. Neste artigo, irá aprender a criar um ponto final privado gerido e a ligá-lo à sua origem de dados.

Pré-requisitos

Criar um ponto final privado gerido com o portal do Azure

Pode criar um ponto final privado gerido com o portal para o cluster utilizar ao aceder ao seu armazenamento.

  1. No portal do Azure, navegue para o cluster e, em seguida, selecione Rede.

  2. Selecione Pontos finais privados geridos e, em seguida, selecione Adicionar.

    Captura de ecrã da página de rede a mostrar o primeiro passo na criação de um ponto final privado gerido.

  3. No painel Novo ponto final privado gerido , preencha os detalhes do recurso com as seguintes informações e, em seguida, selecione Seguinte.

    Captura de ecrã da página de rede a mostrar o segundo passo na criação de um ponto final privado gerido.

    Definição Valor sugerido Descrição do campo
    Name mpeToStorage O nome do ponto final privado gerido
    Subscrição A sua subscrição Selecione a subscrição do Azure que pretende utilizar para o cluster
    Tipo de recurso Microsoft.Storage/storageAccounts Selecione o tipo de recursos relevante que pretende para a sua origem de dados.
    Nome do recurso partilhar Escolha o cluster que deve ser utilizado como destino para o novo Ponto Final Privado do Azure
    Recurso secundário de destino blob Selecione o destino relevante para a sua origem de dados.
  4. selecione Criar para criar o recurso de ponto final privado gerido.

Criar um ponto final privado gerido com a API REST

A criação de um ponto final privado gerido requer uma única chamada à API para o fornecedor de recursos do Kusto . Pode estabelecer um ponto final privado gerido para os seguintes tipos de recursos:

  • Microsoft.Storage/storageAccounts (o sub-recurso pode ser "blob" ou "dfs")
  • Microsoft.EventHub/espaços de nomes (sub-recurso "espaço de nomes")
  • Microsoft.Devices/IoTHubs (sub-recurso "iotHub")
  • Microsoft.KeyVault/vaults (sub-recurso "cofre")
  • Microsoft.Sql/servers (sub-recurso "sqlServer")
  • Microsoft.Kusto/clusters (sub-recurso "cluster")
  • Microsoft.DigitalTwins/digitalTwinsInstance (sub-recurso "digitaltwinsinstance")

Neste exemplo, irá utilizar o ARMclient no PowerShell para criar um ponto final privado gerido com a API REST.

Nota

Ligar a uma conta de armazenamento um recurso "dfs" requer um ponto final privado gerido adicional para o sub-recurso "blob".

Pré-requisitos para utilizar a API REST

  1. Instalar o choco

  2. Instalar o ARMClient

    choco install armclient
    
  3. Iniciar sessão com o ARMClient

    armclient login
    

Criar um ponto final privado gerido para Hubs de Eventos do Azure

Utilize a seguinte chamada à API REST para ativar o ponto final privado gerido para um serviço dos Hubs de Eventos:

  1. Execute o seguinte comando para criar um ponto final privado gerido para um serviço dos Hubs de Eventos:

    # Replace the <...> placeholders with the correct values
    armclient PUT /subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/clusters/<clusterName>/managedPrivateEndpoints/<newMpeName>?api-version=2022-02-01 @"
    {
        'properties': {
            'privateLinkResourceId':'/subscriptions/<subscriptionIdEventHub>/resourceGroups/<resourceGroupNameEventHub>/providers/Microsoft.EventHub/namespaces/<EventHubNamespace>',
            'groupId':'namespace',
            'requestMessage':'Please Approve.'
        }
    }
    "@
    
  2. Verifique a resposta.

    {
      "id": "/subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/Clusters/<clusterName>/ManagedPrivateEndpoints/<newMpeName>",
      "name": "<clusterName>/<newMpeName>",
      "type": "Microsoft.Kusto/Clusters/ManagedPrivateEndpoints",
      "location": "DummyLocation",
      "properties": {
        "privateLinkResourceId": "/subscriptions/<subscriptionIdEventHub>/resourceGroups/<resourceGroupNameEventHub>/providers/Microsoft.EventHub/namespaces/<EventHubNamespace>",
        "groupId": "namespace",
        "requestMessage": "Please Approve.",
        "provisioningState": "Creating"
      }
    }
    

Criar um ponto final privado gerido para uma conta de Armazenamento do Azure

Utilize a seguinte chamada à API REST para ativar o ponto final privado gerido para um blob de Armazenamento do Azure:

  1. Execute o seguinte comando para criar um ponto final privado gerido para os Hubs de Eventos:

    #replace the <...> placeholders with the correct values
    armclient PUT /subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/clusters/<clusterName>/managedPrivateEndpoints/<newMpeName>?api-version=2022-02-01 @"
    {
        'properties': {
            'privateLinkResourceId':'/subscriptions/<subscriptionIdStorage>/resourceGroups/<resourceGroupNameStorage>/providers/Microsoft.Storage/storageAccounts/<storageAccountName>',
            'groupId':'blob',
            'requestMessage':'Please Approve.'
        }
    }
    "@
    
  2. Verifique a resposta.

    {
      "id": "/subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/Clusters/<clusterName>/ManagedPrivateEndpoints/<newMpeName>",
      "name": "<clusterName>/<newMpeName>",
      "type": "Microsoft.Kusto/Clusters/ManagedPrivateEndpoints",
      "location": "DummyLocation",
      "properties": {
        "privateLinkResourceId": "/subscriptions/<subscriptionIdStorage>/resourceGroups/<resourceGroupNameStorage>/providers/Microsoft.Storage/storageAccounts/<storageAccountName>",
        "groupId": "blob",
        "requestMessage": "Please Approve.",
        "provisioningState": "Creating"
      }
    }
    

Como verificar o progresso

Para verificar o progresso da migração do ponto final privado gerido, utilize o seguinte comando:

  1. Execute o seguinte comando:

    #replace the <...> placeholders with the correct values
    armclient GET /subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/clusters/<clusterName>/managedPrivateEndpoints/<newMpeName>?api-version=2022-02-01
    
  2. Verifique a resposta.

    {
      "id": "/subscriptions/<subscriptionIdADX>/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.Kusto/Clusters/<clusterName>/ManagedPrivateEndpoints/<newMpeName>",
      "name": "<clusterName>/<newMpeName>",
      "type": "Microsoft.Kusto/Clusters/ManagedPrivateEndpoints",
      "location": "DummyLocation",
      "properties": {
        "privateLinkResourceId": "/subscriptions/02de0e00-8c52-405c-9088-1342de78293d/resourceGroups/<resourceGroupNameADX>/providers/Microsoft.<service>/<...>/<name>",
        "groupId": "<groupId>",
        "requestMessage": "Please Approve.",
        "provisioningState": "Succeeded"
      },
      "systemData": {
        "createdBy": "<UserName>",
        "createdByType": "User",
        "createdAt": "2022-02-05T08:29:54.2912851Z",
        "lastModifiedBy": "chrisqpublic@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2022-02-05T08:29:54.2912851Z"
      }
    }
    

Aprovar o ponto final privado gerido

Independentemente do método que utilizou para criar o ponto final privado gerido com, tem de aprovar a respetiva criação no recurso de destino. O exemplo seguinte mostra a aprovação de um ponto final privado gerido para um serviço dos Hubs de Eventos.

  1. No portal do Azure, navegue para o serviço Hubs de Eventos e, em seguida, selecione Rede.

  2. Selecione Ligações de ponto final privado, selecione o ponto final privado gerido que criou e, em seguida, selecione Aprovar.

    Captura de ecrã da página de rede a mostrar a aprovação do ponto final privado gerido para o serviço Hubs de Eventos.

  3. Na coluna Estado da ligação , verifique se o ponto final privado gerido foi aprovado.

    Captura de ecrã da página de rede a mostrar o ponto final privado gerido aprovado para o serviço Hubs de Eventos.

O cluster pode agora ligar-se ao recurso com a ligação de ponto final privado gerido.