Развертывание Microsoft Web IQ с помощью Azure CLI

Приведенные ниже действия позволяют выполнить вход в Azure, зарегистрировать поставщика ресурсов Web IQ, создать учетную запись, получить идентификатор ресурса и проверить стоимость выставления счетов. Выполните все команды в PowerShell, так как тела запросов создаются как объекты PowerShell и преобразуются в JSON. Перед выполнением замените значения заполнителей для идентификатора подписки, группы ресурсов и имени учетной записи своими значениями.

Чтобы развернуть Web IQ из браузера, см. статью Развертывание Microsoft Web IQ с помощью портала Azure.

Prerequisites

  • Подписка Azure, в которой можно создавать ресурсы. Для Web IQ требуется платная подписка Azure. Кредиты Azure не действуют для Web IQ.
  • Azure CLI и PowerShell.

Создать учетную запись Web IQ

На этом шаге выполняется вход в Azure, выбирается подписка, в которой будет создана учетная запись, и регистрируется поставщик ресурсов Microsoft.WebIQ. Регистрация поставщика делает тип ресурса Веб-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 в качестве полного определения ресурса. В этом примере учетная запись использует глобальное местоположение, kind WebIQ.Grounding и номер SKU G3, а параметр 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

Получить идентификатор ресурса

После создания учетной записи получите идентификатор ресурса. Идентификатор ресурса — это уникальный путь учетной записи в Azure, и вы используете его для ссылки на учетную запись в последующих операциях, включая запрос затрат в следующем разделе. Эта команда ищет учетную запись по имени и возвращает только её идентификатор.

$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, отфильтрованную по идентификатору ресурса из предыдущего раздела.

Запрос отправляется в Azure Cost Management. Так как он нацелен на управление затратами, а не на поставщик Web IQ, этот вызов использует собственную версию 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, поскольку там обычно указаны точная причина и нужное действие.

Веб-IQ не включен для вашей подписки

Чтобы развернуть ресурс, необходимо включить Web IQ для подписки Azure. Если это не так, создание учетной записи завершается ошибкой с сообщением о том, что функция не включена для выбранной подписки.

Чтобы устранить эту проблему, обратитесь к представителю по работе с вашей учетной записью 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 для этого руководства), и используйте одно и то же значение в каждой команде Веб-IQ, чтобы запрос и ответ совпадали.

После развертывания

После развертывания зарегистрируйтесь или войдите на портал Web IQ, подключите идентификатор ресурса и создайте ключи API. Для новых ресурсов Web IQ по умолчанию установлен лимит 15 запросов в секунду (QPS); текущее ограничение отображается на портале Web IQ. Использование Web IQ регулируется условиями использования Web IQ. Перед началом работы просмотрите их.

  • Последнее обновление: