Migrar da API de Detalhes de Utilização do Consumo

  • Artigo

Este artigo aborda a migração fora da API de Detalhes de Utilização do Consumo. A API de Detalhes de Utilização do Consumo foi preterida. A data em que a API será desativada ainda está a ser determinada. Recomendamos que migre da API o mais rapidamente possível.

Destinos de migração

Leia o artigo Escolher uma solução de detalhes de custos antes de escolher qual a solução mais adequada para a sua carga de trabalho. Geralmente, recomendamos Exportações se tiver necessidades de ingestão de dados contínuas e um grande conjunto de dados de detalhes de utilização mensal. Para obter mais informações, veja Ingerir dados de detalhes de utilização.

Se tiver um conjunto de dados de detalhes de utilização mais pequeno ou um cenário que não seja cumprido pelas Exportações, considere utilizar o relatório Detalhes de Custos . Para obter mais informações, veja Obter conjuntos de dados de custos pequenos a pedido.

Nota

O relatório Detalhes de Custos só está disponível para clientes com uma Contrato Enterprise ou Contrato de Cliente Microsoft. Se tiver uma subscrição MSDN, pay as you go ou Visual Studio, pode migrar para Exportações ou continuar a utilizar a API de Detalhes de Utilização do Consumo.

Benefícios da migração

As novas soluções proporcionam muitas vantagens em termos da API de Detalhes de Utilização do Consumo. Eis um resumo:

  • Conjunto de dados único para todos os detalhes de utilização – o Azure e Azure Marketplace detalhes de utilização foram intercalados num único conjunto de dados. Reduz o número de APIs que precisa de chamar para ver todos os custos.
  • Escalabilidade – a API do Marketplaces foi preterida porque promove um padrão de chamada que não é capaz de dimensionar à medida que a utilização do Azure aumenta. O conjunto de dados de detalhes de utilização pode ser extremamente grande à medida que implementa mais recursos na cloud. A API do Marketplaces é uma API síncrona paginada, pelo que não é otimizada para transferir efetivamente grandes volumes de dados através de uma rede com elevada eficiência e fiabilidade. As exportações e a API de Detalhes de Custos são assíncronas . Fornecem-lhe um ficheiro CSV que pode ser transferido diretamente através da rede.
  • Melhoramentos da API – As exportações e a API de Detalhes de Custos são as soluções que o Azure suporta para avançar. Todas as novas funcionalidades estão a ser integradas nas mesmas.
  • Consistência do esquema – o relatório Detalhes do Custo e as Exportações fornecem aos ficheiros campos correspondentes que pode mover de uma solução para outra, com base no seu cenário.
  • Integração da Alocação de Custos – Contrato Enterprise e Contrato de Cliente Microsoft clientes que utilizam exportações ou a API de Detalhes de Custos podem ver os custos em relação às regras de alocação de custos que configuraram. Para obter mais informações sobre a alocação de custos, veja Alocar custos.

Diferenças de Campo

A tabela seguinte resume as diferenças de campo entre a API De Detalhes de Utilização do Consumo e a API Exportações/Detalhes de Custos. As exportações e a API detalhes de custos fornecem uma transferência de ficheiro CSV em vez da resposta JSON paginada fornecida pela API de Consumo.

mapeamento de campos de Contrato Enterprise

Contrato Enterprise clientes que estão a utilizar a API de Detalhes de Utilização do Consumo têm registos de detalhes de utilização do tipo legacy. Abaixo, é apresentado um registo de detalhes de utilização legado. Todos os Contrato Enterprise clientes têm registos deste tipo devido ao sistema de faturação subjacente que é utilizado para os mesmos.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

}

É apresentado um registo completo de Detalhes de Utilização legado em Detalhes de Utilização – Lista – API REST (Consumo do Azure)

A tabela seguinte fornece um mapeamento entre os campos antigos e os novos. Estão disponíveis novas propriedades nos ficheiros CSV produzidos pelas Exportações e pela API detalhes de custos. Para saber mais sobre os campos, veja Compreender os campos de detalhes de utilização.

Os nomes de propriedades a negrito não são alterados.

Propriedade Antiga Propriedade Nova
accountName AccountName
AccountOwnerId AccountOwnerId
additionalInfo AdditionalInfo
AvailabilityZone AvailabilityZone
billingAccountId BillingAccountId
billingAccountName BillingAccountName
billingCurrency BillingCurrencyCode
billingPeriodEndDate BillingPeriodEndDate
billingPeriodStartDate BillingPeriodStartDate
billingProfileId BillingProfileId
billingProfileName BillingProfileName
chargeType ChargeType
consumedService ConsumedService
custo CostInBillingCurrency
costCenter CostCenter
data Data
effectivePrice EffectivePrice
frequência Frequência
invoiceSection InvoiceSectionName
InvoiceSectionId InvoiceSectionId
isAzureCreditEligible IsAzureCreditEligible
meterCategory MeterCategory
meterId MeterId
meterName MeterName
MeterRegion MeterRegion
meterSubCategory MeterSubCategory
offerId OfferId
partNumber PartNumber
PayGPrice PayGPrice
PlanName PlanName
PricingModel PricingModel
produto NomeDoProduto
ProductOrderId ProductOrderId
ProductOrderName ProductOrderName
PublisherName Nome do Editor
PublisherType PublisherType
quantidade Quantidade
ReservationId ReservationId
ReservationName ReservationName
resourceGroup ResourceGroup
resourceId ResourceId
resourceLocation ResourceLocation
resourceName ResourceName
serviceFamily ServiceFamily
ServiceInfo1 ServiceInfo1
ServiceInfo2 ServiceInfo2
subscriptionId SubscriptionId
subscriptionName SubscriptionName
Etiquetas Etiquetas
Termo Termo
unitOfMeasure UnitOfMeasure
unitPrice UnitPrice
CostAllocationRuleName CostAllocationRuleName

Contrato de Cliente Microsoft mapeamento de campos

Contrato de Cliente Microsoft clientes que utilizam a API de Detalhes de Utilização do Consumo têm registos de detalhes de utilização do tipo modern. Abaixo, é apresentado um registo de detalhes de utilização moderno. Todos os Contrato de Cliente Microsoft clientes têm registos deste tipo devido ao sistema de faturação subjacente que é utilizado para os mesmos.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

}

Um registo de Detalhes de Utilização legado de exemplo completo é apresentado em Detalhes de Utilização – Lista – API REST (Consumo do Azure)

É apresentado um mapeamento entre os campos antigos e novos na tabela seguinte. Estão disponíveis novas propriedades nos ficheiros CSV produzidos pelas Exportações e pela API detalhes de custos. Os campos que precisam de um mapeamento devido a diferenças entre as soluções são apresentados em texto a negrito.

Para obter mais informações, veja Compreender os campos de detalhes de utilização.

Propriedade antiga Nova propriedade
invoiceId invoiceId
previousInvoiceId previousInvoiceId
billingAccountId billingAccountId
billingAccountName billingAccountName
billingProfileId billingProfileId
billingProfileName billingProfileName
invoiceSectionId invoiceSectionId
invoiceSectionName invoiceSectionName
partnerTenantId partnerTenantId
partnerName partnerName
resellerName resellerName
resellerMpnId resellerMpnId
customerTenantId customerTenantId
customerName customerName
costCenter costCenter
billingPeriodEndDate billingPeriodEndDate
billingPeriodStartDate billingPeriodStartDate
servicePeriodEndDate servicePeriodEndDate
servicePeriodStartDate servicePeriodStartDate
data data
serviceFamily serviceFamily
productOrderId productOrderId
productOrderName productOrderName
consumedService consumedService
meterId meterId
meterName meterName
meterCategory meterCategory
meterSubCategory meterSubCategory
meterRegion meterRegion
productIdentifier ProductId
produto NomeDoProduto
subscriptionGuid SubscriptionId
subscriptionName subscriptionName
publisherType publisherType
publisherId publisherId
publisherName publisherName
resourceGroup resourceGroupName
instanceName ResourceId
resourceLocationNormalized localização
resourceLocation localização
effectivePrice effectivePrice
quantidade quantidade
unitOfMeasure unitOfMeasure
chargeType chargeType
billingCurrencyCode billingCurrency
pricingCurrencyCode pricingCurrency
costInBillingCurrency costInBillingCurrency
costInPricingCurrency costInPricingCurrency
costInUsd costInUsd
paygCostInBillingCurrency paygCostInBillingCurrency
paygCostInUSD paygCostInUsd
exchangeRatePricingToBilling exchangeRatePricingToBilling
exchangeRateDate exchangeRateDate
isAzureCreditEligible isAzureCreditEligible
serviceInfo1 serviceInfo1
serviceInfo2 serviceInfo2
additionalInfo additionalInfo
etiquetas etiquetas
partnerEarnedCreditRate partnerEarnedCreditRate
partnerEarnedCreditApplied partnerEarnedCreditApplied
marketPrice PayGPrice
frequência frequência
termo termo
reservationId reservationId
reservationName reservationName
preçosModel preçosModel
unitPrice unitPrice
exchangeRatePricingToBilling exchangeRatePricingToBilling

Passos seguintes