Price Sheet - Download By Billing Profile

Referentie

Service:: Cost Management

API-versie:: 2024-08-01

Hiermee haalt u een URL op om het prijzenoverzicht van de huidige maand voor een factureringsprofiel te downloaden. De bewerking wordt ondersteund voor factureringsaccounts met het overeenkomsttype Microsoft Partner-overeenkomst of Microsoft-klantovereenkomst.

U kunt de nieuwe API-versie 2023-09-01 gebruiken voor factureringsperioden van januari 2023 en hoger. Prijzen voor gereserveerde instanties (RI) van Azure zijn alleen beschikbaar via de nieuwe versie van de API.

Vanwege de groei van het Azure-product wordt de downloadervaring van het Azure-prijzenoverzicht in deze preview-versie bijgewerkt van één CSV-/json-bestand naar een Zip-bestand met meerdere CSV-/json-bestanden, elk met een maximale grootte van 75 MB.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

URI-parameters

Name In Vereist Type Description

billingAccountName

path

True

string

De id waarmee een factureringsrekening uniek wordt geïdentificeerd.

Regex-patroon: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}

billingProfileName

path

True

string

De id waarmee een factureringsprofiel uniek wordt geïdentificeerd.

Regex-patroon: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)

api-version

query

True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name

Type

Description

200 OK

PricesheetDownloadProperties

OK. De aanvraag is voltooid.

202 Accepted

Geaccepteerd.

Kopteksten

Location: string
Retry-After: string
OData-EntityId: string

Other Status Codes

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

PricesheetDownloadByBillingProfile

Voorbeeldaanvraag

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Voorbeeldrespons

Statuscode:: 202

Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2024-08-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000

Statuscode:: 200

{
  "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
  "expiryTime": "2018-07-21T17:32:28Z"
}

Definities

Name	Description
ErrorDetails	De details van de fout.
ErrorResponse	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht. Enkele foutberichten: 429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.
MCAPriceSheetProperties	De eigenschappen van het prijzenoverzicht.
PricesheetDownloadProperties	De URL voor het downloaden van het gegenereerde rapport.

ErrorDetails

De details van de fout.

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

ErrorResponse

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht.

Enkele foutberichten:

429 TooManyRequests - Aanvraag wordt beperkt. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable - Service is tijdelijk niet beschikbaar. Probeer het opnieuw nadat u hebt gewacht op de tijd die is opgegeven in de header 'Opnieuw proberen-na'.

Name	Type	Description
error	ErrorDetails	De details van de fout.

MCAPriceSheetProperties

De eigenschappen van het prijzenoverzicht.

Name	Type	Description
basePrice	string	De eenheidsprijs op het moment dat de klant zich aanmeldt of de eenheidsprijs op het moment van de ga-start van de servicemeter als deze zich na aanmelding bevindt. Dit is van toepassing op Enterprise Agreement-gebruikers
billingAccountID	string	Unieke id voor de factureringsrekening.
billingAccountName	string	Naam van het factureringsprofiel dat is ingesteld voor het ontvangen van facturen. De prijzen in het prijzenoverzicht zijn gekoppeld aan dit factureringsprofiel.
billingCurrency	string	Valuta waarin kosten worden geboekt.
billingProfileId	string	Unieke id voor het factureringsprofiel.
billingProfileName	string	Naam van het factureringsprofiel dat is ingesteld voor het ontvangen van facturen. De prijzen in het prijzenoverzicht zijn gekoppeld aan dit factureringsprofiel.
currency	string	Valuta waarin alle prijzen worden weerspiegeld.
effectiveEndDate	string	Effectieve einddatum van de factureringsperiode voor prijzenoverzichten
effectiveStartDate	string	Effectieve begindatum van de factureringsperiode van het prijzenoverzicht
marketPrice	string	De huidige catalogusprijs voor een bepaald product of een bepaalde service. Deze prijs is zonder onderhandelingen en is gebaseerd op uw Type Microsoft-overeenkomst. Voor PriceType Consumption wordt de marktprijs weergegeven als de prijs voor betalen per gebruik. Voor PriceType Savings Plan weerspiegelt de marktprijs het voordeel van het spaarplan boven op de prijs voor betalen per gebruik voor de bijbehorende toezeggingstermijn. Voor PriceType ReservedInstance weerspiegelt de marktprijs de totale prijs van de toezegging van 1 of 3 jaar.
meterCategory	string	Naam van de classificatiecategorie voor de meter. Bijvoorbeeld cloudservices, netwerken, enzovoort.
meterName	string	Naam van de meter. De meter vertegenwoordigt de implementeerbare resource van een Azure-service.
meterRegion	string	Naam van de Azure-regio waar de meter voor de service beschikbaar is.
meterSubCategory	string	Naam van de subclassificatiecategorie van de meter.
meterType	string	Naam van het metertype
priceType	string	Prijstype voor een product. Een Azure-resource met een betalen per gebruik-tarief met priceType als Verbruik. Andere prijstypen zijn ReservedInstance en Spaarplan.
product	string	Naam van het product met de kosten.
productId	string	Unieke id voor het product waarvan de meter wordt verbruikt.
productOrderName	string	Naam van het aangeschafte productabonnement. Geeft aan of deze prijzen standaard prijzen voor Azure Plan, Dev/Test-prijzen, enzovoort zijn. Momenteel niet beschikbaar voor Azure 3rd party- en ReservedInstance-meters.
serviceFamily	number	Type Azure-service. Bijvoorbeeld Compute, Analytics en Beveiliging.
skuId	string	Unieke id van de SKU
term	string	Termijnlengte voor Azure Savings Plan of Reserveringstermijn: één jaar of drie jaar (P1Y of P3Y)
tierMinimumUnits	string	Definieert de ondergrens van het categoriebereik waarvoor prijzen worden gedefinieerd. Als het bereik bijvoorbeeld 0 tot 100 is, is tierMinimumUnits 0.
unitOfMeasure	string	Hoe het gebruik wordt gemeten voor de service
unitPrice	string	De prijs per eenheid op het moment van facturering voor een bepaald product of een bepaalde dienst, inclusief eventuele overeengekomen kortingen boven op de marktprijs. Voor PriceType ReservedInstance weerspiegelt de eenheidsprijs de totale kosten van de toezegging van 1 of 3 jaar, inclusief kortingen. Opmerking: de eenheidsprijs is niet hetzelfde als de effectieve prijs in gebruiksgegevensdownloads wanneer services differentiële prijzen hebben in verschillende lagen. Als services een prijs met meerdere lagen hebben, is de effectieve prijs een gemengde prijs in de verschillende lagen en wordt er geen prijs per categorie weergegeven. De gemengde prijs of effectieve prijs is de nettoprijs voor de verbruikte hoeveelheid tussen de meerdere lagen (waarbij elke laag een specifieke eenheidsprijs heeft).

PricesheetDownloadProperties

De URL voor het downloaden van het gegenereerde rapport.

Name	Type	Description
downloadFileProperties	MCAPriceSheetProperties	De eigenschappen in het gedownloade bestand
downloadUrl	string	De URL voor het downloaden van het gegenereerde rapport.
expiryTime	string	Het tijdstip waarop de rapport-URL ongeldig/verloopt in UTC, bijvoorbeeld 2020-12-08T05:55:59.4394737Z.