Déployer Microsoft Web IQ avec le Azure CLI

Les étapes ci-dessous vous permettent de vous connecter à Azure, d’enregistrer le fournisseur de ressources Web IQ, de créer le compte, de récupérer son ID de ressource et de vérifier son coût de facturation. Exécutez toutes les commandes dans PowerShell, car les corps de requête sont générés en tant qu’objets PowerShell et convertis en JSON. Avant de les exécuter, remplacez les valeurs de substitution pour l’ID d’abonnement, le groupe de ressources et le nom de compte par les vôtres.

Pour déployer Web IQ à partir de votre navigateur, consultez Déployer Microsoft Web IQ avec le portail Azure.

Prerequisites

  • Un abonnement Azure dans lequel vous pouvez créer des ressources. Web IQ nécessite un abonnement Azure payant. Les crédits Azure ne fonctionnent pas pour Web IQ.
  • L’Azure CLI et PowerShell.

Créer un compte WEB IQ

Cette étape vous connecte à Azure, sélectionne l’abonnement dans lequel le compte sera créé et inscrit le fournisseur de ressources Microsoft.WebIQ. L’enregistrement du fournisseur rend le type de ressource Web IQ disponible dans votre abonnement et doit être effectuée une seule fois par abonnement. La commande d’enregistrement attend que le fournisseur soit entièrement enregistré avant de se terminer.

az login

$subscriptionId = "<subscription-id>"
$resourceGroup = "<resource-group>"
$accountName = "<globally-unique-account-name>"
$apiVersion = "2026-06-01-preview"

az account set --subscription $subscriptionId
az provider register --namespace Microsoft.WebIQ --wait

Le compte est ensuite créé à partir d’une définition générée en tant qu’objet PowerShell et convertie en JSON. La commande transmet ce JSON comme définition de ressource complète. Dans cet exemple, le compte utilise l’emplacement global, le type WebIQ.Grounding et la référence SKU G3, avec statisticsEnabled défini sur false. La version de l’API identifie la révision Microsoft.WebIQ utilisée pour le déploiement, utilisez donc la même valeur dans les commandes ultérieures.

$account = @{
  location = "global"
  kind = "WebIQ.Grounding"
  sku = @{
    name = "G3"
  }
  properties = @{
    statisticsEnabled = $false
  }
} | ConvertTo-Json -Depth 10 -Compress

az resource create `
  --resource-group $resourceGroup `
  --name $accountName `
  --resource-type "Microsoft.WebIQ/accounts" `
  --api-version $apiVersion `
  --is-full-object `
  --properties $account

Obtenir l’ID de ressource

Une fois le compte créé, récupérez son ID de ressource. L'ID de ressource est le chemin unique du compte dans Azure, et vous l'utilisez pour référencer le compte dans les opérations ultérieures, y compris la requête de coût dans la section suivante. Cette commande recherche le compte par nom et retourne uniquement sa valeur d’ID.

$resourceId = az resource show `
  --resource-group $resourceGroup `
  --name $accountName `
  --resource-type "Microsoft.WebIQ/accounts" `
  --api-version $apiVersion `
  --query id `
  --output tsv

$resourceId

Vérifier le coût de facturation Azure

Cette étape vérifie combien le compte a coûté. Il génère une plage de dates qui couvre les 30 derniers jours, puis demande le coût quotidien, à l’aide de la mesure PreTaxCost, filtrée sur l’ID de ressource de la section précédente.

La demande est envoyée à Gestion des coûts Azure. Étant donné qu’il cible Cost Management plutôt que le fournisseur Web IQ, cet appel utilise sa propre version d’API, différente de celle utilisée pour créer le compte. Les données de coût peuvent prendre un certain temps à apparaître après la création d’un compte. Par conséquent, un nouveau compte peut afficher peu ou pas de coût pour la période actuelle.

$from = (Get-Date).AddDays(-30).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
$to = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")

$query = @{
  type = "ActualCost"
  timeframe = "Custom"
  timePeriod = @{
    from = $from
    to = $to
  }
  dataset = @{
    granularity = "Daily"
    aggregation = @{
      totalCost = @{
        name = "PreTaxCost"
        function = "Sum"
      }
    }
    filter = @{
      dimensions = @{
        name = "ResourceId"
        operator = "In"
        values = @($resourceId)
      }
    }
  }
} | ConvertTo-Json -Depth 10 -Compress

az rest `
  --method post `
  --url "https://management.azure.com/subscriptions/${subscriptionId}/providers/Microsoft.CostManagement/query?api-version=2025-03-01" `
  --body $query `
  --output json

Troubleshooting

Cette section répertorie les erreurs courantes que vous pouvez voir lorsque vous créez le compte Web IQ et comment les résoudre. Si une commande échoue, lisez le texte d’erreur complet retourné par le Azure CLI, car il nomme généralement la cause exacte et l’action à entreprendre.

Web IQ n’est pas activé pour votre abonnement

Web IQ doit être activé pour votre abonnement Azure avant de pouvoir déployer la ressource. Si ce n’est pas le cas, la création de compte échoue avec une erreur indiquant que la fonctionnalité n’est pas activée pour l’abonnement sélectionné.

Pour résoudre ce problème, contactez votre représentant de compte Microsoft ou votre directeur commercial pour demander l’accès. Une fois votre abonnement activé, réexécutez la commande de création de compte.

La version de l’API n’est pas valide

La valeur api-version doit être une révision prise en charge par le fournisseur Microsoft.WebIQ. Ce guide utilise 2026-06-01-preview. Si vous passez une version que le fournisseur ne prend pas en charge, la commande échoue et Azure répertorie généralement les versions prises en charge dans le message d’erreur. Pour voir quelles versions le fournisseur prend en charge, exécutez :

az provider show --namespace Microsoft.WebIQ --query "resourceTypes[?resourceType=='accounts'].apiVersions" --output tsv

Utilisez l’une des versions retournées par la commande (2026-06-01-preview pour ce guide) et utilisez la même valeur dans chaque commande Web IQ afin que la demande et la réponse correspondent.

Après le déploiement

Après le déploiement, inscrivez-vous ou connectez-vous au portail Web IQ, connectez votre ID de ressource et créez les clés API. Les nouvelles ressources Web IQ commencent par une limite de débit par défaut de 15 requêtes par seconde (QPS) ; votre limite actuelle s’affiche dans le portail Web IQ. Votre utilisation de Web IQ est soumise aux conditions d’utilisation de Web IQ. Veuillez les consulter avant de commencer.

  • Dernière mise à jour :