Data Connections - Get

Retourne une connexion de données.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/dataConnections/{dataConnectionName}?api-version=2021-01-01

Paramètres URI

Name In Required Type Description
clusterName
path True
  • string

Nom du cluster Kusto.

databaseName
path True
  • string

Nom de la base de données dans le cluster Kusto.

dataConnectionName
path True
  • string

Nom de la connexion de données.

resourceGroupName
path True
  • string

Nom du groupe de ressources contenant le cluster Kusto.

subscriptionId
path True
  • string

Obtient les informations d'identification d'abonnement qui identifient l'abonnement Microsoft Azure de manière unique. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

api-version
query True
  • string

Version de l’API cliente.

Réponses

Name Type Description
200 OK DataConnection:

La connexion de données spécifiée a été récupérée avec succès.

Other Status Codes

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Exemples

KustoDataConnectionsGet

Sample Request

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoclusterrptest4/databases/KustoDatabase8/dataConnections/DataConnections8?api-version=2021-01-01

Sample Response

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/KustoClusterRPTest4/Databases/KustoDatabase8/DataConnections/DataConnections8",
  "name": "KustoClusterRPTest4/KustoDatabase8/DataConnections8",
  "type": "Microsoft.Kusto/Clusters/Databases/DataConnections",
  "location": "westus",
  "kind": "EventHub",
  "properties": {
    "eventHubResourceId": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.EventHub/namespaces/eventhubTestns1/eventhubs/eventhubTest1",
    "managedIdentityResourceId": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/managedidentityTest1",
    "consumerGroup": "testConsumerGroup1",
    "compression": "None"
  }
}

Définitions

blobStorageEventType

Nom du type d’événement de stockage d’objets BLOB à traiter.

CloudError

Réponse d’erreur de Kusto.

CloudErrorBody

Réponse d’erreur de Kusto.

compression

Type de compression des messages Event Hub

EventGridDataConnection

Classe représentant une connexion de données Event Grid.

eventGridDataFormat

Format de données du message. Éventuellement, le format de données peut être ajouté à chaque message.

EventHubDataConnection

Classe représentant une connexion de données Event Hub.

eventHubDataFormat

Format de données du message. Éventuellement, le format de données peut être ajouté à chaque message.

IotHubDataConnection

Classe représentant une connexion de données IOT Hub.

iotHubDataFormat

Format de données du message. Éventuellement, le format de données peut être ajouté à chaque message.

ProvisioningState

État approvisionné de la ressource.

blobStorageEventType

Nom du type d’événement de stockage d’objets BLOB à traiter.

Name Type Description
Microsoft.Storage.BlobCreated
  • string
Microsoft.Storage.BlobRenamed
  • string

CloudError

Réponse d’erreur de Kusto.

Name Type Description
error

Réponse d’erreur de Kusto.

CloudErrorBody

Réponse d’erreur de Kusto.

Name Type Description
code
  • string

Identificateur de l'erreur. Les codes sont invariants et sont destinés à être consommés par programmation.

details

Liste de détails supplémentaires sur l’erreur.

message
  • string

Message décrivant l’erreur, destiné à être affiché dans une interface utilisateur.

target
  • string

Cible de l’erreur particulière. Par exemple, le nom de la propriété dans erreur.

compression

Type de compression des messages Event Hub

Name Type Description
GZip
  • string
None
  • string

EventGridDataConnection

Classe représentant une connexion de données Event Grid.

Name Type Description
id
  • string

ID de ressource complet pour la ressource. Ex-/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:
  • EventGrid

Type de point de terminaison de la connexion de données

location
  • string

Emplacement de la ressource.

name
  • string

nom de la ressource.

properties.blobStorageEventType

Nom du type d’événement de stockage d’objets BLOB à traiter.

properties.consumerGroup
  • string

Groupe de consommateurs Event Hub.

properties.dataFormat

Format de données du message. Éventuellement, le format de données peut être ajouté à chaque message.

properties.eventHubResourceId
  • string

ID de ressource dans lequel la grille d’événements est configurée pour envoyer des événements.

properties.ignoreFirstRecord
  • boolean

Valeur booléenne qui, si sa valeur est true, indique que l’ingestion doit ignorer le premier enregistrement de chaque fichier

properties.mappingRuleName
  • string

Règle de mappage à utiliser pour la réception des données. Éventuellement, les informations de mappage peuvent être ajoutées à chaque message.

properties.provisioningState

État approvisionné de la ressource.

properties.storageAccountResourceId
  • string

L’ID de ressource du compte de stockage où résident les données.

properties.tableName
  • string

Table dans laquelle les données doivent être ingérées. Éventuellement, les informations de table peuvent être ajoutées à chaque message.

type
  • string

Type de la ressource. Par exemple, « Microsoft. Compute/virtualMachines » ou « Microsoft. Storage/storageAccounts »

eventGridDataFormat

Format de données du message. Éventuellement, le format de données peut être ajouté à chaque message.

Name Type Description
APACHEAVRO
  • string
AVRO
  • string
CSV
  • string
JSON
  • string
MULTIJSON
  • string
ORC
  • string
PARQUET
  • string
PSV
  • string
RAW
  • string
SCSV
  • string
SINGLEJSON
  • string
SOHSV
  • string
TSV
  • string
TSVE
  • string
TXT
  • string
W3CLOGFILE
  • string

EventHubDataConnection

Classe représentant une connexion de données Event Hub.

Name Type Description
id
  • string

ID de ressource complet pour la ressource. Ex-/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:
  • EventHub

Type de point de terminaison de la connexion de données

location
  • string

Emplacement de la ressource.

name
  • string

nom de la ressource.

properties.compression

Type de compression des messages Event Hub

properties.consumerGroup
  • string

Groupe de consommateurs Event Hub.

properties.dataFormat

Format de données du message. Éventuellement, le format de données peut être ajouté à chaque message.

properties.eventHubResourceId
  • string

ID de ressource de la Event Hub à utiliser pour créer une connexion de données.

properties.eventSystemProperties
  • string[]

Propriétés système de l’Event Hub

properties.managedIdentityResourceId
  • string

ID de ressource d’une identité gérée (système ou utilisateur affecté) à utiliser pour s’authentifier auprès de Event Hub.

properties.mappingRuleName
  • string

Règle de mappage à utiliser pour la réception des données. Éventuellement, les informations de mappage peuvent être ajoutées à chaque message.

properties.provisioningState

État approvisionné de la ressource.

properties.tableName
  • string

Table dans laquelle les données doivent être ingérées. Éventuellement, les informations de table peuvent être ajoutées à chaque message.

type
  • string

Type de la ressource. Par exemple, « Microsoft. Compute/virtualMachines » ou « Microsoft. Storage/storageAccounts »

eventHubDataFormat

Format de données du message. Éventuellement, le format de données peut être ajouté à chaque message.

Name Type Description
APACHEAVRO
  • string
AVRO
  • string
CSV
  • string
JSON
  • string
MULTIJSON
  • string
ORC
  • string
PARQUET
  • string
PSV
  • string
RAW
  • string
SCSV
  • string
SINGLEJSON
  • string
SOHSV
  • string
TSV
  • string
TSVE
  • string
TXT
  • string
W3CLOGFILE
  • string

IotHubDataConnection

Classe représentant une connexion de données IOT Hub.

Name Type Description
id
  • string

ID de ressource complet pour la ressource. Ex-/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind string:
  • IotHub

Type de point de terminaison de la connexion de données

location
  • string

Emplacement de la ressource.

name
  • string

nom de la ressource.

properties.consumerGroup
  • string

Groupe de consommateurs IOT Hub.

properties.dataFormat

Format de données du message. Éventuellement, le format de données peut être ajouté à chaque message.

properties.eventSystemProperties
  • string[]

Propriétés système de l’IOT Hub

properties.iotHubResourceId
  • string

ID de ressource de l’IOT Hub à utiliser pour créer une connexion de données.

properties.mappingRuleName
  • string

Règle de mappage à utiliser pour la réception des données. Éventuellement, les informations de mappage peuvent être ajoutées à chaque message.

properties.provisioningState

État approvisionné de la ressource.

properties.sharedAccessPolicyName
  • string

Nom de la stratégie d’accès au partage

properties.tableName
  • string

Table dans laquelle les données doivent être ingérées. Éventuellement, les informations de table peuvent être ajoutées à chaque message.

type
  • string

Type de la ressource. Par exemple, « Microsoft. Compute/virtualMachines » ou « Microsoft. Storage/storageAccounts »

iotHubDataFormat

Format de données du message. Éventuellement, le format de données peut être ajouté à chaque message.

Name Type Description
APACHEAVRO
  • string
AVRO
  • string
CSV
  • string
JSON
  • string
MULTIJSON
  • string
ORC
  • string
PARQUET
  • string
PSV
  • string
RAW
  • string
SCSV
  • string
SINGLEJSON
  • string
SOHSV
  • string
TSV
  • string
TSVE
  • string
TXT
  • string
W3CLOGFILE
  • string

ProvisioningState

État approvisionné de la ressource.

Name Type Description
Creating
  • string
Deleting
  • string
Failed
  • string
Moving
  • string
Running
  • string
Succeeded
  • string