Habilidade de Preços do Azure

Use esta habilidade para obter dados de preços de varejo do Azure em tempo real da API pública de Preços de Varejo do Azure. Nenhuma autenticação é necessária.

Quando Usar Esta Habilidade

• O usuário pergunta sobre o custo de um serviço do Azure (por exemplo, "Quanto custa uma VM D4s v5?")
• O usuário quer comparar preços entre regiões ou SKUs
• O usuário precisa de uma estimativa de custo para uma carga de trabalho ou arquitetura
• O usuário menciona preços do Azure, custos do Azure ou faturamento do Azure
• O usuário pergunta sobre instâncias reservadas versus preços de pagamento conforme o uso
• O usuário quer saber sobre planos de economia ou preços spot

Endpoint da API

GET https://prices.azure.com/api/retail/prices?api-version=2023-01-01-preview

Anexe $filter como um parâmetro de consulta usando a sintaxe de filtro OData. Sempre use api-version=2023-01-01-preview para garantir que os dados do plano de economia sejam incluídos.

Instruções Passo a Passo

Se algo não estiver claro sobre a solicitação do usuário, faça perguntas esclarecedoras para identificar os campos e valores de filtro corretos antes de chamar a API.

1. Identifique os campos de filtro da solicitação do usuário (nome do serviço, região, SKU, tipo de preço).
2. Resolva a região: a API requer valores armRegionName em minúsculas e sem espaços (por exemplo, "East US" → eastus, "West Europe" → westeurope, "Southeast Asia" → southeastasia). Veja references/REGIONS.md para uma lista completa.
3. Construa a string de filtro usando os campos abaixo e busque a URL.
4. Analise a matriz Items da resposta JSON. Cada item contém preço e metadados.
5. Siga a paginação via NextPageLink se precisar de mais de 1000 resultados (raramente necessário).
6. Calcule as estimativas de custo usando as fórmulas em references/COST-ESTIMATOR.md para produzir estimativas mensais/anuais.
7. Apresente os resultados em uma tabela de resumo clara com serviço, SKU, região, preço unitário e estimativas mensais/anuais.

Campos Filtráveis

Use eq para igualdade, and para combinar e contains(field, 'value') para correspondências parciais.

Exemplos de Strings de Filtro

# All consumption prices for Functions in East US
serviceName eq 'Functions' and armRegionName eq 'eastus' and priceType eq 'Consumption'

# D4s v5 VMs in West Europe (consumption only)
armSkuName eq 'Standard_D4s_v5' and armRegionName eq 'westeurope' and priceType eq 'Consumption'

# All storage prices in a region
serviceName eq 'Storage' and armRegionName eq 'eastus'

# Spot pricing for a specific SKU
armSkuName eq 'Standard_D4s_v5' and contains(meterName, 'Spot') and armRegionName eq 'eastus'

# 1-year reservation pricing
serviceName eq 'Virtual Machines' and priceType eq 'Reservation' and armRegionName eq 'eastus'

# Azure AI / OpenAI pricing (now under Foundry Models)
serviceName eq 'Foundry Models' and armRegionName eq 'eastus' and priceType eq 'Consumption'

# Azure Cosmos DB pricing
serviceName eq 'Azure Cosmos DB' and armRegionName eq 'eastus' and priceType eq 'Consumption'

URL de Busca de Exemplo Completo

https://prices.azure.com/api/retail/prices?api-version=2023-01-01-preview&$filter=serviceName eq 'Functions' and armRegionName eq 'eastus' and priceType eq 'Consumption'

Codifique espaços como %20 e aspas como %27 ao construir a URL.

Campos Chave da Resposta

{
  "Items": [
    {
      "retailPrice": 0.000016,
      "unitPrice": 0.000016,
      "currencyCode": "USD",
      "unitOfMeasure": "1 Execution",
      "serviceName": "Functions",
      "skuName": "Premium",
      "armRegionName": "eastus",
      "meterName": "vCPU Duration",
      "productName": "Functions",
      "priceType": "Consumption",
      "isPrimaryMeterRegion": true,
      "savingsPlan": [
        { "unitPrice": 0.000012, "term": "1 Year" },
        { "unitPrice": 0.000010, "term": "3 Years" }
      ]
    }
  ],
  "NextPageLink": null,
  "Count": 1
}

…