Menyebarkan Microsoft Web IQ dengan Azure CLI

Langkah-langkah di bawah ini membuat Anda masuk ke Azure, mendaftarkan penyedia sumber daya Web IQ, membuat akun, mengambil ID sumber dayanya, dan memeriksa biaya penagihannya. Jalankan semua perintah di PowerShell, karena badan permintaan dibangun sebagai objek PowerShell dan dikonversi ke JSON. Sebelum Anda menjalankannya, ganti nilai placeholder untuk ID langganan, grup sumber daya, dan nama akun dengan nilai Anda sendiri.

Untuk menyebarkan Web IQ dari browser Anda sebagai gantinya, lihat Menyebarkan Microsoft Web IQ dengan portal Azure.

Prerequisites

  • Langganan Azure tempat Anda dapat membuat sumber daya. Web IQ memerlukan langganan Azure berbayar. kredit Azure tidak berfungsi untuk Web IQ.
  • Azure CLI dan PowerShell.

Buat akun Web IQ

Langkah ini membuat Anda masuk ke Azure, memilih langganan tempat akun akan dibuat, dan mendaftarkan penyedia sumber daya Microsoft.WebIQ. Mendaftarkan penyedia membuat jenis sumber daya Web IQ tersedia di langganan Anda dan hanya perlu dilakukan sekali per langganan. Perintah pendaftaran menunggu hingga penyedia sepenuhnya terdaftar sebelum perintah ini selesai.

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

Akun kemudian dibuat dari definisi yang dibangun sebagai objek PowerShell dan dikonversi ke JSON. Perintah mengirimkan JSON ini sebagai definisi resource lengkap. Dalam contoh ini akun menggunakan lokasi global, jenis WebIQ.Grounding, dan SKU G3, dengan statistikEnabled diatur ke false. Versi API mengidentifikasi revisi Microsoft.WebIQ yang digunakan untuk penyebaran, jadi gunakan nilai yang sama dalam perintah selanjutnya.

$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

Mendapatkan ID sumber daya

Setelah akun dibuat, ambil ID sumber dayanya. Resource ID adalah jalur unik akun di Azure, dan Anda menggunakannya untuk mereferensikan akun dalam operasi selanjutnya, termasuk kueri biaya di bagian berikutnya. Perintah ini mencari akun berdasarkan nama dan hanya mengembalikan nilai ID-nya.

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

$resourceId

Periksa biaya penagihan Azure

Langkah ini memeriksa berapa besar biaya akun ini. Ini membangun rentang tanggal yang mencakup 30 hari terakhir dan kemudian meminta biaya harian, menggunakan pengukuran PreTaxCost, difilter ke ID sumber daya dari bagian sebelumnya.

Permintaan dikirim ke Azure Cost Management. Karena ditujukan untuk Cost Management, bukan penyedia Web IQ, panggilan ini menggunakan versi API-nya sendiri, yang berbeda dari yang digunakan untuk membuat akun. Data biaya dapat memakan waktu untuk muncul setelah akun pertama kali dibuat, sehingga akun baru mungkin menunjukkan sedikit atau tanpa biaya untuk periode saat ini.

$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

Bagian ini mencantumkan kesalahan umum yang mungkin Anda lihat saat membuat akun Web IQ, dan cara mengatasinya. Jika perintah gagal, baca teks kesalahan lengkap yang dikembalikan Azure CLI, karena biasanya memberi nama penyebab yang tepat dan tindakan yang harus diambil.

Web IQ tidak diaktifkan untuk langganan Anda

Web IQ harus diaktifkan untuk langganan Azure Anda sebelum Anda dapat mendeploy resource. Jika tidak, pembuatan akun gagal dengan kesalahan yang menyatakan bahwa fitur tidak diaktifkan untuk langganan yang dipilih.

Untuk mengatasinya, hubungi perwakilan akun Microsoft Anda atau eksekutif penjualan Anda untuk meminta akses. Setelah langganan Anda diaktifkan, jalankan perintah pembuatan akun lagi.

Versi API tidak valid

Nilai api-version harus berupa revisi yang didukung oleh penyedia Microsoft.WebIQ. Panduan ini menggunakan 2026-06-01-preview. Jika Anda meneruskan versi yang tidak didukung penyedia, perintah gagal, dan Azure biasanya mencantumkan versi yang didukung dalam pesan kesalahan. Untuk melihat versi mana yang didukung penyedia, jalankan:

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

Gunakan salah satu versi yang dikembalikan perintah (2026-06-01-preview untuk panduan ini), dan gunakan nilai yang sama di setiap perintah Web IQ sehingga permintaan dan respons cocok.

Setelah peluncuran

Setelah penyebaran, daftar atau masuk ke portal Web IQ, sambungkan ID sumber daya Anda, dan buat kunci API. Sumber daya Web IQ baru dimulai dengan batas permintaan default 15 kueri per detik (QPS); batas Anda saat ini ditampilkan di portal Web IQ. Penggunaan Web IQ Anda tunduk pada Ketentuan Penggunaan Web IQ. Harap tinjau semuanya sebelum Anda mulai.

  • Terakhir diperbarui pada