Bereitstellen von Microsoft Web IQ mit dem Azure CLI

Die folgenden Schritte melden Sie bei Azure an, registrieren den Web IQ-Ressourcenanbieter, erstellen das Konto, rufen die Ressourcen-ID ab und überprüfen die Kosten der Abrechnung. Führen Sie alle Befehle in PowerShell aus, da die Anforderungstextkörper als PowerShell-Objekte erstellt und in JSON konvertiert werden. Ersetzen Sie vor der Ausführung die Platzhalterwerte für die Abonnement-ID, die Ressourcengruppe und den Kontonamen durch Ihren eigenen.

Informationen zum Bereitstellen von Web IQ über Ihren Browser finden Sie unter Bereitstellen Microsoft Web IQ mit dem Azure-Portal.

Prerequisites

  • Ein Azure-Abonnement, in dem Sie Ressourcen erstellen können. Web IQ erfordert ein kostenpflichtiges Azure-Abonnement. Azure Gutschriften funktionieren nicht für Web IQ.
  • Die Azure CLI und PowerShell.

Erstellen eines Web IQ-Kontos

Dieser Schritt meldet Sie bei Azure an, wählt das Abonnement aus, in dem das Konto erstellt wird, und registriert den Ressourcenanbieter Microsoft.WebIQ. Die Registrierung des Anbieters macht den Web IQ-Ressourcentyp in Ihrem Abonnement verfügbar und muss nur einmal pro Abonnement erfolgen. Der Registrierungsbefehl wartet, bis der Anbieter vollständig registriert ist, bevor er zurückkehrt.

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

Das Konto wird dann aus einer Definition erstellt, die als PowerShell-Objekt erstellt und in JSON konvertiert wird. Der Befehl übergibt diesen JSON-Code als vollständige Ressourcendefinition. In diesem Beispiel verwendet das Konto den globalen Standort, die Art "WebIQ.Grounding" und die G3-SKU, wobei "statisticsEnabled" auf "false" festgelegt ist. Die API-Version identifiziert die Microsoft. WebIQ-Revision, die für die Bereitstellung verwendet wird. Verwenden Sie also denselben Wert in den späteren Befehlen.

$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

Abrufen der Ressourcen-ID

Rufen Sie nach dem Erstellen des Kontos die Ressourcen-ID ab. Die Ressourcen-ID ist der eindeutige Pfad des Kontos in Azure, und Sie verwenden sie, um auf das Konto in späteren Vorgängen zu verweisen, einschließlich der Kostenabfrage im nächsten Abschnitt. Dieser Befehl sucht das Konto anhand des Namens und gibt nur seinen ID-Wert zurück.

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

$resourceId

Azure-Abrechnungskosten überprüfen

In diesem Schritt wird überprüft, wie viel das Konto gekostet hat. Es erstellt einen Datumsbereich, der die letzten 30 Tage abdeckt und dann die täglichen Kosten mithilfe des PreTaxCost-Measures anfordert, gefiltert nach der Ressourcen-ID aus dem vorherigen Abschnitt.

Die Anforderung wird an Azure Cost Management gesendet. Da es auf Cost Management anstatt auf den Web IQ-Anbieter ausgerichtet ist, verwendet dieser Aufruf eine eigene API-Version, die sich von der zum Erstellen des Kontos unterscheidet. Es kann einige Zeit dauern, bis Kostendaten angezeigt werden, nachdem ein Konto erstmals erstellt wurde, sodass ein neues Konto für den aktuellen Zeitraum möglicherweise nur geringe oder keine Kosten anzeigt.

$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

In diesem Abschnitt werden häufig auftretende Fehler aufgelistet, die beim Erstellen des Web IQ-Kontos auftreten und wie Sie diese beheben können. Wenn ein Befehl fehlschlägt, lesen Sie den vollständigen Fehlertext, den der Azure CLI zurückgibt, da er in der Regel die genaue Ursache und die auszuführende Aktion benennt.

Web IQ ist für Ihr Abonnement nicht aktiviert

Web IQ muss für Ihr Azure-Abonnement aktiviert sein, bevor Sie die Ressource bereitstellen können. Wenn dies nicht der Fall ist, schlägt die Kontoerstellung mit einem Fehler fehl, der besagt, dass das Feature nicht für das ausgewählte Abonnement aktiviert ist.

Wenden Sie sich an Ihren Microsoft-Konto Vertreter oder Vertriebsleiter, um den Zugriff anzufordern. Nachdem Ihr Abonnement aktiviert ist, führen Sie den Befehl zum Erstellen des Kontos erneut aus.

Die API-Version ist ungültig.

Der Wert der API-Version muss eine Revision sein, die der Microsoft.WebIQ-Provider unterstützt. In diesem Handbuch wird 2026-06-01-preview verwendet. Wenn Sie eine Version übergeben, die der Anbieter nicht unterstützt, schlägt der Befehl fehl, und Azure listet in der Regel die unterstützten Versionen in der Fehlermeldung auf. Um zu sehen, welche Versionen der Anbieter unterstützt, führen Sie Folgendes aus:

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

Verwenden Sie eine der Versionen, die der Befehl zurückgibt (2026-06-01-Preview für dieses Handbuch), und verwenden Sie denselben Wert in jedem Web IQ-Befehl, damit die Anforderung und die Antwort übereinstimmen.

Nach der Bereitstellung

Melden Sie sich nach der Bereitstellung beim Web IQ-Portal an, verbinden Sie Ihre Ressourcen-ID, und erstellen Sie die API-Schlüssel. Neue Web IQ-Ressourcen haben standardmäßig ein Ratenlimit von 15 Abfragen pro Sekunde (QPS); Ihr aktueller Grenzwert wird im Web IQ-Portal angezeigt. Ihre Nutzung von Web IQ unterliegt den Web IQ Nutzungsbedingungen. Bitte überprüfen Sie sie, bevor Sie beginnen.

  • Zuletzt aktualisiert um