Azure Data Explorer のマネージドプライベートエンドポイントを作成する

[アーティクル]
03/10/2023

高度に保護されている Azure リソースに接続するには、マネージドプライベートエンドポイントが必要です。これらは、Azure Data Explorerが他の保護されたサービスに接続できるようにする一方向のプライベート接続です。この記事では、マネージドプライベートエンドポイントを作成し、データソースに接続する方法について説明します。

前提条件

Azure サブスクリプション。無料の Azure アカウントを作成します。
仮想ネットワークに挿入されていない Azure Data Explorer クラスター。
Microsoft.Network リソースプロバイダーに登録されているサブスクリプション内のイベントハブまたは Azure Storage BLOB。詳細については、「サブスクリプションをリソースプロバイダーに登録する」を参照してください。

Azure portal を使用してマネージドプライベートエンドポイントを作成する

ストレージにアクセスするときに使用するために、ポータルを使用してクラスターのマネージドプライベートエンドポイントを作成できます。

Azure portal で、クラスターに移動してから [ネットワーク] を選択します。
[マネージドプライベートエンドポイント]、[追加] の順に選択します。

[新しいマネージドプライベートエンドポイント] ウィンドウで、リソースの詳細に次の情報を入力し、[次へ] を選択します。

マネージドプライベートエンドポイントの作成の次のステップを示す、[ネットワーク] ページのスクリーンショット。

設定	推奨値	フィールドの説明
名前	mpeToStorage	マネージドプライベートエンドポイントの名前
サブスクリプション	該当するサブスクリプション	クラスターに使用する Azure サブスクリプションを選択します
リソースの種類	Microsoft.Storage/storageAccounts	データソースに必要な関連リソースの種類を選択します。
リソース名	共有	新しい Azure プライベートエンドポイントの宛先として使用するクラスターを選択します
ターゲットサブリソース	blob (blob)	データソースに関連するターゲットを選択します。

[作成] を選択して、マネージドプライベートエンドポイントリソースを作成します。

REST API を使用してマネージドプライベートエンドポイントを作成する

マネージドプライベートエンドポイントを作成するには、Kusto リソースプロバイダーへの 1 つの API 呼び出しが必要です。マネージドプライベートエンドポイントは、次のリソースの種類に確立できます。

Microsoft.Storage/storageAccounts (サブリソースは "blob" または "dfs" である可能性があります)
Microsoft.EventHub/namespaces (サブリソースは "namespace")
Microsoft.Devices/IoTHubs (サブリソースは "iotHub")
Microsoft.KeyVault/vaults (サブリソースは "vault")
Microsoft.Sql/servers (サブリソースは "sqlServer")
Microsoft.Kusto/clusters (サブリソースは "cluster")
Microsoft.DigitalTwins/digitalTwinsInstance (サブリソースは "digitaltwinsinstance")

次の例では、PowerShell の ARMclient を使って、REST API を使用してマネージドプライベートエンドポイントを作成します。

注意

ストレージアカウントに "dfs" リソースに接続するには、"BLOB" サブリソースへの追加のマネージドプライベートエンドポイントが必要です。

REST API を使用するための前提条件

choco をインストールします
ARMClient をインストールします
```
choco install armclient
```
ARMClient でログインする
```
armclient login
```

Azure Event Hubs へのマネージドプライベートエンドポイントを作成する

次の REST API 呼び出しを使用して、Event Hubs サービスに対してマネージドプライベートエンドポイントを有効にします。

次のコマンドを実行して、Event Hubs サービスへのマネージドプライベートエンドポイントを作成します。

# 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.'
    }
}
"@

応答を確認します。

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

Azure Storage アカウントへのマネージドプライベートエンドポイントを作成する

次の REST API 呼び出しを使用して、Azure Storage BLOB に対してマネージドプライベートエンドポイントを有効にします。

次のコマンドを実行して、Event Hubs サービスへのマネージドプライベートエンドポイントを作成します。

#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.'
    }
}
"@

応答を確認します。

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

進行状況の確認方法

マネージドプライベートエンドポイントの移行の進行状況を確認するには、次のコマンドを使用します。

次のコマンドを実行します。

#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

応答を確認します。

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

マネージドプライベートエンドポイントを承認する

マネージドプライベートエンドポイントの作成にどのような方法を使用した場合でも、ターゲットリソースでの作成を承認する必要があります。次の例は、Event Hubs サービスへのマネージドプライベートエンドポイントの承認を示しています。

Azure portal で、Event Hubs サービスに移動してから [ネットワーク] を選択します。
[プライベートエンドポイント接続] を選択し、作成したマネージドプライベートエンドポイントを選択して、[承認] を選択します。
[接続状態] 列で、マネージドプライベートエンドポイントが承認されていることを確認します。

これで、クラスターは、マネージドプライベートエンドポイント接続を使用してリソースに接続できるようになりました。

Azure Data Explorer でのプライベートエンドポイントのトラブルシューティング

次の方法で共有

Azure Data Explorer のマネージドプライベートエンドポイントを作成する

前提条件

Azure portal を使用してマネージドプライベートエンドポイントを作成する

REST API を使用してマネージドプライベートエンドポイントを作成する

REST API を使用するための前提条件

Azure Event Hubs へのマネージドプライベートエンドポイントを作成する

Azure Storage アカウントへのマネージドプライベートエンドポイントを作成する

進行状況の確認方法

マネージドプライベートエンドポイントを承認する

フィードバック

その他のリソース

次の方法で共有

Azure Data Explorer のマネージド プライベート エンドポイントを作成する

前提条件

Azure portal を使用してマネージド プライベート エンドポイントを作成する

REST API を使用してマネージド プライベート エンドポイントを作成する

REST API を使用するための前提条件

Azure Event Hubs へのマネージド プライベート エンドポイントを作成する

Azure Storage アカウントへのマネージド プライベート エンドポイントを作成する

進行状況の確認方法

マネージド プライベート エンドポイントを承認する

関連コンテンツ

フィードバック

その他のリソース

Azure Data Explorer のマネージドプライベートエンドポイントを作成する

Azure portal を使用してマネージドプライベートエンドポイントを作成する

REST API を使用してマネージドプライベートエンドポイントを作成する

Azure Event Hubs へのマネージドプライベートエンドポイントを作成する

Azure Storage アカウントへのマネージドプライベートエンドポイントを作成する

マネージドプライベートエンドポイントを承認する