Microsoft Web IQ implementeren met de Azure CLI

Met de onderstaande stappen meldt u zich aan bij Azure, registreert u de Web IQ-resourceprovider, maakt u het account, haalt u de resource-id op en controleert u de factureringskosten. Voer alle opdrachten uit in PowerShell, omdat de aanvraagbody’s zijn gebouwd als PowerShell-objecten en worden geconverteerd naar JSON. Voordat u ze uitvoert, vervangt u de tijdelijke aanduidingen voor de abonnements-id, resourcegroep en accountnaam door uw eigen waarden.

Zie Microsoft Web IQ implementeren met de Azure-portal als u in plaats daarvan Web IQ vanuit uw browser wilt implementeren.

Prerequisites

  • Een Azure-abonnement waarin u resources kunt maken. Web IQ vereist een betaald Azure-abonnement. Azure tegoed werkt niet voor Web IQ.
  • De Azure CLI en PowerShell.

Een Web IQ-account maken

Met deze stap meldt u zich aan bij Azure, selecteert u het abonnement waarin het account wordt gemaakt en registreert u de Microsoft. WebIQ-resourceprovider. Als u de provider registreert, is het resourcetype Web IQ beschikbaar in uw abonnement en hoeft dit slechts eenmaal per abonnement te worden gedaan. De registratieopdracht wacht totdat de provider volledig is geregistreerd voordat deze wordt voltooid.

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

Het account wordt vervolgens gemaakt op basis van een definitie die is gebouwd als een PowerShell-object en wordt geconverteerd naar JSON. De opdracht geeft deze JSON door als de volledige resourcedefinitie. In dit voorbeeld gebruikt het account de globale locatie, het soort WebIQ.Grounding en de G3-SKU, waarbij statisticsEnabled is ingesteld op false. De API-versie identificeert de Microsoft.WebIQ-revisie die wordt gebruikt voor de implementatie, dus gebruik dezelfde waarde in de latere opdrachten.

$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

Haal de resource-id op

Nadat het account is gemaakt, haalt u de resource-id op. De resource-id is het unieke pad van het account in Azure en u gebruikt deze om te verwijzen naar het account in latere bewerkingen, inclusief de kostenquery in de volgende sectie. Met deze opdracht wordt het account op naam opgezoekt en wordt alleen de id-waarde geretourneerd.

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

$resourceId

Kosten voor Azure facturering controleren

Met deze stap wordt gecontroleerd hoeveel het account heeft gekost. Er wordt een datumbereik gebouwd dat de afgelopen 30 dagen omvat en vervolgens de dagelijkse kosten aanvraagt, met behulp van de meting PreTaxCost, gefilterd op de resource-id uit de vorige sectie.

De aanvraag wordt verzonden naar Azure Cost Management. Omdat deze is gericht op Cost Management in plaats van op de Web IQ-provider, gebruikt deze aanroep een eigen API-versie, die verschilt van de API-versie die wordt gebruikt om het account te maken. Het kan enige tijd duren voordat kostengegevens zichtbaar zijn nadat een account voor het eerst is gemaakt, dus een nieuw account kan weinig of geen kosten voor de huidige periode tonen.

$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

Deze sectie somt veelvoorkomende fouten op die u kunt zien wanneer u het Web IQ-account maakt en hoe u deze kunt oplossen. Als een opdracht mislukt, leest u de volledige fouttekst die de Azure CLI retourneert, omdat hierin meestal de exacte oorzaak en de uit te voeren actie worden vermeld.

Web IQ is niet ingeschakeld voor uw abonnement

Web IQ moet zijn ingeschakeld voor uw Azure-abonnement voordat u de resource kunt implementeren. Als dat niet het geval is, mislukt het maken van het account met de foutmelding dat de functie niet is ingeschakeld voor het geselecteerde abonnement.

Neem contact op met uw Microsoft-account vertegenwoordiger of verkoopmanager om toegang aan te vragen. Zodra uw abonnement is ingeschakeld, voert u de opdracht voor het maken van het account opnieuw uit.

De API-versie is ongeldig

De waarde van de API-versie moet een revisie zijn die de Microsoft. WebIQ-provider ondersteunt. In deze handleiding wordt gebruikgemaakt van 2026-06-01-preview. Als u een versie doorgeeft die de provider niet ondersteunt, mislukt de opdracht en vermeldt Azure meestal de ondersteunde versies in het foutbericht. Voer de volgende opdracht uit om te zien welke versies de provider ondersteunt:

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

Gebruik een van de versies die de opdracht retourneert (2026-06-01-preview voor deze handleiding) en gebruik dezelfde waarde in elke Web IQ-opdracht, zodat de aanvraag en het antwoord overeenkomen.

Na de implementatie

Registreer u na de implementatie of meld u aan bij de Web IQ-portal, verbind uw resource-id en maak de API-sleutels. Nieuwe Web IQ-resources beginnen met een standaardfrequentielimiet van 15 query's per seconde (QPS); uw huidige limiet wordt weergegeven in de Web IQ-portal. Uw gebruik van Web IQ is onderhevig aan de gebruiksvoorwaarden voor Web IQ. Controleer deze voordat u begint.

  • Laatst bijgewerkt om