Azure CLI Microsoft Web IQ をデプロイする

次の手順では、Azureにサインインし、Web IQ リソース プロバイダーを登録し、アカウントを作成し、そのリソース ID を取得し、課金コストを確認します。 要求本文は PowerShell オブジェクトとしてビルドされ、JSON に変換されるため、すべてのコマンドは PowerShell で実行してください。 実行する前に、サブスクリプション ID、リソース グループ、アカウント名のプレースホルダー値を独自の値に置き換えてください。

代わりにブラウザーから Web IQ をデプロイするには、Azure ポータルで Microsoft Web IQ をデプロイするを参照してください。

Prerequisites

  • リソースを作成できる Azure サブスクリプション。 Web IQ には有料のAzure サブスクリプションが必要です。 Azure クレジットは Web IQ では機能しません。
  • Azure CLIと PowerShell。

Web IQ アカウントを作成する

この手順では、Azureにサインインし、アカウントが作成されるサブスクリプションを選択して、Microsoft.WebIQ リソース プロバイダーを登録します。 プロバイダーを登録すると、Web IQ リソースの種類がサブスクリプションで使用可能になり、登録はサブスクリプションごとに 1 回だけ必要です。 登録コマンドは、プロバイダーが完全に登録されるまで待機してから戻ります。

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

その後、アカウントは、PowerShell オブジェクトとして構築され、JSON に変換される定義から作成されます。 このコマンドは、この JSON を完全なリソース定義として渡します。 この例では、アカウントはグローバルな場所を使用し、種類は WebIQ.Grounding で、G3 SKU を使用し、statisticsEnabled を false に設定します。 API バージョンは、デプロイに使用される Microsoft.WebIQ リビジョンを識別します。そのため、後続のコマンドでは同じ値を使用してください。

$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

リソース ID を取得する

アカウントが作成されたら、そのリソース ID を取得します。 リソース ID は、Azure内のアカウントの一意のパスであり、後の操作 (次のセクションのコスト クエリを含む) でアカウントを参照するために使用します。 このコマンドは、アカウントを名前で検索し、その ID 値のみを返します。

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

$resourceId

Azure の請求コストを確認する

この手順では、アカウントにかかった費用を確認します。 過去 30 日間を対象とする日付範囲を構築し、前のセクションのリソース ID にフィルター処理された PreTaxCost メジャーを使用して、1 日のコストを要求します。

要求はAzure Cost Managementに送信されます。 Web IQ プロバイダーではなく Cost Management を対象としているため、この呼び出しでは独自の API バージョンが使用されます。これは、アカウントの作成に使用されるバージョンとは異なります。 コスト データは、アカウントが最初に作成された後に表示されるまでに時間がかかる場合があるため、新しいアカウントでは現在の期間のコストがほとんどまたはまったく表示されない場合があります。

$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

このセクションでは、Web IQ アカウントの作成時に発生する可能性がある一般的なエラーとその解決方法を示します。 コマンドが失敗した場合は、通常、正確な原因と取るべき対処が示されているため、Azure CLI が返す完全なエラー テキストを確認してください。

サブスクリプションで Web IQ が有効になっていない

リソースをデプロイする前に、Azure サブスクリプションに対して Web IQ を有効にする必要があります。 有効でない場合、アカウントの作成は失敗し、選択したサブスクリプションに対して機能が有効になっていないことを示すエラーが表示されます。

この問題を解決するには、Microsoft アカウント担当者または営業担当者に連絡してアクセス権を要求してください。 サブスクリプションが有効になったら、アカウント作成コマンドをもう一度実行してください。

API のバージョンが無効です

api-version 値は、Microsoft.WebIQ プロバイダーがサポートするリビジョンである必要があります。 このガイドでは、2026-06-01-preview を使用します。 プロバイダーがサポートしていないバージョンを渡すと、コマンドは失敗し、Azureは通常、サポートされているバージョンをエラー メッセージに一覧表示します。 プロバイダーがサポートしているバージョンを確認するには、次のコマンドを実行します。

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

コマンドが返すいずれかのバージョン (このガイドでは 2026-06-01-preview) を使用し、要求と応答が一致するように、すべての Web IQ コマンドで同じ値を使用します。

配置後

デプロイ後、Web IQ ポータルにサインアップまたはサインインし、リソース ID を関連付けて、API キーを作成します。 新しい Web IQ リソースには、既定では、1 秒あたり 15 クエリ (QPS) のレート制限が設定されています。現在の制限は Web IQ ポータルに表示されます。 お客様による Web IQ の使用は、 Web IQ 利用規約に従います。 開始する前に、それらを確認してください。

  • 最終更新: