Distribuisci Microsoft Web IQ con interfaccia della riga di comando di Azure

La procedura seguente consente di accedere a Azure, registrare il provider di risorse IQ Web, creare l'account, recuperare l'ID risorsa e controllarne il costo di fatturazione. Eseguire tutti i comandi in PowerShell, perché i corpi delle richieste vengono compilati come oggetti di PowerShell e convertiti in JSON. Prima di eseguirli, sostituire i valori segnaposto per l'ID sottoscrizione, il gruppo di risorse e il nome dell'account con il proprio.

Per distribuire invece Web IQ dal browser, vedere Distribuire Microsoft Web IQ con il portale di Azure.

Prerequisites

  • Una sottoscrizione Azure in cui è possibile creare risorse. L'IQ Web richiede un abbonamento Azure a pagamento. I crediti Azure non funzionano per Web IQ.
  • interfaccia della riga di comando di Azure e PowerShell.

Crea un account Web IQ

Questo passaggio consente di accedere a Azure, selezionare la sottoscrizione in cui verrà creato l'account e registrare il provider di risorse Microsoft.WebIQ. La registrazione del provider rende disponibile il tipo di risorsa IQ Web nella sottoscrizione e deve essere effettuata solo una volta per sottoscrizione. Il comando di registrazione attende fino a quando il provider non viene registrato completamente prima di terminare.

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

L'account viene quindi creato da una definizione creata come oggetto PowerShell e convertita in JSON. Il comando passa questo codice JSON come definizione completa della risorsa. In questo esempio l'account usa la posizione globale, il tipo WebIQ.Grounding e lo SKU G3, con statisticsEnabled impostato su false. La versione dell'API identifica la revisione Microsoft.WebIQ usata per la distribuzione, quindi usare lo stesso valore nei comandi successivi.

$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

Ottieni l'ID della risorsa

Dopo aver creato l'account, recuperarne l'ID risorsa. L'ID risorsa è il percorso univoco dell'account in Azure e lo si usa per fare riferimento all'account nelle operazioni successive, inclusa la query sui costi nella sezione successiva. Questo comando cerca l'account in base al nome e restituisce solo il relativo valore ID.

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

$resourceId

Controllare il costo di fatturazione di Azure

Questo passaggio controlla il costo dell'account. Compila un intervallo di date che copre gli ultimi 30 giorni e quindi richiede il costo giornaliero, usando la misura PreTaxCost, filtrato in base all'ID risorsa della sezione precedente.

La richiesta viene inviata a Gestione costi di Azure. Poiché è destinato a Gestione costi anziché al provider di IQ Web, questa chiamata usa la propria versione API, diversa da quella usata per creare l'account. I dati sui costi possono richiedere del tempo a comparire dopo la prima creazione di un account, quindi un nuovo account può mostrare un costo minimo o nullo per il periodo corrente.

$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

Questa sezione elenca gli errori comuni che possono verificarsi quando si crea l'account IQ Web e come risolverli. Se un comando ha esito negativo, leggere il testo completo dell'errore restituito da interfaccia della riga di comando di Azure, perché in genere indica la causa esatta e l'azione da eseguire.

Web IQ non è abilitato per il tuo abbonamento

Prima di poter distribuire la risorsa, è necessario abilitare Web IQ per la sottoscrizione Azure. In caso contrario, la creazione dell'account ha esito negativo e viene visualizzato un errore che indica che la funzionalità non è abilitata per la sottoscrizione selezionata.

Per risolverlo, contattare il referente dell'account Microsoft o il responsabile vendite per richiedere l'accesso. Dopo aver abilitato la sottoscrizione, eseguire di nuovo il comando di creazione dell'account.

La versione dell'API non è valida

Il valore api-version deve essere una revisione supportata dal provider Microsoft.WebIQ. Questa guida usa 2026-06-01-preview. Se si passa una versione non supportata dal provider, il comando ha esito negativo e Azure in genere elenca le versioni supportate nel messaggio di errore. Per visualizzare le versioni supportate dal provider, eseguire:

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

Usare una delle versioni restituite dal comando (2026-06-01-preview per questa guida) e usare lo stesso valore in ogni comando IQ Web in modo che la richiesta e la risposta corrispondano.

Dopo la distribuzione

Dopo la distribuzione, iscriversi o accedere al portale Web IQ, connettere l'ID risorsa e creare le chiavi API. Le nuove risorse di Web IQ iniziano con un limite di frequenza predefinito di 15 query al secondo (QPS); il limite corrente viene visualizzato nel portale Web IQ. L'uso di Web IQ è soggetto alle Condizioni per l'utilizzo di Web IQ. Esaminali prima di iniziare.

  • Ultimo aggiornamento: