Migrace z rozhraní API s podrobnostmi o využití využití

  • Článek

Tento článek popisuje migraci mimo rozhraní API Podrobnosti o využití využití. Rozhraní API Consumption Usage Details je zastaralé. Datum, kdy bude rozhraní API vypnuto, se stále určuje. Doporučujeme co nejdříve migrovat z rozhraní API.

Cíle migrace

Než zvolíte, které řešení je pro vaši úlohu vhodné, přečtěte si článek Volba řešení s podrobnostmi o nákladech . Obecně doporučujeme exporty , pokud máte průběžné potřeby ingestování dat nebo velkou datovou sadu podrobností o měsíčním využití. Další informace najdete v tématu Příjem dat s podrobnostmi o využití.

Pokud máte menší datovou sadu podrobností o využití nebo scénář, který exporty nesplní, zvažte místo toho použití sestavy Podrobnosti o nákladech . Další informace najdete v tématu Získání datových sad s malými náklady na vyžádání.

Poznámka

Sestava podrobností nákladů je dostupná jenom pro zákazníky s smlouva Enterprise nebo Smlouva se zákazníkem Microsoftu. Pokud máte předplatné MSDN, průběžné platby nebo předplatné sady Visual Studio, můžete migrovat na exporty nebo pokračovat v používání rozhraní API Podrobnosti o využití spotřeby.

Výhody migrace

Nová řešení poskytují mnoho výhod oproti rozhraní API Pro podrobnosti využití využití. Tady je souhrn:

  • Jedna datová sada pro všechny podrobnosti o využití – Podrobnosti o využití Azure a Azure Marketplace se sloučily do jedné datové sady. Snižuje počet rozhraní API, která potřebujete volat, abyste viděli všechny poplatky.
  • Škálovatelnost – Rozhraní API Marketplaces je zastaralé, protože podporuje model volání, který se s rostoucím využitím Azure nedokáže škálovat. Datová sada podrobností o využití může být při nasazování dalších prostředků do cloudu extrémně velká. Rozhraní API marketplace je stránkované synchronní rozhraní API, takže není optimalizované pro efektivní přenos velkých objemů dat přes síť s vysokou efektivitou a spolehlivostí. Exporty a rozhraní API podrobnosti o nákladech jsou asynchronní. Poskytují vám soubor CSV, který je možné stáhnout přímo přes síť.
  • Vylepšení rozhraní API – Exporty a rozhraní API pro podrobnosti o nákladech jsou řešení, která Azure podporuje v budoucnu. Všechny nové funkce se do nich integrují.
  • Konzistence schématu – Sestava Podrobnosti o nákladech a Exporty poskytují soubory s odpovídajícími poli, které můžete na základě vašeho scénáře přesouvat z jednoho řešení do druhého.
  • Integrace přidělování nákladů – smlouva Enterprise a Smlouva se zákazníkem Microsoftu zákazníci používající exporty nebo rozhraní API pro podrobnosti nákladů můžou zobrazit poplatky ve vztahu k nakonfigurovaným pravidlům alokace nákladů. Další informace o alokaci nákladů najdete v tématu Přidělení nákladů.

Rozdíly v polích

Následující tabulka shrnuje rozdíly v polích mezi rozhraním API Podrobnosti o využití spotřeby a rozhraním API exportů/podrobností nákladů. Exporty a rozhraní API pro podrobnosti nákladů poskytují místo stránkované odpovědi JSON, kterou poskytuje rozhraní API Consumption, stažení souboru CSV.

smlouva Enterprise mapování polí

smlouva Enterprise zákazníci, kteří používají rozhraní API Consumption Usage Details, mají záznamy s podrobnostmi o využití typu legacy. Níže je uvedený záznam podrobností o starší verzi. Všichni smlouva Enterprise zákazníci mají záznamy tohoto typu kvůli podkladovému fakturačnímu systému, který se pro ně používá.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

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

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

}

Úplný příklad staršího záznamu podrobností o využití se zobrazuje v části Podrobnosti o využití – Seznam – ROZHRANÍ REST API (Azure Consumption).

Následující tabulka obsahuje mapování mezi starým a novým polem. Nové vlastnosti jsou k dispozici v souborech CSV vytvořených exporty a rozhraním API podrobnosti o nákladech. Další informace o polích najdete v tématu Vysvětlení polí podrobností o využití.

Tučné názvy vlastností se nezmění.

Původní vlastnost Nová vlastnost
accountName AccountName
AccountOwnerId AccountOwnerId
additionalInfo AdditionalInfo
AvailabilityZone AvailabilityZone
billingAccountId Id fakturačního účtu
billingAccountName BillingAccountName
billingCurrency BillingCurrencyCode
billingPeriodEndDate BillingPeriodEndDate
billingPeriodStartDate BillingPeriodStartDate
billingProfileId BillingProfileId
billingProfileName BillingProfileName
chargeType ChargeType
consumedService ConsumedService
cost CostInBillingCurrency
costCenter CostCenter
date Datum
effectivePrice EffectivePrice (Platná cena)
frequency Frekvence
invoiceSection InvoiceSectionName
InvoiceSectionId InvoiceSectionId
isAzureCreditEligible IsAzureCreditEligible
meterCategory MeterCategory
meterId MeterId
meterName MeterName
MeterRegion MeterRegion
meterSubCategory MeterSubCategory
offerId OfferId (Id nabídky)
partNumber PartNumber
PayGPrice PayGPrice
PlanName PlanName
PricingModel PricingModel
product ProductName
Idobjednávky produktu ProductOrderId
ProductOrderName ProductOrderName
Název vydavatele Název vydavatele
PublisherType PublisherType
quantity Množství
Id rezervace ReservationId
Název rezervace ReservationName
resourceGroup ResourceGroup
resourceId ResourceId
resourceLocation ResourceLocation
resourceName ResourceName
serviceFamily ServiceFamily
ServiceInfo1 ServiceInfo1
ServiceInfo2 ServiceInfo2
subscriptionId SubscriptionId
subscriptionName SubscriptionName
Značky Značky
Pojem Období
unitOfMeasure UnitOfMeasure
unitPrice UnitPrice
CostAllocationRuleName CostAllocationRuleName

mapování polí Smlouva se zákazníkem Microsoftu

Smlouva se zákazníkem Microsoftu zákazníci, kteří používají rozhraní API Consumption Usage Details, mají záznamy s podrobnostmi o využití typu modern. Níže je uvedený záznam podrobností o moderním využití. Všichni Smlouva se zákazníkem Microsoftu zákazníci mají záznamy tohoto druhu kvůli podkladovému fakturačnímu systému, který se pro ně používá.

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

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

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

}

Úplný příklad staršího záznamu podrobností o využití se zobrazuje v části Podrobnosti o využití – Seznam – ROZHRANÍ REST API (Azure Consumption)

V následující tabulce je znázorněno mapování mezi starým a novým polem. Nové vlastnosti jsou k dispozici v souborech CSV vytvořených exporty a rozhraním API podrobnosti o nákladech. Pole, která potřebují mapování kvůli rozdílům v řešeních, se zobrazují tučným písmem.

Další informace najdete v tématu Vysvětlení polí podrobností o využití.

Stará vlastnost Nová vlastnost
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
date date
serviceFamily serviceFamily
productOrderId productOrderId
productOrderName productOrderName
consumedService consumedService
meterId meterId
meterName meterName
meterCategory meterCategory
meterSubCategory meterSubCategory
meterRegion meterRegion
productIdentifier Productid
Produktu ProductName
subscriptionGuid SubscriptionId
subscriptionName subscriptionName
publisherType publisherType
publisherId (ID vydavatele) publisherId (ID vydavatele)
publisherName publisherName
resourceGroup resourceGroupName
Název_instance ResourceId
resourceLocationNormalized Umístění
resourceLocation Umístění
effectivePrice effectivePrice
quantity quantity
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
tags tags
partnerEarnedCreditRate partnerEarnedCreditRate
partnerEarnedCreditApplied partnerEarnedCreditApplied
marketPrice PayGPrice
frequency frequency
Termín Termín
reservationId reservationId
reservationName reservationName
pricingModel pricingModel
unitPrice unitPrice
exchangeRatePricingToBilling exchangeRatePricingToBilling

Další kroky