Implemente o Microsoft Web IQ com a CLI do Azure

Os passos abaixo permitem-lhe iniciar sessão no Azure, registar o fornecedor de recursos Web IQ, criar a conta, recuperar o respetivo ID de recurso e verificar o respetivo custo de faturação. Executa todos os comandos no PowerShell, porque os corpos dos pedidos são construídos como objetos PowerShell e convertidos para JSON. Antes de os executar, substitua os valores provisórios do ID da subscrição, grupo de recursos e nome da conta pelos seus próprios.

Para implementar Web IQ a partir do seu navegador, consulte Implementar Microsoft Web IQ com o portal Azure.

Pré-requisitos

  • Uma subscrição Azure onde podes criar recursos. O Web IQ exige uma subscrição paga do Azure. Créditos do Azure não funcionam para o Web IQ.
  • A CLI do Azure e o PowerShell.

Crie uma conta Web IQ

Este passo faz o seu login no Azure, seleciona a subscrição onde a conta será criada e regista o fornecedor de recursos Microsoft.WebIQ. Registar o fornecedor torna o tipo de recurso Web IQ disponível na sua subscrição e só precisa de ser feito uma vez por subscrição. O comando de registo espera até que o fornecedor esteja totalmente registado antes de regressar.

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

A conta é então criada a partir de uma definição que é construída como um objeto PowerShell e convertida para JSON. O comando passa este JSON como a definição completa do recurso. Neste exemplo, a conta usa a localização global, o tipo WebIQ.Grounding e o SKU G3, com o statisticsEnabled definido como falso. A versão da API identifica a revisão do Microsoft.WebIQ usada para a implementação, por isso use o mesmo valor nos comandos posteriores.

$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

Obtenha o ID do recurso

Depois de criada a conta, recupere o seu ID de recurso. O ID do recurso é o caminho único da conta no Azure, e usas-no para referenciar a conta em operações posteriores, incluindo a consulta de custos na secção seguinte. Este comando procura a conta pelo nome e devolve apenas o seu ID.

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

$resourceId

Verificar o custo de faturação do Azure

Este passo verifica quanto custou a utilização da conta. Constrói um intervalo de datas que cobre os últimos 30 dias e depois solicita o custo diário, usando a medida PreTaxCost, filtrado para o ID do recurso da secção anterior.

O pedido é enviado para o Gestão de Custos do Azure. Como tem como alvo a Gestão de Custos em vez do fornecedor Web IQ, esta chamada utiliza a sua própria versão da API, que é diferente daquela usada para criar a conta. Os dados de custos podem demorar algum tempo a aparecer após a criação de uma conta, pelo que uma nova conta pode mostrar pouco ou nenhum custo para o período atual.

$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

Esta secção lista erros comuns que pode encontrar ao criar a conta Web IQ e como resolvê-los. Se um comando falhar, leia o texto completo do erro que a CLI do Azure devolve, porque normalmente indica a causa exata e a ação a tomar.

O Web IQ não está ativado para a sua subscrição

O Web IQ tem de estar ativado para a sua subscrição do Azure antes de poder implementar o recurso. Se não estiver, a criação da conta falha com um erro a indicar que a funcionalidade não está ativada para a subscrição selecionada.

Para resolver, contacte o seu representante de conta Microsoft ou executivo de vendas para solicitar acesso. Assim que a tua subscrição estiver ativada, executa novamente o comando de criação de conta.

A versão da API não é válida

O valor da versão da API deve ser uma revisão que o fornecedor Microsoft.WebIQ suporta. Este guia utiliza 2026-06-01-preview. Se passar uma versão que o fornecedor não suporta, o comando falha, e o Azure normalmente lista as versões suportadas na mensagem de erro. Para ver quais as versões que o fornecedor suporta, execute:

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

Use uma das versões que o comando devolve (2026-06-01-preview para este guia) e use o mesmo valor em todos os comandos Web IQ para que o pedido e a resposta coincidam.

Após a implantação

Após a implementação, inscreva-se ou inicie sessão no portal Web IQ, associe o ID do seu recurso e crie as chaves da API. Os novos recursos Web IQ começam com um limite padrão de 15 consultas por segundo (QPS); o seu limite atual é mostrado no portal Web IQ. A sua utilização do Web IQ está sujeita aos Termos de Utilização do Web IQ. Por favor, reveja-as antes de começar.

  • Última atualização a