Créer des ressources Azure Time Series Insights Gen1 à l’aide de modèles Resource Manager
Remarque
Le service Time Series Insights va être mis hors service le 7 juillet 2024. Prévoyez de migrer les environnements existants vers des solutions alternatives dès que possible. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation.
Attention
Il s’agit d’un article Gen1.
Cet article explique comment créer et déployer des ressources Azure Time Series Insights à l’aide de modèles Resource Manager, de 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, stockés et rendus interrogeables. Pour plus d’informations, consultez Planifier votre environnement Azure Time Series Insights |
Source de l'é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. Sont actuellement pris en charge 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 de l’environnement. Les métadonnées des jeux de données de référence seront jointes à des événements au cours de l’entrée. Les jeux de données de référence sont définis comme des ressources par leurs propriétés de clé d’événement. Les métadonnées 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 l’autorisation de générer des requêtes de données, de manipuler les données de référence dans l’environnement et de 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 de ressources dans un groupe de ressources. Les documents suivants décrivent plus en détail les fichiers modèles :
- Déploiement du modèle Azure Resource Manager
- Déployer des ressources à l’aide de modèles Resource Manager et d’Azure PowerShell
- Types de ressource Microsoft.TimeSeriesInsights
Le modèle de démarrage rapide timeseriesinsights-environment-with-eventhub est publié sur GitHub. Il 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 qui accordent l’accès aux données de l’environnement. Si aucun hub d’événements existant n’est spécifié, il en sera créé un avec le déploiement.
Remarque
Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour bien démarrer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.
Spécifier le modèle et les paramètres de déploiement
La procédure suivante explique comment utiliser PowerShell pour déployer un modèle 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 qui accordent l’accès aux données de l’environnement. Si aucun hub d’événements existant n’est spécifié, il en sera créé un avec le déploiement.
Installez Azure PowerShell en suivant les instructions disponibles dans Prise en main d’Azure PowerShell.
Clonez ou copiez le modèle timeseriesinsights-environment-with-eventhub sur 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 obligatoires
Paramètre Description eventHubNamespaceName Espace de noms du hub de la source de l’événement. eventHubName Nom du hub de la source de l’événement. consumerGroupName Nom du groupe de consommateurs que le service Azure Time Series Insights utilisera pour lire les données à partir de l’Event Hub. REMARQUE : pour éviter la contention de ressources, ce groupe de consommateurs doit être dédié au service Azure Time Series Insights et ne doit pas être partagé avec d’autres lecteurs. environmentName Nom de l’environnement. Le nom ne peut pas contenir : <
,>
,%
,&
,:
,\\
,?
,/
, ni aucun caractère de contrôle. Tous les autres caractères sont autorisés.eventSourceName Nom de la ressource enfant de la source de l’événement. Le nom ne peut pas contenir : <
,>
,%
,&
,:
,\\
,?
,/
, ni aucun caractère 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 par le biais de la source de l’événement. REMARQUE : L’utilisateur qui déploie le modèle doit avoir des privilèges pour réaliser l’opération listkeys sur le hub d’événements. Si aucune valeur n’est transmise, un nouveau hub d’événements sera créé par le modèle. environmentDisplayName Nom convivial facultatif à afficher dans les outils et les interfaces utilisateur à la place du nom de l’environnement. environmentSkuName Nom du la référence SKU. Pour plus d’informations, consultez la page Tarification d’Azure Time Series Insights. environmentSkuCapacity Capacité unitaire de la référence SKU. Pour plus d’informations, consultez la page Tarification d’Azure Time Series Insights. environmentDataRetentionTime Période minimale durant laquelle les événements de l’environnement seront interrogeables. 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 et les interfaces utilisateur à la place du nom de la source de l’événement. eventSourceTimestampPropertyName Propriété de l’événement qui sera utilisée comme horodateur de la source de l’événement. Si aucune valeur n’est spécifiée pour timestampPropertyName, ou si la valeur Null ou une chaîne vide est spécifiée, l’heure de création de l’événement sera utilisée. eventSourceKeyName Nom de la clé d’accès partagé que le service Azure Time Series Insights utilisera pour se connecter à l’Event Hub. accessPolicyReaderObjectIds Une liste des ID objet des utilisateurs et des applications dans Microsoft Entra ID qui doivent avoir l’accès Lecteur à l’environnement. L’ID objet du principal du service s’obtient en appelant la cmdlet Get-AzADUser ou la cmdlet Get-AzADServicePrincipal. La création d’une stratégie d’accès n’est pas encore prise en charge pour les groupes Microsoft Entra. accessPolicyContributorObjectIds Une liste des ID objet des utilisateurs et des applications dans Microsoft Entra ID qui doivent avoir l’accès Contributeur à l’environnement. L’ID objet du principal du service s’obtient en appelant la cmdlet Get-AzADUser ou la cmdlet Get-AzADServicePrincipal. La création d’une stratégie d’accès n’est pas encore prise en charge pour les groupes Microsoft Entra. Par exemple, le fichier de paramètres suivant serait utilisé pour créer un environnement et une source d’événement qui lirait les événements à partir d’un hub d’événements existant. Il crée également deux stratégies qui accordent l’accès Collaborateur à 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 avec 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 de commandes PowerShell, exécutez la commande suivante :
Connect-AzAccount
Vous êtes invité à ouvrir une session sur votre compte Azure. Une fois connecté, exécutez la commande suivante pour afficher vos abonnements disponibles :
Get-AzSubscription
Cette commande renvoie la liste des abonnements Azure disponibles. Choisissez un abonnement pour la session en cours 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'en existe pas.
Si vous n’avez pas de groupe de ressources, créez-en un avec la commande New-AzResourceGroup. Indiquez le nom du groupe de ressources et 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
. Lorsque vous testez le déploiement, indiquez les 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 déploiement, exécutez l’applet de commande
New-AzResourceGroupDeployment
et indiquez les paramètres nécessaires quand vous y êtes invité. Les paramètres incluent un nom pour votre déploiement, le nom de votre groupe de ressources, 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 Incremental est utilisée. Pour plus d’informations, consultez Déploiements incrémentiels et 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 inclus 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, affectez la valeur Complet au paramètre Mode :
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 sur le Portail Azure
- La page d’accueil du modèle de démarrage rapide sur GitHub comporte également un bouton Déployer sur Azure. Il ouvre une page Déploiement personnalisé sur le Portail Azure. Sur cette page, vous pouvez entrer ou sélectionner des valeurs pour chacun des paramètres des tables Paramètres requis et Paramètres facultatifs. Après avoir rempli les paramètres, cliquez sur le bouton Acheter pour lancer le déploiement du modèle.
Étapes suivantes
- Pour plus d’informations sur la gestion programmatique des ressources Azure Time Series Insights à l’aide des API REST, consultez Gestion d’Azure Time Series Insights.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour