Nasazení Microsoft Web IQ pomocí Azure CLI

Následující postup vás přihlásí k Azure, zaregistruje poskytovatele prostředků Web IQ, vytvoří účet, načte jeho ID prostředku a zkontroluje jeho fakturační náklady. Spusťte všechny příkazy v PowerShellu, protože těla požadavků jsou sestavená jako objekty PowerShellu a jsou převedena do formátu JSON. Než je spustíte, nahraďte zástupné hodnoty pro ID předplatného, skupinu prostředků a název účtu svými vlastními hodnotami.

Pokud chcete místo toho nasadit Web IQ z prohlížeče, viz Nasazení Microsoft Web IQ pomocí portálu Azure.

Prerequisites

  • Předplatné Azure, ve kterém můžete vytvářet prostředky. Webové IQ vyžaduje placené předplatné Azure. Azure kredity nefungují pro Web IQ.
  • Azure CLI a PowerShell.

Vytvořte si účet Web IQ

Tento krok vás přihlásí k Azure, vybere předplatné, ve kterém se účet vytvoří, a zaregistruje poskytovatele prostředků Microsoft.WebIQ. Registrací poskytovatele zpřístupníte typ prostředku Web IQ ve vašem předplatném a stačí ho provést jenom jednou pro každé předplatné. Příkaz registrace počká, až se poskytovatel plně zaregistruje, než se vrátí.

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

Účet se pak vytvoří z definice vytvořené jako objekt PowerShellu a převedené na JSON. Tento příkaz předá tento JSON jako úplnou definici prostředku. V tomto příkladu účet používá globální umístění, druh WebIQ.Grounding a SKU G3 s parametrem statisticsEnabled nastaveným na false. Verze rozhraní API identifikuje revizi Microsoft.WebIQ použitou pro nasazení, proto použijte stejnou hodnotu v pozdějších příkazech.

$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

Získejte ID prostředku

Po vytvoření účtu načtěte JEHO ID prostředku. ID prostředku je jedinečná cesta účtu v Azure a vy ho použijete k odkazování na účet v pozdějších operacích, včetně dotazu na náklady v další části. Tento příkaz vyhledá účet podle názvu a vrátí pouze jeho ID.

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

$resourceId

Zkontrolovat náklady na fakturaci Azure

Tento krok zkontroluje, kolik účet stál. Vytvoří rozsah kalendářních dat, který pokrývá posledních 30 dnů, a pak vyžádá denní náklady pomocí míry PreTaxCost, filtrované podle ID prostředku z předchozí části.

Žádost se odešle do Správa nákladů v Azure. Vzhledem k tomu, že cílí na Cost Management místo poskytovatele Web IQ, používá toto volání vlastní verzi rozhraní API, která se liší od verze použité k vytvoření účtu. Data o nákladech se mohou po prvním vytvoření účtu zobrazit až po nějaké době, takže nový účet může v aktuálním období vykazovat malé nebo nulové náklady.

$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

Tato část uvádí běžné chyby, které se můžou zobrazit při vytváření účtu Web IQ, a jak je vyřešit. Pokud příkaz selže, přečtěte si celý text chyby, který Azure CLI vrátí, protože obvykle označuje přesnou příčinu a akci, kterou chcete provést.

Web IQ není pro vaše předplatné povolené.

Před nasazením prostředku musí být pro vaše předplatné Azure povolený Web IQ. Pokud tomu tak není, vytvoření účtu selže s chybou s oznámením, že pro vybrané předplatné není tato funkce povolená.

Chcete-li to vyřešit, obraťte se na svého zástupce pro účet Microsoft nebo manažera prodeje a požádejte o přístup. Jakmile je vaše předplatné povolené, spusťte příkaz pro vytvoření účtu znovu.

Verze rozhraní API není platná.

Hodnota api-version musí být revize, kterou podporuje poskytovatel Microsoft.WebIQ. Tato příručka používá verzi 2026-06-01-preview. Pokud předáte verzi, kterou poskytovatel nepodporuje, příkaz selže a Azure obvykle uvádí podporované verze v chybové zprávě. Pokud chcete zjistit, které verze poskytovatel podporuje, spusťte:

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

Pro tuto příručku použijte jednu z verzí, které příkaz vrátí (2026-06-01-preview) a v každém příkazu webového IQ použijte stejnou hodnotu, aby se požadavek a odpověď shodovaly.

Po nasazení

Po nasazení se zaregistrujte nebo přihlaste k portálu Web IQ, připojte SVÉ ID prostředku a vytvořte klíče rozhraní API. Nové prostředky webového IQ mají výchozí limit 15 dotazů za sekundu (QPS); váš aktuální limit se zobrazí na portálu webového IQ. Vaše použití Web IQ podléhá Podmínkám používání Web IQ. Než začnete, projděte si je.

  • Poslední aktualizace v