A Microsoft Web IQ üzembe helyezése az Azure CLI-vel

Az alábbi lépések segítenek bejelentkezni az Azure-ba, regisztrálják a webes IQ-erőforrás-szolgáltatót, létrehozzák a fiókot, lekérik az erőforrás-azonosítóját, és ellenőrzik a számlázási költségeket. Futtassa az összes parancsot a PowerShellben, mert a kérelemtörzsek PowerShell-objektumokként épülnek fel, és JSON-ra vannak konvertálva. A futtatás előtt cserélje le az előfizetés azonosítójának, erőforráscsoportjának és fióknevének helyőrző értékeit a sajátjára.

Ha inkább a böngészőből szeretné üzembe helyezni a Web IQ-t, olvassa el a Microsoft Web IQ üzembe helyezése a Azure portálon című témakört.

Prerequisites

  • Egy Azure-előfizetés, ahol erőforrásokat hozhat létre. A Web IQ fizetős Azure-előfizetést igényel. Az Azure-kreditek nem működnek a Web IQ-ban.
  • A Azure CLI és a PowerShell.

Web IQ-fiók létrehozása

Ez a lépés bejelentkezteti Önt az Azure-ba, kiválasztja azt az előfizetést, amelyben a fiók létrejön, és regisztrálja a Microsoft.WebIQ erőforrás-szolgáltatót. A szolgáltató regisztrálása elérhetővé teszi a Web IQ-erőforrástípust az előfizetésben, és előfizetésenként csak egyszer kell elvégezni. A regisztrációs parancs megvárja, amíg a szolgáltató teljesen regisztrálva lesz, mielőtt visszatér.

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 fiók ezután egy PowerShell-objektumként felépített és JSON-ná alakított definícióból jön létre. A parancs ezt a JSON-t adja át teljes erőforrásdefinícióként. Ebben a példában a fiók a globális helyet, a WebIQ.Grounding típust és a G3 termékváltozatot használja, a statisticsEnabled értéke hamis. Az API-verzió azonosítja a telepítéshez használt Microsoft.WebIQ-verziót, ezért használja ugyanazt az értéket a későbbi parancsokban.

$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

Az erőforrás-azonosító lekérése

A fiók létrehozása után kérje le az erőforrás-azonosítóját. Az erőforrás-azonosító a fiók egyedi elérési útja az Azure-ban, és ezzel hivatkozhat a fiókra a későbbi műveletekben, beleértve a következő szakaszban szereplő költséglekérdezést is. Ez a parancs név alapján keresi meg a fiókot, és csak az azonosító értékét adja vissza.

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

$resourceId

Azure számlázási költség ellenőrzése

Ez a lépés ellenőrzi, hogy a fiók mennyibe került. Létrehoz egy dátumtartományt, amely lefedi az elmúlt 30 napot, majd kéri a napi költséget a PreTaxCost mérték használatával, szűrve az előző szakasz erőforrás-azonosítójára.

A kérést a rendszer elküldi az Azure Cost Managementnek. Mivel a Cost Managementet célozza meg a webes IQ-szolgáltató helyett, ez a hívás a saját API-verzióját használja, amely eltér a fiók létrehozásához használttól. Eltarthat egy ideig, mire a költségadatok megjelennek egy fiók első létrehozása után, így egy új fiók az aktuális időszakra vonatkozóan kevés vagy semennyi költséget nem mutathat.

$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

Ez a szakasz a Web IQ-fiók létrehozásakor előforduló gyakori hibákat és azok elhárításának módját sorolja fel. Ha egy parancs meghiúsul, olvassa el a Azure CLI által visszaadott teljes hibaüzenetet, mert általában a pontos okot és a végrehajtandó műveletet adja meg.

A Web IQ nincs engedélyezve az előfizetéséhez

Az erőforrás telepítése előtt engedélyezni kell a webes IQ-t az Azure-előfizetésében. Ha nem, a fióklétrehozás meghiúsul, és hibaüzenet jelenik meg arról, hogy a funkció nincs engedélyezve a kiválasztott előfizetéshez.

A probléma megoldásához forduljon Microsoft-fiók képviselőjéhez vagy értékesítési igazgatójához, hogy hozzáférést kérjen. Az előfizetés engedélyezése után futtassa újra a fióklétrehozási parancsot.

Az API-verzió érvénytelen

Az API-verzió értékének olyan revíziónak kell lennie, amelyet a Microsoft.WebIQ-szolgáltató támogatja. Ez az útmutató a 2026-06-01-preview verziót használja. Ha olyan verziót ad át, amelyet a szolgáltató nem támogat, a parancs meghiúsul, és az Azure általában felsorolja a támogatott verziókat a hibaüzenetben. A szolgáltató által támogatott verziók megtekintéséhez futtassa a következőt:

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

Használja a parancs által visszaadott verziók egyikét (2026-06-01-preview ehhez az útmutatóhoz), és használja ugyanazt az értéket minden Web IQ-parancsban, hogy a kérés és a válasz egyezzen.

Üzembe helyezés után

Az üzembe helyezés után regisztráljon vagy jelentkezzen be a Web IQ portalra, csatlakoztassa az erőforrás-azonosítót, és hozza létre az API-kulcsokat. Az új webes IQ-erőforrások alapértelmezés szerint másodpercenként 15 lekérdezéses (QPS) lekérdezési korláttal kezdődnek; az aktuális korlát a webes IQ-portálon jelenik meg. A Web IQ használatára a Web IQ Terms of Use vonatkoznak. Mielőtt hozzákezdene, tekintse át őket.

  • Utolsó frissítés időpontja: