Azure CLI 사용하여 Microsoft Web IQ 배포

아래 단계에서는 Azure 로그인하고, Web IQ 리소스 공급자를 등록하고, 계정을 만들고, 리소스 ID를 검색하고, 청구 비용을 확인합니다. 요청 본문은 PowerShell 개체로 빌드되고 JSON으로 변환되므로 모든 명령을 PowerShell에서 실행하세요. 실행하기 전에 구독 ID, 리소스 그룹 및 계정 이름의 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

대신 브라우저에서 Web IQ를 배포하려면 Azure 포털을 사용하여 Microsoft Web IQ 배포를 참조하세요.

사전 요구 사항

• 리소스를 만들 수 있는 Azure 구독입니다. Web IQ에는 유료 Azure 구독이 필요합니다. Azure 크레딧은 Web IQ에서 작동하지 않습니다.
• Azure CLI 및 PowerShell

Web IQ 계정 만들기

이 단계에서는 Azure에 로그인하고, 계정을 만들 구독을 선택하고, Microsoft.WebIQ 리소스 공급자를 등록합니다. 공급자를 등록하면 구독에서 웹 IQ 리소스 유형을 사용할 수 있으며 구독당 한 번만 수행해야 합니다. 등록 명령은 명령이 반환되기 전에 공급자가 완전히 등록될 때까지 기다립니다.

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을 전체 리소스 정의로 전달합니다. 이 예제에서 계정은 global 위치, 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 측정값을 사용하여 일일 비용을 요청합니다.

요청이 Azure Cost Management로 전송됩니다. 웹 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 구독에 웹 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 리소스는 초당 15개 쿼리(QPS)의 기본 속도 제한으로 시작합니다. 현재 제한은 웹 IQ 포털에 표시됩니다. Web IQ 사용은 웹 IQ 사용 약관의 적용을 받습니다. 시작하기 전에 검토하세요.