Migrace z rozhraní API podrobností o využití EA
Zákazníci EA, kteří dříve používali rozhraní API podnikového generování sestav za koncovým bodem consumption.azure.com , aby získali podrobnosti o využití a poplatky za marketplace, musí migrovat na nová a vylepšená řešení. Níže jsou uvedeny pokyny spolu s rozdíly mezi kontrakty mezi starým rozhraním API a novými řešeními.
Datová sada se místo podrobností o využití označuje jako podrobnosti o nákladech.
Poznámka:
Všechna rozhraní API pro podnikové vytváření sestav Azure se vyřadí z důchodu. Co nejdříve byste měli migrovat na rozhraní API služby Microsoft Cost Management.
Obecně dostupná nová řešení
Následující tabulka obsahuje souhrn cílů migrace, které jsou k dispozici, spolu se souhrnem toho, co je potřeba vzít v úvahu při výběru nejvhodnějšího řešení.
| Řešení | Popis | Požadavky | Informace o onboardingu |
|---|---|---|---|
| Exporty | Opakované výpisy dat do úložiště podle plánu | – Nejš škálovatelné řešení pro vaše úlohy. – Je možné nakonfigurovat použití dělení souborů pro větší datové sady. - Skvělé pro vytvoření a růst nákladové datové sady, které je možné integrovat s vlastními dotazovatelnými úložišti dat. –Vyžaduje přístup k účtu úložiště, který může uchovávat data. |
- Konfigurace na webu Azure Portal Automatizace vytváření exportů pomocí rozhraní API - Referenční informace k rozhraní API pro export |
| Rozhraní API pro podrobnosti nákladů | Stažení na vyžádání | - Užitečné pro malé nákladové datové sady. – Užitečné pro scénáře, kdy exporty do úložiště Azure nejsou možné kvůli obavám z hlediska zabezpečení nebo správy. |
- Získání malých nákladových datových sad na vyžádání - Rozhraní API pro podrobnosti nákladů |
Obecně doporučujeme používat exporty , pokud máte průběžné potřeby příjmu dat nebo velkou datovou sadu s podrobnostmi o měsíčních nákladech. Další informace najdete v tématu Ingestování dat podrobností o nákladech. Pokud potřebujete další informace, které vám pomůžou při rozhodování o úloze, přečtěte si téma Volba řešení s podrobnostmi o nákladech.
Přiřazení oprávnění hlavnímu názvu služby pro volání rozhraní API
Pokud chcete volat rozhraní API exportů nebo podrobností nákladů prostřednictvím kódu programu, musíte instanční objekt nakonfigurovat se správným oprávněním. Další informace najdete v tématu Přiřazení oprávnění k rozhraním API služby ACM.
Vyhněte se rozhraní API Microsoft Consumption Usage Details
Rozhraní API Podrobnosti využití consumption je další koncový bod, který aktuálně podporuje zákazníky se smlouvou ENTERPRISE. Do tohoto rozhraní API nemigrujte. Migrujte na exporty nebo rozhraní API podrobnosti nákladů, jak je popsáno výše v tomto dokumentu. Rozhraní API Podrobnosti využití consumption bude v budoucnu zastaralé a nachází se za následujícím koncovým bodem.
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01
Toto rozhraní API je synchronní koncový bod a nebude se moct škálovat jak vaše útrata, tak i velikost měsíční datové sady nákladů. Pokud aktuálně používáte rozhraní API Podrobnosti o využití consumption, doporučujeme ji co nejdříve migrovat na některý z exportů rozhraní API pro podrobnosti nákladů. Formální oznámení o vyřazení se provede k budoucímu datu. Další informace o migraci z podrobností o využití consumption najdete v tématu Migrace z rozhraní API Podrobnosti o využití consumption.
Výhody migrace
Naše nová řešení poskytují mnoho výhod oproti rozhraním API pro podrobnosti využití sestav EA. Tady je souhrn:
- Zabezpečení a stabilita – Pro přístup k datům vyžadují nová řešení instanční objekt nebo tokeny uživatele. Jsou bezpečnější než klíče rozhraní API, které se používají k ověřování v rozhraních API pro generování sestav EA. Klíče v těchto starších rozhraních API jsou platné šest měsíců a můžou v případě úniku citlivých finančních dat vystavit citlivá finanční data. Kromě toho platí, že pokud se klíče neprodloužily a integrovaly do úloh před vypršením jejich šestiměsíční platnosti, přístup k datům se odvolá. Tím se přeruší úlohy zákazníků.
- Škálovatelnost – Rozhraní API pro generování sestav EA nejsou vytvořená tak, aby se škálovat a vaše využití Azure se zvyšuje. Datová sada s podrobnostmi o využití se může při nasazování dalších prostředků do cloudu dostat nadlimitně. Nová řešení jsou asynchronní a mají za sebou rozsáhlá vylepšení infrastruktury, aby se zajistilo úspěšné stahování pro libovolnou datovou sadu velikostí.
- Jedna datová sada pro všechny podrobnosti o využití – Podrobnosti o využití Azure a Azure Marketplace byly sloučeny do jedné datové sady v nových řešeních. Jedna datová sada snižuje počet rozhraní API, která potřebujete volat, aby se zobrazily všechny poplatky.
- Nákup amortizace – Zákazníci, kteří si kupují rezervace, můžou zobrazit amortizované zobrazení nákladů pomocí nových řešení.
- Konzistence schématu – Každé dostupné řešení poskytuje soubory s odpovídajícími poli. Díky tomu můžete snadno přecházet mezi řešeními na základě vašeho scénáře.
- Integrace alokace nákladů – smlouva Enterprise a Smlouva se zákazníkem Microsoftu zákazníci můžou nové řešení použít k zobrazení poplatků ve vztahu k pravidlům alokace nákladů, která nakonfigurovali. Další informace o přidělování nákladů najdete v tématu Přidělení nákladů.
- Další vylepšení – nová řešení se aktivně vyvíjejí vpřed. Po vydání řešení obdrží všechny nové funkce.
Rozhraní API podnikového využití, která se mají migrovat
Následující tabulka shrnuje různá rozhraní API, která možná dnes používáte k příjmu dat podrobností o nákladech. Pokud používáte jedno z následujících rozhraní API, musíte migrovat na jedno z nových řešení popsaných dříve. Všechna rozhraní API jsou za https://consumption.azure.com koncovým bodem.
| Koncový bod | Komentáře rozhraní API |
|---|---|
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} |
– Metoda rozhraní API: GET – Synchronní (bez dotazování) – Formát dat: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 |
– Metoda rozhraní API: GET – Synchronní (bez dotazování) – Formát dat: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails |
– Metoda rozhraní API: GET – Synchronní (bez dotazování) – Formát dat: JSON |
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails |
– Metoda rozhraní API: GET – Synchronní (bez dotazování) – Formát dat: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 |
– Metoda rozhraní API: GET – Synchronní (bez dotazování) – Formát dat: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} |
– Metoda rozhraní API: POST – asynchronní (založené na dotazování) – Formát dat: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 |
– Metoda rozhraní API: POST – asynchronní (založené na dotazování) – Formát dat: CSV |
Mapování datových polí
Následující tabulka obsahuje souhrn starých polí dostupných v řešeních, která aktuálně používáte, spolu s polem, které se má použít v nových řešeních.
| Staré pole | Nové pole | Komentáře |
|---|---|---|
| accountId | ||
| accountName | AccountName | |
| accountOwnerEmail | AccountOwnerId | |
| additionalInfo | AdditionalInfo | |
| chargesBilledSeparately | isAzureCreditEligible | Vlastnosti jsou opačné. Pokud isAzureCreditEnabled je hodnota true, ChargesBilledSeparately byla by false. |
| consumedQuantity | Množství | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService | consumedServiceId poskytuje pouze číselnou hodnotu.ConsumedService poskytuje název služby. |
| cost | CostInBillingCurrency | |
| costCenter | CostCenter | |
| datum | Datum | Formát ve starém poli byl rrrr-mm-dd, zatímco nové pole je ve formátu mm/dd/rrrr. |
| departmentId | InvoiceSectionId | |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | Pokud je to možné, použijte a Frequency Term fields hýbá se vpřed. |
|
| location | ResourceLocationNormalized | |
| meterCategory | MeterCategory | |
| meterId | ID měřiče | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| orderNumber | Není k dispozici. | |
| partNumber | PartNumber | |
| planName | PlanName | |
| product | ProductName | |
| publisherName | Název vydavatele | |
| resourceGroup | ResourceGroup | |
| resourceGuid | ID měřiče | Hodnoty se liší. resourceGuid je hodnota GUID. meterId je dlouhé číslo. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | Není k dispozici. | |
| resourceRate | EffectivePrice (Platná cena) | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| serviceName | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | Není k dispozici. | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| značky | Značky | Nové pole neobsahuje ohraničení {} párů klíč-hodnota. |
| unitOfMeasure | UnitOfMeasure |