Price Sheet - Download By Billing Profile

Referentie

Service:: Cost Management

API-versie:: 2023-11-01

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

U kunt de nieuwe API-versie 2023-09-01 gebruiken voor factureringsperioden vanaf januari 2023. Prijzen voor gereserveerde instanties van Azure (RI) 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=2023-11-01

URI-parameters

Name In Vereist Type Description

billingAccountName

path

True

string

De id die een factureringsrekening uniek identificeert.

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 die een factureringsprofiel uniek identificeert.

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 geslaagd.

202 Accepted

Aanvaard.

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-stroom.

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=2023-11-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=2023-11-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 wordt opgegeven in het foutbericht. Enkele foutreacties: 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 net zolang hebt gewacht zoals aangegeven in de header 'Retry-After'.
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 wordt opgegeven in het foutbericht.

Enkele foutreacties:

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 net zolang hebt gewacht zoals aangegeven in de header 'Retry-After'.

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 gastart van de servicemeter als deze zich na aanmelding bevindt. Dit is van toepassing op Enterprise Agreement gebruikers
billingAccountID	string	Unieke identificatie voor het factureringsaccount.
billingAccountName	string	Naam van het factureringsprofiel dat is ingesteld om facturen te ontvangen. De prijzen op het prijzenoverzicht zijn gekoppeld aan dit factureringsprofiel.
billingCurrency	string	Valuta waarin kosten worden geboekt.
billingProfileId	string	Unieke identificatie voor het factureringsprofiel.
billingProfileName	string	Naam van het factureringsprofiel dat is ingesteld om facturen te ontvangen. De prijzen op het prijzenoverzicht zijn gekoppeld aan dit factureringsprofiel.
currency	string	Valuta waarin alle prijzen worden weergegeven.
effectiveEndDate	string	Ingangsdatum van de factureringsperiode van het prijzenoverzicht
effectiveStartDate	string	Ingangsdatum 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 Microsoft-overeenkomsttype. 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	De naam van de classificatiecategorie voor de meter. Bijvoorbeeld Cloudservices, Netwerken enz.
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	De naam van de subclassificatiecategorie voor de meter.
meterType	string	Naam van het metertype
priceType	string	Prijstype voor een product. Bijvoorbeeld een Azure-resource met een tarief voor betalen per gebruik met priceType als Verbruik. Andere prijstypen zijn ReservedInstance en Savings Plan.
product	string	Naam van het product waarop de kosten betrekking hebben.
productId	string	Unieke identificatie voor het product waarvan de meter wordt verbruikt.
serviceFamily	number	Type Azure-service. Bijvoorbeeld Compute, Analytics en Security.
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	Bepaalt de ondergrens van het categoriebereik waarvoor prijzen zijn vastgesteld. Als het bereik bijvoorbeeld 0 tot 100 is, is tierMinimumUnits 0.
unitOfMeasure	string	Hoe het gebruik voor de service wordt gemeten
unitPrice	string	De prijs per eenheid op het moment van facturering voor een bepaald product of een bepaalde service, 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 downloads van gebruiksgegevens wanneer services verschillende prijzen hebben in verschillende lagen. Als services een prijs met meerdere lagen hebben, is de effectieve prijs een gemengd tarief voor de verschillende lagen en wordt er geen prijs per laag per eenheid weergegeven. De gemengde prijs of werkelijke prijs is de nettoprijs voor de verbruikte hoeveelheid in de verschillende categorieën (waarbij elke categorie 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 wordt/verloopt in UTC, bijvoorbeeld 2020-12-08T05:55:59.4394737Z.