Azure CLI ile Microsoft Web IQ'yu dağıtın

Aşağıdaki adımlar Azure’da oturum açmanızı, Web IQ kaynak sağlayıcısını kaydetmenizi, hesabı oluşturmanızı, kaynak kimliğini almanızı ve faturalama maliyetini denetlemenizi sağlar. İstek gövdeleri PowerShell nesneleri olarak oluşturulduğundan ve JSON'a dönüştürüldüğünden, PowerShell'deki tüm komutları çalıştırın. Bunları çalıştırmadan önce abonelik kimliği, kaynak grubu ve hesap adı için yer tutucu değerlerini kendi değerlerinizle değiştirin.

Bunun yerine tarayıcınızdan Web IQ dağıtmak için bkz. Azure portalıyla Microsoft Web IQ dağıtma.

Prerequisites

  • Kaynak oluşturabileceğiniz bir Azure aboneliği. Web IQ ücretli bir Azure aboneliği gerektirir. Azure kredileri Web IQ için kullanılamaz.
  • Azure CLI ve PowerShell.

Web IQ hesabı oluşturun

Bu adım sizi Azure'da oturum açtırır, hesabın oluşturulacağı aboneliği seçer ve Microsoft.WebIQ kaynak sağlayıcısını kaydeder. Sağlayıcının kaydedilmesi, Web IQ kaynak türünü aboneliğinizde kullanılabilir hale getirir ve abonelik başına yalnızca bir kez yapılması gerekir. Kayıt komutu, geri dönmeden önce sağlayıcı tam olarak kaydedilene kadar bekler.

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

Ardından hesap, PowerShell nesnesi olarak oluşturulan ve JSON'a dönüştürülen bir tanımdan oluşturulur. Komut, bu JSON'u kaynağın tam tanımı olarak iletir. Bu örnekte hesap genel konumu, WebIQ.Grounding türünü ve G3 SKU'yu kullanır ve statisticsEnabled değeri false olarak ayarlanmıştır. API sürümü, dağıtım için kullanılan Microsoft.WebIQ düzeltmesini belirtir; bu nedenle sonraki komutlarda aynı değeri kullanın.

$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

Kaynak kimliğini alın

Hesap oluşturulduktan sonra kaynak kimliğini alın. Kaynak kimliği, hesabın Azure'daki benzersiz yoludur ve sonraki bölümdeki maliyet sorgusu da dahil olmak üzere sonraki işlemlerde hesaba başvurularda kullanmak için bunu kullanırsınız. Bu komut hesabı ada göre arar ve yalnızca kimlik değerini döndürür.

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

$resourceId

Azure faturalama maliyetini denetleyin

Bu adım hesabın ne kadara mal olduğunu kontrol eder. Son 30 günü kapsayan bir tarih aralığı oluşturur ve önceki bölümdeki kaynak kimliğine göre filtrelenmiş PreTaxCost ölçüsünü kullanarak günlük maliyeti talep eder.

İstek Azure Maliyet Yönetimi'e gönderilir. Web IQ sağlayıcısı yerine Maliyet Yönetimi'ni hedeflediğinden, bu çağrı hesabı oluşturmak için kullanılandan farklı olan kendi API sürümünü kullanır. Maliyet verilerinin hesap ilk kez oluşturulduktan sonra görünmesi biraz zaman alabilir, bu nedenle yeni bir hesap geçerli dönem için çok az maliyet gösterebilir veya hiç maliyet göstermeyebilir.

$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

Bu bölümde, Web IQ hesabını oluştururken görebileceğiniz yaygın hatalar ve bunların nasıl çözülebileceği listelenir. Bir komut başarısız olursa, Azure CLI’nin döndürdüğü tam hata metnini okuyun çünkü genellikle tam nedeni ve yapılması gereken işlemi belirtir.

Aboneliğiniz için Web IQ etkin değil

Kaynağı dağıtmanız için önce Azure aboneliğinizde Web IQ etkinleştirilmelidir. Değilse, hesap oluşturma işlemi özelliğin seçili abonelik için etkinleştirilmediğini belirten bir hatayla başarısız olur.

Sorunu çözmek için erişim istemek için Microsoft hesabı temsilcinize veya satış yöneticinize başvurun. Aboneliğiniz etkinleştirildikten sonra hesap oluşturma komutunu yeniden çalıştırın.

API sürümü geçerli değil

api-version değeri, Microsoft.WebIQ sağlayıcısının desteklediği bir revizyon olmalıdır. Bu kılavuzda 2026-06-01-preview kullanılır. Sağlayıcının desteklemediği bir sürüm belirtirseniz komut başarısız olur ve Azure genellikle desteklenen sürümleri hata iletisinde listeler. Sağlayıcının hangi sürümleri desteklediğini görmek için şunu çalıştırın:

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

Komutun döndürdüğü sürümlerden birini kullanın (bu kılavuz için 2026-06-01-preview) ve istekle yanıt eşleşsin diye her Web IQ komutunda aynı değeri kullanın.

Dağıtımdan sonra

Dağıtımdan sonra Web IQ portalına kaydolun veya oturum açın, kaynak kimliğinizi bağlayın ve API anahtarlarını oluşturun. Yeni Web IQ kaynakları saniyede 15 sorgu (QPS) varsayılan hız sınırıyla başlar; geçerli sınırınız Web IQ portalında gösterilir. Web IQ kullanımınız Web IQ Kullanım Koşulları'na tabidir. Başlamadan önce lütfen bunları gözden geçirin.

  • Son güncelleştirme: