Implantar Microsoft Web IQ com o CLI do Azure

As etapas abaixo fazem login no Azure, registram o provedor de recursos do Web IQ, criam a conta, recuperam sua ID de recurso e verificam o custo de cobrança. Execute todos os comandos no PowerShell, pois os corpos de solicitação são criados como objetos do PowerShell e convertidos em JSON. Antes de executá-los, substitua os valores de marcador da ID da assinatura, do grupo de recursos e do nome da conta pelos seus próprios.

Em vez disso, para implantar o Web IQ a partir do seu navegador, consulte Implantar o Microsoft Web IQ com o portal do Azure.

Prerequisites

  • Uma assinatura do Azure em que você pode criar recursos. Web IQ requer uma assinatura paga do Azure. Os créditos do Azure não funcionam para o Web IQ.
  • O CLI do Azure e o PowerShell.

Criar uma conta Web IQ

Esta etapa faz login no Azure, seleciona a assinatura em que a conta será criada e registra o provedor de recursos Microsoft.WebIQ. O registro do provedor disponibiliza o tipo de recurso do Web IQ em sua assinatura e só precisa ser feito uma vez por assinatura. O comando de registro aguarda até que o provedor esteja totalmente registrado antes de retornar.

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

Em seguida, a conta é criada a partir de uma definição que é montada como um objeto PowerShell e convertida em JSON. O comando passa esse JSON como a definição de recurso completa. Neste exemplo, a conta usa o local global, o tipo WebIQ.Grounding e o SKU G3, com statisticsEnabled definido como false. A versão da API identifica a revisão Microsoft.WebIQ usada para a implantação, portanto, 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

Obter a ID do recurso

Depois que a conta for criada, recupere sua ID de recurso. A ID do recurso é o caminho exclusivo da conta em Azure e você a usa para referenciar a conta em operações posteriores, incluindo a consulta de custo na próxima seção. Esse comando pesquisa a conta pelo nome e retorna apenas 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 cobrança do Azure

Esta etapa verifica quanto a conta custou. Ele cria um intervalo de datas que abrange os últimos 30 dias e, em seguida, solicita o custo diário, usando a medida PreTaxCost, filtrada para a ID do recurso da seção anterior.

A solicitação é enviada para Gerenciamento de Custos do Azure. Como ele tem como destino o Gerenciamento de Custos em vez do provedor do Web IQ, essa chamada usa sua própria versão de API, que é diferente daquela usada para criar a conta. Os dados de custo podem levar algum tempo para aparecer depois que uma conta é criada pela primeira vez, portanto, 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 seção lista os erros comuns que você pode ver ao criar a conta Web IQ e como resolvê-los. Se um comando falhar, leia o texto de erro completo que o CLI do Azure retorna, pois geralmente nomeia a causa exata e a ação a ser tomada.

Web IQ não está habilitado para sua assinatura

O Web IQ deve ser habilitado para sua assinatura do Azure para que você possa implantar o recurso. Se não estiver, a criação da conta falhará com um erro informando que o recurso não está habilitado para a assinatura selecionada.

Para resolvê-lo, entre em contato com seu representante da conta Microsoft ou executivo de vendas para solicitar acesso. Depois que sua assinatura estiver habilitada, execute o comando de criação da conta novamente.

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

O valor da versão da API deve ser uma revisão à qual o provedor Microsoft.WebIQ dá suporte. Este guia usa 2026-06-01-preview. Se você passar uma versão que o provedor não dá suporte, o comando falhará e Azure geralmente listará as versões com suporte na mensagem de erro. Para ver quais versões o provedor suporta, execute:

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

Use uma das versões retornadas pelo comando (2026-06-01-preview para este guia) e use o mesmo valor em todos os comandos do Web IQ para que a solicitação e a resposta correspondam.

Após a implantação

Após a implantação, inscreva-se ou entre no portal Web IQ, conecte sua ID de recurso e crie as chaves de API. Novos recursos do Web IQ começam com um limite de taxa padrão de 15 consultas por segundo (QPS); seu limite atual é mostrado no portal do Web IQ. O uso do Web IQ está sujeito aos Termos de Uso do Web IQ. Revise-os antes de começar.

  • Última atualização em