Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
U kunt Cost Management-automatisering gebruiken om een aangepaste set oplossingen te maken waarmee kostengegevens kunnen worden opgehaald en beheerd. In dit artikel worden algemene scenario's voor Cost Management-automatisering en beschikbare opties op basis van uw situatie behandeld. Als u wilt ontwikkelen met behulp van API's, worden voorbeelden van veelvoorkomende API-aanvragen weergegeven om uw ontwikkelproces te versnellen.
Ophalen van kostengegevens automatiseren voor offline analyse
Mogelijk moet u uw Azure-kostengegevens downloaden om deze samen te voegen met andere gegevenssets. Of u moet kostengegevens integreren in uw eigen systemen. Er zijn verschillende opties beschikbaar, afhankelijk van de hoeveelheid betrokken gegevens. U moet beschikken over Cost Management-machtigingen op het juiste bereik om API's en tools te kunnen gebruiken. Zie Toegang tot gegevens toewijzen voor meer informatie.
Suggesties voor het verwerken van grote gegevenssets
Als uw organisatie over een uitgebreide Azure-omgeving beschikt met veel resources en abonnementen, hebt u een groot aantal gebruiksgegevens. Excel kan vaak niet zulke grote bestanden laden. In deze situatie worden de volgende opties aanbevolen:
Power BI
Power BI wordt gebruikt om grote hoeveelheden gegevens op te nemen en af te handelen. Als u een Enterprise Agreement-klant bent, kunt u de Power BI-sjabloon-app gebruiken om de kosten voor uw factureringsaccount te analyseren. Het rapport bevat belangrijke inzichten die door klanten worden gebruikt. Kijk voor meer informatie naar Azure-kosten analyseren met de Power BI-sjabloon-app.
Power BI-gegevensconnector
Als u uw gegevens dagelijks wilt analyseren, kunt u het beste de Power BI-gegevensconnector gebruiken om gegevens op te halen voor gedetailleerde analyse. De connector houdt de rapporten actueel naarmate de kosten oplopen.
Cost Management exporten
Mogelijk hoeft u de gegevens niet dagelijks te analyseren. Als dit wel het geval is, kunt u de functie Exports van Cost Management gebruiken om gegevensexports naar een Azure Storage-account te plannen. Vervolgens kunt u de gegevens naar Power BI laden of in Excel analyseren als het bestand klein genoeg is. Exports zijn beschikbaar in Azure Portal of u kunt exports configureren met de Exports-API.
API voor kostendetails
Overweeg het gebruik van de API voor kostendetails als u een gegevensset met kleine kosten hebt. Hier volgen aanbevolen beste praktijken:
- Als u de meest recente kostengegevens wilt ophalen, raden we u aan om maximaal één keer per dag een query uit te voeren. Rapporten worden elke vier uur vernieuwd. Als u vaker belt, ontvangt u identieke gegevens.
- Zodra u uw kostengegevens voor historische facturen hebt gedownload, worden de kosten niet verwacht te veranderen, tenzij u expliciet op de hoogte wordt gesteld. We raden u aan uw kostengegevens in een querybare opslag op te slaan om herhaalde aanroepen voor identieke gegevens te voorkomen.
- Deel uw aanroepen in kleine datumbereiken om meer beheerbare bestanden te krijgen die u kunt downloaden. We raden u bijvoorbeeld aan te segmenteren op dag of per week als u grote Azure-gebruiksbestanden maandelijks hebt.
- Als u bereiken hebt met een grote hoeveelheid kostengegevens (bijvoorbeeld een factureringsaccount), kunt u overwegen om meerdere aanroepen naar onderliggende bereiken te plaatsen, zodat u beter beheerbare bestanden krijgt die u kunt downloaden.
- Als uw gegevensset meer dan 2 GB per maand is, kunt u overwegen om exports te gebruiken als een schaalbare oplossing.
Geautomatiseerd ophalen met de API voor kostendetails
De API voor kostendetails stelt u in staat om via programmering gedetailleerde, niet-geaggregeerde kostengegevens te genereren en te downloaden voor uw factuuraccount in het kader van de Enterprise Agreement (EA) of Microsoft Klantovereenkomst (MCA). In tegenstelling tot de verouderde API voor gebruiksgegevens is de API voor kostendetails asynchroon en op rapporten gebaseerd: u verzendt een aanvraag voor het genereren van een rapport, peilt naar de voltooiing en downloadt vervolgens het resulterende bestand van een beveiligde URL.
Belangrijk
De API voor kostendetails wordt alleen ondersteund voor MCA-bereiken (Enterprise Agreement) of Microsoft-klantovereenkomst. Voor andere accounttypen wordt u aangeraden Exports te gebruiken. Als u kleine gegevenssets wilt downloaden en u Azure Storage niet wilt gebruiken, kunt u ook de API verbruiksdetails gebruiken. Bekijk hier instructies voor hoe u dit doet
Hoe de API voor kostendetails werkt
- Een rapport maken: Dien een POST-aanvraag in bij de API Kostendetails die het bereik, het datumbereik en optionele filters (zoals meter, resource of tag) specificeert.
- Poll for status: De API retourneert een bewerkings-id. Controleer het eindpunt van de bewerkingsstatus totdat het rapport is voltooid.
- Download het rapport: zodra het rapport gereed is, biedt de API een beveiligde download-URL voor het CSV-bestand met uw kostengegevens. De downloadkoppeling is gedurende een beperkte periode geldig.
Zie Kleine gebruiksgegevenssets op aanvraag ophalen en de API-referentie voor kostendetails voor volledige details.
Voorbeeld: Een rapport met kostendetails genereren en downloaden
Voer de volgende stappen uit om kostendetails op te halen met behulp van de API kostendetails:
Stap 1: Een rapport maken
Dien een POST-aanvraag in om het genereren van rapporten te starten. Vervang {scope}
door uw factureringsaccount of profielspecificatie.
POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2025-03-01
Content-Type: application/json
{
"metric": "ActualCost",
"timePeriod": {
"start": "2025-03-01",
"end": "2025-03-15"
}
}
Het antwoord bevat een Location
header in het antwoord dat de polling-koppeling bevat die in stap 2 moet worden gebruikt.
Stap 2: Peiling naar status
Controleer de status van de rapportgeneratie via de pollinglink:
GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/generateCostDetailsReport/{operationId}?api-version=2025-03-01
Wanneer het rapport gereed is, bevat het antwoord een blobLink
eigenschap.
Stap 3: Het rapport downloaden
Gebruik het blobLink
bestand om het CSV-bestand met uw kostengegevens te downloaden.
Notitie
De API voor kostendetails is asynchroon. U kunt geen kostendetails rechtstreeks ophalen met een GET-aanvraag naar /generateCostDetailsReport
. Gebruik altijd de werkstroom voor het genereren van rapporten die hierboven wordt beschreven. Raadpleeg de documentatie van de Cost Details API voor meer informatie.
Aanbevolen procedures voor het gebruik van de API voor kostendetails
- Aanvraagfrequentie: We raden aan dat rapporten niet meer dan één keer per dag worden gegenereerd voor een bepaald bereik en datumbereik. Kostengegevens worden elke vier uur vernieuwd, maar frequentere aanvragen retourneren dezelfde gegevens en kunnen worden beperkt.
- Datumbereik: Voor grote gegevenssets beperkt u het datumbereik (bijvoorbeeld dagelijkse of wekelijkse rapporten genereren) om de bestandsgrootten beheerbaar te houden.
- Bereik: Gebruik het bereik op het hoogste niveau (zoals een factureringsaccount of factureringsprofiel) om het aantal API-aanroepen te minimaliseren en de volledigheid van de gegevens te waarborgen.
- Gegevensretentie: Download en sla onmiddellijk rapporten op. De download-URL verloopt na een korte periode (meestal één uur).
Opmerkingen over prijzen en gegevens
- De API kostendetails biedt werkelijke en afgeschreven kostengegevens, inclusief alle gebruik, aankopen en restituties voor de geselecteerde periode.
- De gegevens zijn niet samengevoegd en geschikt voor gedetailleerde analyse, afstemming en integratie met andere systemen.
- Zie Prijsgedrag in kostendetails voor meer informatie over prijsgedrag.
Eén resource kan meerdere records voor één dag hebben
Azure-resourceproviders kunnen gebruik en kosten verzenden naar het factureringssysteem met verschillende kenmerken (zoals datacenterlocatie), wat resulteert in meerdere records voor een resource op één dag. Dit gedrag wordt verwacht en geeft geen overbelasting aan; alle records samen vertegenwoordigen de volledige kosten voor die resource en dag.
Waarschuwingen en acties automatiseren met budgetten
Er zijn twee essentiële onderdelen om de waarde van uw investering in de cloud te maximaliseren. Eén daarvan is het automatisch maken van een budget. Het andere is het configureren van kosten-gebaseerde orkestratie in reactie op budgetwaarschuwingen. Er zijn verschillende manieren om het maken van budget te automatiseren. Er vinden verscheidene waarschuwingsreacties plaats wanneer uw geconfigureerde waarschuwingsdrempels worden overschreden.
In de volgende secties worden beschikbare opties behandeld en voorbeelden van API-aanvragen gegeven om u aan de slag te laten gaan met budgetautomatisering.
Hoe kosten worden geëvalueerd ten opzichte van uw budgetdrempel
Uw kosten worden eenmaal per dag geëvalueerd ten opzichte van uw budgetdrempel. Wanneer u een nieuw budget maakt of op de dag dat uw budget opnieuw wordt ingesteld, zullen de kosten vergeleken met de drempel nul zijn, omdat de evaluatie mogelijk nog niet heeft plaatsgevonden.
Wanneer Azure detecteert dat uw kosten de drempel hebben overschreden, wordt er binnen een uur na de detectieperiode een melding geactiveerd.
Uw huidige kosten bekijken
Als u uw huidige kosten wilt bekijken, moet u een GET-aanroep doen met behulp van de Query-API.
Een GET-aanroep bij de API voor budgetten zal niet de huidige kosten retourneren die in Kostenanalyse worden weergegeven. In plaats daarvan retourneert de aanroep uw laatst geëvalueerde kosten.
Het maken van een budget automatiseren
U kunt het maken van een budget automatiseren met behulp van de API voor budgetten. U kunt ook een budget maken met een budgetsjabloon. Sjablonen zijn een gemakkelijke manier voor u om Azure-implementaties te standaardiseren terwijl u verzekert dat kostenbeheer goed wordt geconfigureerd en afgedwongen.
Ondersteunde talen voor e-mails voor budgetwaarschuwingen
Met budgetten wordt u gewaarschuwd als u een bepaalde drempelwaarde overschrijdt. U kunt maximaal vijf e-mailontvangers per budget instellen. Ontvangers ontvangen de e-mailwaarschuwingen binnen 24 uur nadat de budgetdrempelwaarde is overschreden. Het kan echter zijn dat uw ontvanger een e-mail in een andere taal moet ontvangen. U kunt de volgende taalcultuurcodes gebruiken met de Budget-API. Stel de cultuurcode in met de parameter locale
, zoals in het volgende voorbeeld.
{
"eTag": "\"1d681a8fc67f77a\"",
"properties": {
"timePeriod": {
"startDate": "2020-07-24T00:00:00Z",
"endDate": "2022-07-23T00:00:00Z"
},
"timeGrain": "BillingMonth",
"amount": 1,
"currentSpend": {
"amount": 0,
"unit": "USD"
},
"category": "Cost",
"notifications": {
"actual_GreaterThan_10_Percent": {
"enabled": true,
"operator": "GreaterThan",
"threshold": 20,
"locale": "en-us",
"contactEmails": [
"user@contoso.com"
],
"contactRoles": [],
"contactGroups": [],
"thresholdType": "Actual"
}
}
}
}
Talen die worden ondersteund door een cultuurcode:
Cultuurcode | Taal |
---|---|
nl | Engels (Verenigde Staten) |
ja-jp | Japans (Japan) |
zh-cn | Chinees (vereenvoudigd, China) |
de-de | Duits (Duitsland) |
es-es | Spaans (Spanje, internationaal) |
fr-fr | Frans (Frankrijk) |
it-it | Italiaans (Italië) |
ko-kr | Koreaans (Korea) |
pt-br | Portugees (Brazilië) |
ru-ru | Russisch (Rusland) |
zh-tw | Chinees (Traditioneel, Taiwan) |
cs-cz | Tsjechisch (Tsjechische Republiek) |
pl-pl | Pools (Polen) |
tr-tr | Turks (Turkije) |
da-dk | Deens (Denemarken) |
en-gb | Engels (Verenigd Koninkrijk) |
hu-hu | Hongaars (Hongarije) |
nb-no | Noors Bokmål (Noorwegen) |
nl-nl | Nederlands (Nederland) |
pt-pt | Portugees (Portugal) |
sv-se | Zweeds (Zweden) |
Algemene configuraties van de API voor budgetten
Er zijn vele manieren om een budget te configureren in uw Azure-omgeving. Overweeg eerst uw scenario en identificeer vervolgens de configuratieopties die het mogelijk maken. Controleer de volgende opties:
- Tijdseenheid: Vertegenwoordigt de herhalende periode die uw budget gebruikt om kosten te verzamelen en evalueren. De meest algemene opties zijn Maandelijks, Driemaandelijks en Jaarlijks.
- Tijdsperiode: Vertegenwoordigt hoelang uw budget geldig is. Het budget bewaakt actief en waarschuwt u alleen terwijl het geldig is.
-
Meldingen
- Contact-e-mails: De e-mailadressen ontvangen waarschuwingen wanneer een budget kosten maakt en gedefinieerde drempels overschrijdt.
- Contactrollen: Alle gebruikers die een overeenkomende Azure-rol in het opgegeven bereik hebben, ontvangen e-mailwaarschuwingen met deze optie. Abonnementseigenaren kunnen bijvoorbeeld een waarschuwing ontvangen voor een budget dat op subscriptieniveau is gemaakt.
- Contactgroepen: Het budget roept de geconfigureerde actiegroepen aan wanneer een waarschuwingsdrempel wordt overschreden.
- Kostendimensiefilters: Voor uw budget kunt u dezelfde filters gebruiken als die u in Kostenanalyse of de Query-API gebruikt. Gebruik dit filter om het bereik te verkleinen van de kosten die u met het budget bewaakt.
Nadat u de opties voor het maken van een budget hebt geïdentificeerd die aan uw behoeften voldoen, maakt u het budget met behulp van de API. Het onderstaande voorbeeld helpt u aan de slag te gaan met een algemene budgetconfiguratie.
Een budget maken dat is gefilterd op meerdere resources en tags
Aanvraag-URL: PUT https://management.azure.com/subscriptions/{SubscriptionId} /providers/Microsoft.Consumption/budgets/{BudgetName}/?api-version=2019-10-01
{
"eTag": "\"1d34d016a593709\"",
"properties": {
"category": "Cost",
"amount": 100.65,
"timeGrain": "Monthly",
"timePeriod": {
"startDate": "2017-10-01T00:00:00Z",
"endDate": "2018-10-31T00:00:00Z"
},
"filter": {
"and": [
{
"dimensions": {
"name": "ResourceId",
"operator": "In",
"values": [
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{meterName}",
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{meterName}"
]
}
},
{
"tags": {
"name": "category",
"operator": "In",
"values": [
"Dev",
"Prod"
]
}
},
{
"tags": {
"name": "department",
"operator": "In",
"values": [
"engineering",
"sales"
]
}
}
]
},
"notifications": {
"Actual_GreaterThan_80_Percent": {
"enabled": true,
"operator": "GreaterThan",
"threshold": 80,
"contactEmails": [
"user1@contoso.com",
"user2@contoso.com"
],
"contactRoles": [
"Contributor",
"Reader"
],
"contactGroups": [
"/subscriptions/{subscriptionID}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
],
"thresholdType": "Actual"
}
}
}
}
Op kosten gebaseerde indeling configureren voor budgetwaarschuwingen
U kunt budgetten configureren om geautomatiseerde acties te starten met behulp van Azure-actiegroepen. Zie Automation met budgetten voor meer informatie over het automatiseren van acties met behulp van budgetten.
Gegevenslatentie en frequentielimieten
Het is raadzaam de API's niet vaker dan één keer per dag aan te roepen. Cost Management-gegevens worden elke vier uur vernieuwd, wanneer nieuwe gebruiksgegevens van Azure-resourceproviders worden ontvangen. Er komen niet meer gegevens vrij als de API vaker wordt aangeroepen. In plaats daarvan wordt de belasting groter.
Query-API-queryverwerkingseenheden
Naast de bestaande processen voor snelheidsbeperking beperkt de Query-API ook de verwerking op basis van de kosten van API-aanroepen. De kosten van een API-aanroep worden uitgedrukt als QPU's (queryverwerkingseenheden). QPU is een prestatievaluta, zoals Cosmos DB-RU's. Ze abstraheren systeembronnen zoals CPU en geheugen.
QPU-berekening
Op dit moment wordt één QPU in mindering gebracht voor één maand aan gegevens die zijn opgevraagd uit de toegewezen quota. Deze logica kan zonder kennisgeving worden gewijzigd.
QPU-factoren
De volgende factor is van invloed op het aantal QPU's dat wordt gebruikt door een API-aanvraag.
- Datumbereik, naarmate het datumbereik in de aanvraag toeneemt, neemt het aantal verbruikte QPU's toe.
Andere QPU-factoren kunnen zonder kennisgeving worden toegevoegd.
QPU-quota
De volgende quota worden per tenant geconfigureerd. Aanvragen worden beperkt wanneer een van de volgende quota is uitgeput.
- 12 QPU per 10 seconden
- 60 QPU per 1 minuut
- 600 QPU per 1 uur
De quota kunnen indien nodig worden gewijzigd en er kunnen meer quota worden toegevoegd.
Antwoordheaders
U kunt de antwoordheaders onderzoeken om het aantal QPU's bij te houden dat wordt gebruikt door een API-aanvraag en het aantal resterende QPU's.
x-ms-ratelimit-microsoft.costmanagement-qpu-retry-after
Geeft de tijd aan om in seconden te pauzeren. Wanneer een aanvraag wordt beperkt met 429, moet u voor de in deze header opgegeven tijd wachten voordat u de aanvraag opnieuw probeert uit te voeren.
x-ms-ratelimit-microsoft.costmanagement-qpu-consumed
QPUs die worden gebruikt door een API-aanroep.
x-ms-ratelimit-microsoft.costmanagement-qpu-remaining
Lijst met resterende quota.
Gerelateerde inhoud
- Azure-kosten analyseren met de Power BI-sjabloon-app.
- Geëxporteerde gegevens maken en beheren met Exports.
- Meer informatie over de API voor kostendetails.