使用 Azure CLI 部署 Microsoft Web IQ

以下步骤将指导你登录 Azure、注册 Web IQ 资源提供程序、创建帐户、检索其资源 ID 并检查其计费成本。在 PowerShell 中运行所有命令，因为请求正文被构建为 PowerShell 对象并转换为 JSON。在运行它们之前，请将订阅 ID、资源组和帐户名称的占位符值替换为你自己的。

若要改为从浏览器部署 Web IQ，请参阅使用 Azure 门户部署Microsoft Web IQ。

Prerequisites

一个可以在其中创建资源的 Azure 订阅。 Web IQ 需要付费Azure订阅。 Azure信用不适用于 Web IQ。
Azure CLI和 PowerShell。

创建 Web IQ 帐户

此步骤将你登录到 Azure，选择要在其中创建帐户的订阅，并注册 Microsoft.WebIQ 资源提供程序。注册提供程序会使 Web IQ 资源类型在你的订阅中可用，并且只需为每个订阅完成一次。注册命令会一直等待，直到提供程序完全注册后才返回。

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

然后，从构建为 PowerShell 对象并转换为 JSON 的定义创建帐户。该命令将此 JSON 作为完整的资源定义传递。在此示例中，帐户使用全局位置、WebIQ.Grounding 种类和 G3 SKU，并且 statisticsEnabled 设置为 false。 API 版本标识用于部署的 Microsoft.WebIQ 修订版本，因此在后面的命令中使用相同的值。

$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

获取资源 ID

创建帐户后，检索其资源 ID。资源 ID 是 Azure 中该帐户的唯一标识符，用于在后续操作中引用该帐户，包括下一部分中的成本查询。此命令按名称查找帐户，并仅返回其 ID 值。

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

$resourceId

检查Azure计费成本

此步骤检查该账户已产生的费用。它生成一个日期范围，涵盖过去 30 天，然后使用 PreTaxCost 度量值请求每日成本，并按上一部分中的资源 ID 进行筛选。

请求将发送到Azure 成本管理。由于它面向成本管理而不是 Web IQ 提供程序，因此此调用使用自己的 API 版本，这不同于用于创建帐户的 API 版本。首次创建帐户后，成本数据可能需要一些时间才会显示，因此新帐户在当前周期内显示的费用可能很少或没有。

$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

本部分列出了创建 Web IQ 帐户时可能看到的常见错误，以及如何解决这些问题。如果命令失败，请读取 Azure CLI 返回的完整错误文本，因为它通常会指出确切原因以及应采取的操作。

未为订阅启用 Web IQ

必须先为Azure订阅启用 Web IQ，然后才能部署资源。如果不是，则帐户创建失败，并出现错误，指出未为所选订阅启用该功能。

若要解决此问题，请联系 Microsoft 帐户代表或销售主管以请求访问。启用订阅后，再次运行帐户创建命令。

API 版本无效

api-version 值必须是 Microsoft.WebIQ 提供程序支持的修订版本。本指南使用 2026-06-01-preview。如果传递提供程序不支持的版本，该命令将失败，Azure通常会在错误消息中列出受支持的版本。若要查看提供程序支持的版本，请运行：

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

使用命令返回的版本之一（本指南的 2026-06-01-preview），并在每个 Web IQ 命令中使用相同的值，以便请求和响应匹配。

部署后

部署后，注册或登录到 Web IQ 门户，连接资源 ID 并创建 API 密钥。新的 Web IQ 资源从每秒 15 个查询的默认速率限制开始（QPS）：当前限制显示在 Web IQ 门户中。 Web IQ 的使用受 Web IQ 使用条款的约束。请在开始之前查看它们。

反馈

此页面是否有帮助？

上次更新时间为 2026-10-16