Driftsätt Microsoft Web IQ med Azure CLI

Med stegen nedan loggar du in på Azure, registrerar Web IQ-resursprovidern, skapar kontot, hämtar dess resurs-ID och kontrollerar faktureringskostnaden. Kör alla kommandon i PowerShell, eftersom request bodies skapas som PowerShell-objekt och konverteras till JSON. Innan du kör dem ersätter du platshållarvärdena för prenumerations-ID, resursgrupp och kontonamn med ditt eget.

Om du vill distribuera Web IQ från webbläsaren i stället kan du läsa Distribuera Microsoft Web IQ med Azure-portalen.

Prerequisites

  • En Azure-prenumeration där du kan skapa resurser. Webb-IQ kräver en betald Azure prenumeration. Azure krediter fungerar inte för Web IQ.
  • Azure CLI och PowerShell.

Skapa ett Web IQ-konto

Det här steget loggar in dig på Azure, väljer den prenumeration där kontot ska skapas och registrerar Microsoft.WebIQ-resursprovider. Genom att registrera leverantören blir Web IQ-resurstypen tillgänglig i din prenumeration och behöver bara göras en gång per prenumeration. Registreringskommandot väntar tills providern är helt registrerad innan det returnerar.

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

Kontot skapas sedan från en definition som byggs upp som ett PowerShell-objekt och konverteras till JSON. Kommandot skickar denna JSON som den fullständiga resursdefinitionen. I det här exemplet använder kontot den globala platsen, typen WebIQ.Grounding och G3 SKU, med statisticsEnabled inställt på false. API-versionen identifierar den Microsoft.WebIQ-revision som används för driftsättningen, så använd samma värde i de senare kommandona.

$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

Hämta resurs-ID:t

När kontot har skapats hämtar du dess resurs-ID. Resurs-ID:t är kontots unika sökväg i Azure och du använder det för att referera till kontot i senare åtgärder, inklusive kostnadsfråga i nästa avsnitt. Det här kommandot söker upp kontot efter namn och returnerar endast dess ID-värde.

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

$resourceId

Kontrollera kostnaden för Azure-fakturering

Det här steget kontrollerar hur mycket kontot har kostat. Den skapar ett datumintervall som täcker de senaste 30 dagarna och begär sedan den dagliga kostnaden, med hjälp av måttet PreTaxCost, filtrerat till resurs-ID:t från föregående avsnitt.

Begäran skickas till Azure Cost Management. Eftersom det är avsett för Cost Management i stället för webb-IQ-providern använder det här anropet sin egen API-version, som skiljer sig från den som används för att skapa kontot. Det kan ta lite tid innan kostnadsdata visas när ett konto först har skapats, så ett nytt konto kan visa liten eller ingen kostnad för den aktuella perioden.

$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

I det här avsnittet visas vanliga fel som du kan se när du skapar Web IQ-kontot och hur du löser dem. Om ett kommando misslyckas läser du den fullständiga feltexten som Azure CLI returnerar, eftersom den vanligtvis namnger den exakta orsaken och den åtgärd som ska vidtas.

Web IQ är inte aktiverat för din prenumeration

Web IQ måste vara aktiverat för din Azure-prenumeration innan du kan distribuera resursen. Om det inte är det misslyckas kontoskapandet med ett fel som anger att funktionen inte är aktiverad för den valda prenumerationen.

Lös problemet genom att kontakta din Microsoft-konto representant eller säljchef för att begära åtkomst. När prenumerationen är aktiverad kör du kommandot skapa konto igen.

API-versionen är ogiltig

Api-versionsvärdet måste vara en revision som Microsoft.WebIQ-providern stöder. Den här guiden använder 2026-06-01-preview. Om du skickar en version som providern inte stöder misslyckas kommandot och Azure visar vanligtvis de versioner som stöds i felmeddelandet. Om du vill se vilka versioner som providern stöder kör du:

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

Använd en av versionerna som kommandot returnerar (2026-06-01-preview för den här guiden) och använd samma värde i varje Web IQ-kommando så att begäran och svaret matchar.

Efter distributionen

Efter distributionen registrerar du dig eller loggar in på Web IQ portal, ansluter ditt resurs-ID och skapar API-nycklarna. Nya webb-IQ-resurser börjar med en standardfrekvensgräns på 15 frågor per sekund (QPS); den aktuella gränsen visas i webb-IQ-portalen. Din användning av Web IQ omfattas av Web IQ Terms of Use. Granska dem innan du börjar.

  • Uppdaterades senast