Migrace z rozhraní API Podrobnosti využití consumption
Tento článek popisuje migraci mimo rozhraní API Podrobnosti využití consumption, které se plánuje pro vyřazení. Přesné datum vyřazení je stále určeno. Doporučujeme nevystavovat kanály generování sestav pomocí tohoto rozhraní API a co nejdříve z něj migrovat.
Rozhraní API pro generování sestav smlouva Enterprise (EA), která k ověřování používají klíč rozhraní API a ke kterým se přistupuje prostřednictvím koncového bodu consumption.azure.com identifikátoru URI, se vyřadí z provozu. Zákazníci se smlouvou ENTERPRISE, kteří používají tato rozhraní API, by měli migrovat do rozhraní API Cost Management Cost Details . Tato starší rozhraní API pro vytváření sestav EA jsou dostupná jenom zákazníkům s smlouva Enterprise.
Pokud používáte rozhraní API Podrobnosti o využití consumption, doporučujeme, ale nevyžadujete migraci do rozhraní API Podrobnosti nákladů služby Cost Management.
Rozhraní API služby Consumption a Cost Management jsou k dispozici pro zákazníky se smlouvou EA Smlouva se zákazníkem Microsoftu (MCA). Zákazníci azure Government, kteří zůstávají pod smlouvou EA, se tedy negativně nedotknou.
Při migraci z EA na MCA doporučujeme přejít z rozhraní API podrobností o využití EA do rozhraní API pro podrobnosti nákladů služby Cost Management a použít exporty.
Cíle migrace
Než zvolíte vhodné řešení pro vaši úlohu, přečtěte si článek Zvolit řešení s podrobnostmi o nákladech. Obecně doporučujeme exportovat , pokud máte průběžné potřeby příjmu dat nebo velkou datovou sadu s podrobnostmi o měsíčním využití. Další informace najdete v tématu Ingestování dat o využití.
Pokud máte menší datovou sadu podrobností o využití nebo scénář, který není splněn exportem, zvažte místo toho použití sestavy Podrobnosti nákladů . Další informace najdete v tématu Získání malých nákladových datových sad na vyžádání.
Poznámka:
Sestava Podrobnosti 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 pro podrobnosti využití consumption.
Výhody migrace
Nová řešení poskytují mnoho výhod oproti rozhraní API pro podrobnosti využití consumption. 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, aby se vám zobrazily všechny poplatky.
- Škálovatelnost – Rozhraní API Marketplaces je zastaralé, protože podporuje vzor volání, který není schopen škálovat při nárůstu využití Azure. Datová sada s podrobnostmi o využití může být při nasazování dalších prostředků do cloudu velká. Rozhraní API Marketplaces 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 nákladů jsou asynchronní. Poskytují vám soubor CSV, který se dá stáhnout přímo přes síť.
- Vylepšení rozhraní API – Exporty a rozhraní API pro podrobnosti nákladů jsou řešení, která podpora Azure posunu vpřed. Všechny nové funkce se do nich integrují.
- Konzistence schématu – Sestava Podrobnosti nákladů a Exporty poskytují soubory s odpovídajícími poli, které můžete v závislosti na vašem scénáři přesunout z jednoho řešení na druhé.
- Integrace alokace 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 zobrazovat poplatky ve vztahu k pravidlům přidělování nákladů, která nakonfigurovali. Další informace o přidělování 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í consumption a exportem a rozhraním API Podrobnosti nákladů. Exporty a rozhraní API pro podrobnosti nákladů poskytují soubor CSV místo stránkované odpovědi JSON, kterou poskytuje rozhraní CONSUMPTION API.
mapování polí smlouva Enterprise
smlouva Enterprise zákazníky, kteří používají rozhraní API podrobnosti o využití consumption, mají záznamy o využití typu legacy. Všichni smlouva Enterprise mají záznamy tohoto typu z důvodu základního fakturačního systému, který se pro ně používá. Tady je příklad záznamu s podrobnostmi o využití starší verze:
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "legacy",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Úplný příklad staršího záznamu Podrobnosti 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ými a novými poli. Nové vlastnosti jsou k dispozici v souborech CSV vytvořených exporty a rozhraním API Podrobnosti nákladů. Další informace o polích najdete v tématu Vysvětlení polí podrobností o využití.
Tučné názvy vlastností se nemění.
| Původní vlastnost | Nová vlastnost |
|---|---|
| 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 |
| cost | CostInBillingCurrency |
| costCenter | CostCenter |
| datum | Datum |
| effectivePrice | EffectivePrice (Platná cena) |
| frequency | Četnost |
| invoiceSection | InvoiceSectionName |
| InvoiceSectionId | InvoiceSectionId |
| isAzureCreditEligible | IsAzureCreditEligible |
| meterCategory | MeterCategory |
| meterId | ID měřiče |
| meterName | MeterName |
| MeterRegion | MeterRegion |
| meterSubCategory | MeterSubCategory |
| offerId | OfferId |
| partNumber | PartNumber |
| PayGPrice | PayGPrice |
| PlanName | PlanName |
| Cenový model | PricingModel |
| product | ProductName |
| ProductOrderId | ProductOrderId |
| ProductOrderName | ProductOrderName |
| Název vydavatele | Název vydavatele |
| Typ vydavatele | PublisherType |
| množství. | Množství |
| ReservationId | ReservationId |
| ReservationName | ReservationName |
| resourceGroup | ResourceGroup |
| resourceId | ResourceId |
| resourceLocation | ResourceLocation |
| resourceName: | ResourceName |
| serviceFamily | ServiceFamily |
| ServiceInfo1 | ServiceInfo1 |
| ServiceInfo2 | ServiceInfo2 |
| subscriptionId | SubscriptionId |
| subscriptionName | SubscriptionName |
| Značky | Značky |
| Období | 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 podrobnosti o využití consumption, mají záznamy o využití daného typu modern. Všichni Smlouva se zákazníkem Microsoftu mají záznamy tohoto typu z důvodu základního fakturačního systému, který se pro ně používá. Tady je příklad záznamu s podrobnostmi o využití MCA:
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "modern",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Úplný příklad staršího záznamu Podrobnosti o využití se zobrazuje v části Podrobnosti o využití – Seznam – ROZHRANÍ REST API (Azure Consumption)
Mapování mezi starými a novými poli je znázorněno v následující tabulce. Nové vlastnosti jsou k dispozici v souborech CSV vytvořených exporty a rozhraním API Podrobnosti nákladů. 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 |
| datum | datum |
| serviceFamily | serviceFamily |
| productOrderId | productOrderId |
| productOrderName | productOrderName |
| consumedService | consumedService |
| meterId | meterId |
| meterName | meterName |
| meterCategory | meterCategory |
| meterSubCategory | meterSubCategory |
| meterRegion | meterRegion |
| productIdentifier | Productid |
| výrobek | ProductName |
| subscriptionGuid | SubscriptionId |
| subscriptionName | subscriptionName |
| publisherType | publisherType |
| publisherId | publisherId |
| publisherName | publisherName |
| resourceGroup | resourceGroupName |
| instanceName | ResourceId |
| resourceLocationNormalized | location |
| resourceLocation | location |
| effectivePrice | effectivePrice |
| množství. | množství. |
| 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 |
| značky | značky |
| partnerEarnedCreditRate | partnerEarnedCreditRate |
| partnerEarnedCreditApplied | partnerEarnedCreditApplied |
| marketPrice | PayGPrice |
| frequency | frequency |
| semestr | semestr |
| reservationId | reservationId |
| reservationName | reservationName |
| cenový model | cenový model |
| unitPrice | unitPrice |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
Související obsah
- Další informace o automatizaci služby Cost Management a fakturace najdete v přehledu služby Cost Management Automation.