Créer des ressources Azure Time Series Insights Gen 1 à l’aide de modèles Azure Resource Manager

Article
09/30/2020

Note

Le service Time Series Insights sera mis hors service le 7 juillet 2024. Envisagez de migrer des environnements existants vers d’autres solutions dès que possible. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation .

Prudence

C'est un article de génération 1.

Cet article explique comment créer et déployer des ressources Azure Time Series Insights à l’aide de modèles Azure Resource Manager, PowerShell et du fournisseur de ressources Azure Time Series Insights.

Azure Time Series Insights prend en charge les ressources suivantes :

Ressource	Description
Environnement	Un environnement Azure Time Series Insights est un regroupement logique d’événements lus à partir de répartiteurs d’événements, stockés et mis à disposition pour la requête. Pour plus d’informations, consultez Planifier votre environnement Azure Time Series Insights
Source d’événement	Une source d’événement est une connexion à un répartiteur d’événements à partir duquel Azure Time Series Insights lit et ingère des événements dans l’environnement. Actuellement, les sources d’événements prises en charge sont IoT Hub et Event Hub.
Jeu de données de référence	Les jeux de données de référence fournissent des métadonnées sur les événements dans l’environnement. Les métadonnées des jeux de données de référence sont jointes à des événements lors de l'ingression. Les jeux de données de référence sont définis en tant que ressources par leurs propriétés de clé d’événement. Les métadonnées réelles qui composent le jeu de données de référence sont chargées ou modifiées par le biais d’API de plan de données.
Stratégie d’accès	Les stratégies d’accès accordent des autorisations pour émettre des requêtes de données, manipuler des données de référence dans l’environnement et partager des requêtes enregistrées et des perspectives associées à l’environnement. Pour plus d’informations, consultez Accorder l’accès aux données à un environnement Azure Time Series Insights à l’aide du portail Azure

Un modèle Resource Manager est un fichier JSON qui définit l’infrastructure et la configuration des ressources dans un groupe de ressources. Les documents suivants décrivent plus en détail les fichiers de modèle :

Le modèle de démarrage rapide timeseriesinsights-environment-with-eventhub est publié sur GitHub. Ce modèle crée un environnement Azure Time Series Insights, une source d’événement enfant configurée pour consommer des événements à partir d’un Event Hub et des stratégies d’accès qui accordent l’accès aux données de l’environnement. Si aucun Event Hub existant n’est spécifié, un hub d’événements est créé avec le déploiement.

Note

Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour commencer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell d’AzureRM vers Az.

Spécifier le modèle de déploiement et les paramètres

La procédure suivante explique comment utiliser PowerShell pour déployer un modèle Azure Resource Manager qui crée un environnement Azure Time Series Insights, une source d’événement enfant configurée pour consommer des événements à partir d’un Event Hub et des stratégies d’accès qui accordent l’accès aux données de l’environnement. Si aucun Event Hub existant n’est spécifié, un hub d’événements est créé avec le déploiement.

Installez Azure PowerShell en suivant les instructions de Prise en main d’Azure PowerShell.

Clonez ou copiez le modèle timeseriesinsights-environment-with-eventhub à partir de GitHub.

Créer un fichier de paramètres

Pour créer un fichier de paramètres, copiez le fichier timeseriesinsights-environment-with-eventhub.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
      "eventHubNamespaceName": {
          "value": "GEN-UNIQUE"
      },
      "eventHubName": {
          "value": "GEN-UNIQUE"
      },
      "consumerGroupName": {
          "value": "GEN-UNIQUE"
      },
      "environmentName": {
        "value": "GEN-UNIQUE"
      },
      "eventSourceName": {
        "value": "GEN-UNIQUE"
      }
  }
}

Paramètres requis

Paramètre	Description
eventHubNamespaceName	Espace de noms du hub d’événements source.
eventHubName	Nom du hub d’événements source.
NomDuGroupeDeConsommateurs	Nom du groupe de consommateurs utilisé par le service Azure Time Series Insights pour lire les données à partir du hub d’événements. REMARQUE : Pour éviter la contention des ressources, ce groupe de consommateurs doit être dédié au service Azure Time Series Insights et non partagé avec d’autres lecteurs.
NomEnvironnement	Nom de l’environnement. Le nom ne peut pas inclure : `<`, `>`, `%`, `&`, `:`, `\\`, `?`, `/`et tous les caractères de contrôle. Tous les autres caractères sont autorisés.
nomDeSourceÉvénement	Nom de la ressource enfant source d’événement. Le nom ne peut pas inclure : `<`, `>`, `%`, `&`, `:`, `\\`, `?`, `/`et tous les caractères de contrôle. Tous les autres caractères sont autorisés.

Paramètres facultatifs

Paramètre	Description
existingEventHubResourceId	ID de ressource facultatif d’un Event Hub existant qui sera connecté à l’environnement Azure Time Series Insights via la source d’événement. REMARQUE : l’utilisateur qui déploie le modèle doit disposer de privilèges pour effectuer l’opération listkeys sur event Hub. Si aucune valeur n’est passée, un nouveau hub d’événements est créé par le modèle.
nomAffichageEnvironnement	Nom convivial facultatif à afficher dans les outils ou les interfaces utilisateur au lieu du nom de l’environnement.
environmentSkuName	Nom de la référence SKU. Pour plus d’informations, consultez la page de tarification Azure Time Series Insights.
environmentSkuCapacity	Capacité d’unité de la référence SKU. Pour plus d’informations, consultez la page de tarification Azure Time Series Insights .
duréeDeRétentionDesDonnéesEnvironnementales	L’intervalle de temps minimal des événements de l’environnement sera disponible pour la requête. La valeur doit être spécifiée au format ISO 8601, par exemple `P30D` pour une stratégie de rétention de 30 jours.
eventSourceDisplayName	Nom convivial facultatif à afficher dans les outils ou les interfaces utilisateur au lieu du nom de la source d’événement.
NomPropriétéHorodatageSourceÉvénement	Propriété d’événement qui sera utilisée comme horodatage de la source d’événement. Si une valeur n’est pas spécifiée pour timestampPropertyName ou si la valeur null ou la chaîne vide est spécifiée, l’heure de création d’événement est utilisée.
NomDeLaCléDeSourceD'Événement	Nom de la clé d’accès partagé que le service Azure Time Series Insights utilisera pour se connecter au hub d’événements.
accessPolicyReaderObjectIds	Liste des ID d'objet des utilisateurs ou des applications dans Microsoft Entra ID ayant accès en lecture à l'environnement. Vous pouvez obtenir l’objectId du principal de service en appelant les applets de commande Get-AzADUser ou Get-AzADServicePrincipal. La création d’une stratégie d’accès pour les groupes Microsoft Entra n’est pas encore prise en charge.
IdentifiantsObjetContributeurDePolitiqueD'accès	Liste des ID d’objet des utilisateurs ou des applications dans Microsoft Entra ID qui doivent avoir un accès Contributeur à l’environnement. Vous pouvez obtenir l’objectId du principal de service en appelant les applets de commande Get-AzADUser ou Get-AzADServicePrincipal . La création d’une stratégie d’accès pour les groupes Microsoft Entra n’est pas encore prise en charge.

Par exemple, le fichier de paramètres suivant est utilisé pour créer un environnement et une source d’événement qui lit les événements à partir d’un event hub existant. Il crée également deux stratégies d’accès qui accordent l’accès Contributeur à l’environnement.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "eventHubNamespaceName": {
            "value": "tsiTemplateTestNamespace"
        },
        "eventHubName": {
            "value": "tsiTemplateTestEventHub"
        },
        "consumerGroupName": {
            "value": "tsiTemplateTestConsumerGroup"
        },
        "environmentName": {
            "value": "tsiTemplateTestEnvironment"
        },
        "eventSourceName": {
            "value": "tsiTemplateTestEventSource"
        },
        "existingEventHubResourceId": {
            "value": "/subscriptions/{yourSubscription}/resourceGroups/MyDemoRG/providers/Microsoft.EventHub/namespaces/tsiTemplateTestNamespace/eventhubs/tsiTemplateTestEventHub"
        },
        "accessPolicyContributorObjectIds": {
            "value": [
                "AGUID001-0000-0000-0000-000000000000",
                "AGUID002-0000-0000-0000-000000000000"
            ]
        }
    }
}

Pour plus d’informations, consultez l’article Paramètres.

Déployer le modèle de démarrage rapide localement à l’aide de PowerShell

Important

Les opérations de ligne de commande affichées ci-dessous décrivent le module Az PowerShell.

Dans PowerShell, connectez-vous à votre compte Azure.
- À partir d’une invite PowerShell, exécutez la commande suivante :
```
Connect-AzAccount
```
- Vous êtes invité à vous connecter à votre compte Azure. Après vous être connecté, exécutez la commande suivante pour afficher vos abonnements disponibles :
```
Get-AzSubscription
```
- Cette commande retourne une liste d’abonnements Azure disponibles. Choisissez un abonnement pour la session active en exécutant la commande suivante. Remplacez <YourSubscriptionId> par le GUID de l’abonnement Azure que vous souhaitez utiliser :
```
Set-AzContext -SubscriptionID <YourSubscriptionId>
```
Créez un groupe de ressources s’il n’existe pas.
- Si vous n’avez pas de groupe de ressources existant, créez un groupe de ressources avec la commande New-AzResourceGroup. Indiquez le nom du groupe de ressources et de l’emplacement que vous souhaitez utiliser. Par exemple:
```
New-AzResourceGroup -Name MyDemoRG -Location "West US"
```
- En cas de réussite, un résumé du nouveau groupe de ressources s’affiche.
```
ResourceGroupName : MyDemoRG
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/<GUID>/resourceGroups/MyDemoRG
```
Testez le déploiement.
- Validez votre déploiement en exécutant l’applet de commande Test-AzResourceGroupDeployment. Lors du test du déploiement, fournissez des paramètres exactement comme vous le feriez lors de l’exécution du déploiement.
```
Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
```
Créer le déploiement
- Pour créer le nouveau déploiement, exécutez l’applet de commande New-AzResourceGroupDeployment et fournissez les paramètres nécessaires lorsque vous y êtes invité. Les paramètres incluent un nom pour votre déploiement, le nom de votre groupe de ressources et le chemin d’accès ou l’URL du fichier de modèle. Si le paramètre mode n’est pas spécifié, la valeur par défaut de Incrémentielle est utilisée. Pour plus d’informations, lisez les sections intitulées « Déploiements incrémentiels » et « Déploiements complets ».
- La commande suivante vous invite à entrer les cinq paramètres requis dans la fenêtre PowerShell :
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```
- Pour spécifier un fichier de paramètres à la place, utilisez la commande suivante :
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
```
- Vous pouvez également utiliser des paramètres inline lorsque vous exécutez l’applet de commande de déploiement. La commande est la suivante :
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"
```
- Pour exécuter un déploiement complet, définissez le paramètre Mode sur Complet:
```
New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
```

Vérifier le déploiement

Si les ressources sont déployées avec succès, un résumé du déploiement s’affiche dans la fenêtre PowerShell :

 DeploymentName          : MyDemoDeployment
 ResourceGroupName       : MyDemoRG
 ProvisioningState       : Succeeded
 Timestamp               : 10/11/2019 3:20:37 AM
 Mode                    : Incremental
 TemplateLink            :
 Parameters              :
                           Name                                Type                       Value
                           ==================================  =========================  ==========
                           eventHubNewOrExisting               String                     new
                           eventHubResourceGroup               String                     MyDemoRG
                           eventHubNamespaceName               String                     tsiquickstartns
                           eventHubName                        String                     tsiquickstarteh
                           consumerGroupName                   String                     tsiquickstart
                           environmentName                     String                     tsiquickstart
                           environmentDisplayName              String                     tsiquickstart
                           environmentSkuName                  String                     S1
                           environmentSkuCapacity              Int                        1
                           environmentDataRetentionTime        String                     P30D
                           eventSourceName                     String                     tsiquickstart
                           eventSourceDisplayName              String                     tsiquickstart
                           eventSourceTimestampPropertyName    String
                           eventSourceKeyName                  String                     manage
                           accessPolicyReaderObjectIds         Array                      []
                           accessPolicyContributorObjectIds    Array                      []
                           location                            String                     westus

 Outputs                 :
                            Name              Type                       Value
                            ================  =========================  ==========
                            dataAccessFQDN    String
                            11aa1aa1-a1aa-1a1a-a11a-aa111a111a11.env.timeseries.azure.com

 DeploymentDebugLogLevel :

Déployer le modèle de démarrage rapide via le portail Azure
- La page d’accueil du modèle de démarrage rapide sur GitHub inclut également un bouton Déployer sur Azure. Cliquez dessus pour ouvrir une page Déploiement personnalisé dans le portail Azure. Depuis cette page, vous pouvez entrer ou sélectionner des valeurs pour chacun des paramètres des tables paramètres requis ou paramètres facultatifs. Une fois les paramètres renseignés, cliquer sur le bouton Acheter pour lancer le déploiement du modèle.

Étapes suivantes

Pour plus d’informations sur la gestion par programmation des ressources Azure Time Series Insights à l’aide d’API REST, lisez Gestion d’Azure Time Series Insights.

Partager via

Créer des ressources Azure Time Series Insights Gen 1 à l’aide de modèles Azure Resource Manager

Spécifier le modèle de déploiement et les paramètres

Déployer le modèle de démarrage rapide localement à l’aide de PowerShell

Étapes suivantes

Ressources supplémentaires