Implemente Microsoft Web IQ con CLI de Azure

Los pasos siguientes le permiten iniciar sesión en Azure, registrar el proveedor de recursos de Web IQ, crear la cuenta, recuperar su identificador de recurso y comprobar su costo de facturación. Ejecute todos los comandos en PowerShell, ya que los cuerpos de la solicitud se crean como objetos de PowerShell y se convierten en JSON. Antes de ejecutarlos, reemplace los valores de marcador de posición para el identificador de suscripción, el grupo de recursos y el nombre de cuenta por el suyo propio.

Para implementar Web IQ desde el explorador, consulte Implementar Microsoft Web IQ con Azure Portal.

Prerequisites

  • Una suscripción de Azure donde puede crear recursos. Web IQ requiere una suscripción de Azure de pago. Los créditos de Azure no funcionan para Web IQ.
  • El CLI de Azure y PowerShell.

Creación de una cuenta de Web IQ

Este paso inicia sesión en Azure, selecciona la suscripción donde se creará la cuenta y registra el proveedor de recursos Microsoft.WebIQ. El registro del proveedor hace que el tipo de recurso de Web IQ esté disponible en su suscripción y solo debe realizarse una vez por suscripción. El comando de registro espera hasta que el proveedor esté completamente registrado antes de que devuelva.

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 continuación, la cuenta se crea a partir de una definición que se crea como un objeto de PowerShell y se convierte en JSON. El comando pasa este JSON como definición de recurso completa. En este ejemplo, la cuenta usa la ubicación global, el tipo WebIQ.Grounding y la SKU G3, con statisticsEnabled establecido en false. La versión de la API identifica la revisión de Microsoft.WebIQ usada para la implementación, así que use el mismo valor en los 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

Obtener el ID del recurso

Una vez creada la cuenta, recupere su identificador de recurso. El identificador de recurso es la ruta de acceso única de la cuenta en Azure y se usa para hacer referencia a la cuenta en operaciones posteriores, incluida la consulta de costos en la sección siguiente. Este comando busca la cuenta por nombre y devuelve solo su valor de identificador.

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

$resourceId

Comprobar el coste de facturación de Azure

En este paso se comprueba cuánto ha costado la cuenta. Compila un intervalo de fechas que cubre los últimos 30 días y, a continuación, solicita el costo diario, con la medida PreTaxCost, filtrada al identificador de recurso de la sección anterior.

La solicitud se envía a Azure Cost Management. Dado que tiene como destino Cost Management en lugar del proveedor de Web IQ, esta llamada usa su propia versión de API, que es diferente de la que se usa para crear la cuenta. Los datos de costo pueden tardar algún tiempo en aparecer después de crear una cuenta por primera vez, por lo que una nueva cuenta puede mostrar poco o ningún costo para el período actual.

$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

En esta sección se enumeran los errores comunes que puede ver al crear la cuenta de Web IQ y cómo resolverlos. Si un comando falla, lea el texto de error completo que devuelve el CLI de Azure, ya que normalmente nombra la causa exacta y la acción que se va a realizar.

Web IQ no está habilitado para su suscripción

Web IQ debe estar habilitado para la suscripción de Azure antes de poder implementar el recurso. Si no es así, la creación de la cuenta falla con un error que indica que la característica no está habilitada para la suscripción seleccionada.

Para resolverlo, póngase en contacto con su representante de cuenta Microsoft o ejecutivo de ventas para solicitar acceso. Una vez habilitada la suscripción, vuelva a ejecutar el comando de creación de la cuenta.

La versión de la API no es válida

El valor de api-version debe ser una revisión que admite el proveedor Microsoft.WebIQ. En esta guía se usa 2026-06-01-preview. Si pasa una versión que el proveedor no admite, se produce un error en el comando y Azure suele enumerar las versiones admitidas en el mensaje de error. Para ver qué versiones admite el proveedor, ejecute:

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

Utilice una de las versiones que devuelve el comando (2026-06-01-preview para esta guía) y use el mismo valor en todos los comandos de Web IQ para que la solicitud y la respuesta coincidan.

Después de la implementación

Después de la implementación, regístrese o inicie sesión en el portal de Web IQ, conecte el identificador de recurso y cree las claves de API. Los nuevos recursos de Web IQ comienzan con un límite de velocidad predeterminado de 15 consultas por segundo (QPS); El límite actual se muestra en el portal de Web IQ. Su uso de Web IQ está sujeto a los Términos de uso de Web IQ. Revíselos antes de comenzar.

  • Se actualizó por última vez el