Wdrażanie Microsoft Web IQ przy użyciu Azure CLI

Poniższe kroki umożliwiają zalogowanie się do Azure, zarejestrowanie dostawcy zasobów Web IQ, utworzenie konta, pobranie identyfikatora zasobu i sprawdzenie kosztów rozliczeń. Uruchom wszystkie polecenia w programie PowerShell, ponieważ treści żądań są tworzone jako obiekty programu PowerShell i konwertowane na format JSON. Przed ich uruchomieniem zastąp wartości zastępcze identyfikatora subskrypcji, grupy zasobów i nazwy konta własnymi.

Aby zamiast tego wdrożyć Web IQ z poziomu przeglądarki, zobacz Wdrażanie rozwiązania Microsoft Web IQ przy użyciu witryny Azure Portal.

Prerequisites

  • Subskrypcja Azure, w której można tworzyć zasoby. Usługa Web IQ wymaga płatnej subskrypcji Azure. Kredyty platformy Azure nie działają w przypadku Web IQ.
  • Azure CLI i program PowerShell.

Utwórz konto Web IQ

Ten krok powoduje zalogowanie cię do Azure, wybranie subskrypcji, w której zostanie utworzone konto, i zarejestrowanie dostawcy zasobów Microsoft.WebIQ. Zarejestrowanie dostawcy sprawia, że typ zasobu Web IQ jest dostępny w ramach subskrypcji i musi być wykonywany tylko raz na subskrypcję. Polecenie rejestracji czeka, aż dostawca zostanie w pełni zarejestrowany, zanim polecenie zwróci wynik.

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

Konto jest następnie tworzone na podstawie definicji, która jest tworzona jako obiekt PowerShell i konwertowana na format JSON. Polecenie przekazuje ten kod JSON jako pełną definicję zasobu. W tym przykładzie konto używa lokalizacji globalnej, rodzaju WebIQ.Grounding i SKU G3, z ustawieniem statisticsEnabled na false. Wersja interfejsu API identyfikuje wersję Microsoft.WebIQ używaną do wdrożenia, więc użyj tej samej wartości w kolejnych poleceniach.

$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

Pobierz identyfikator zasobu

Po utworzeniu konta pobierz jego identyfikator zasobu. Identyfikator zasobu jest unikatową ścieżką konta w Azure i służy do odwoływanie się do konta w kolejnych operacjach, w tym zapytania o koszt w następnej sekcji. To polecenie wyszukuje konto według nazwy i zwraca tylko jego wartość identyfikatora.

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

$resourceId

Sprawdzanie kosztów rozliczeń Azure

Ten krok sprawdza, ile kosztowało konto. Tworzy zakres dat obejmujący ostatnie 30 dni, a następnie żąda dziennego kosztu przy użyciu miary PreTaxCost odfiltrowanej do identyfikatora zasobu z poprzedniej sekcji.

Żądanie jest wysyłane do Azure Cost Management. Ponieważ jest ona przeznaczona dla usługi Cost Management, a nie dostawcy Web IQ, to wywołanie używa własnej wersji interfejsu API, która różni się od używanej do utworzenia konta. Dane o kosztach mogą pojawić się po pewnym czasie po pierwszym utworzeniu konta, więc nowe konto może wykazywać niewielkie koszty lub ich brak w bieżącym okresie.

$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

W tej sekcji wymieniono typowe błędy, które mogą wystąpić podczas tworzenia konta Web IQ, oraz sposoby ich rozwiązywania. Jeśli polecenie zakończy się niepowodzeniem, przeczytaj pełny tekst błędu zwracany przez Azure CLI, ponieważ zwykle określa dokładną przyczynę i akcję do wykonania.

Web IQ nie jest włączona dla twojej subskrypcji

Aby można było wdrożyć zasób, należy włączyć Web IQ dla subskrypcji Azure. Jeśli tak nie jest, tworzenie konta kończy się niepowodzeniem z informacją o błędzie informującym, że funkcja nie jest włączona dla wybranej subskrypcji.

Aby rozwiązać ten problem, skontaktuj się z opiekunem konta Microsoft lub przedstawicielem działu sprzedaży, aby poprosić o dostęp. Po włączeniu subskrypcji ponownie uruchom polecenie tworzenia konta.

Wersja interfejsu API jest nieprawidłowa

Wartość api-version musi być rewizją obsługiwaną przez dostawcę Microsoft.WebIQ. W tym przewodniku użyto 2026-06-01-preview. Jeśli przekażesz wersję, której dostawca nie obsługuje, polecenie zakończy się niepowodzeniem, a Azure zazwyczaj wyświetla listę obsługiwanych wersji w komunikacie o błędzie. Aby sprawdzić, które wersje obsługuje dostawca, uruchom polecenie:

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

Użyj jednej z wersji zwracanych przez polecenie (2026-06-01-preview dla tego przewodnika) i użyj tej samej wartości w każdym poleceniu Web IQ, aby żądanie i odpowiedź odpowiadały.

Po wdrożeniu

Po wdrożeniu zarejestruj się lub zaloguj się do portalu Web IQ, połącz swój identyfikator zasobu i utwórz klucze interfejsu API. Nowe zasoby Web IQ mają domyślny limit 15 zapytań na sekundę (QPS); bieżący limit jest wyświetlany w portalu Web IQ. Korzystanie z Web IQ podlega Warunkom użytkowania Web IQ. Przed rozpoczęciem przejrzyj je.

  • Ostatnia aktualizacja o