Migrera från EA Price Sheet API
EA-kunder som tidigare använde Enterprise Reporting consumption.azure.com-API:et för att få prisdokumentet måste migrera till ett ersättnings-Azure Resource Manager-API. Följande instruktioner hjälper dig att migrera och de beskriver även eventuella kontraktsskillnader mellan det gamla API:et och det nya API:et.
Kommentar
Alla Azure Enterprise Reporting-API:er har dragits tillbaka. Du bör migrera till Microsoft Cost Management-API:er så snart som möjligt.
Tilldela behörigheter till ett huvudnamn för tjänsten för att anropa API:et
Innan du anropar API:et måste du konfigurera ett tjänsthuvudnamn (SPN) med rätt behörighet. Du använder tjänstens huvudnamn för att anropa API:et. Mer information finns i Tilldela behörigheter till Cost Management-API:er.
Anropa API för prisdokument
API:et Price Sheet genererar prisdokumentet asynkront och skapar en fil som du laddar ned.
Använd följande URI:er för begäran när du anropar det nya API:et för prisdokument:
Begäranden som stöds
Du kan anropa API:et med följande omfång:
Registrering: providers/Microsoft.Billing/billingAccounts/{billingAccountId}
Ladda ned efter faktureringskonto för den angivna faktureringsperioden
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01
POST-begäran returnerar en plats för att avsöka rapportens genereringsstatus enligt beskrivningen i följande svar:
Exempelsvar
Statuskod: 202
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
Retry-After: 60
Statuskod: 200
{
"status": "Completed",
"properties": {
"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",
"validTill": "2023-09-30T17:32:28Z"
}
}
Exempelbegäran för att kontrollera status för rapportgenerering
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
Ändringar i svarstext
[
{
"id": "enrollments/57354989/billingperiods/201601/products/343/pricesheets",
"billingPeriodId": "201704",
"meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
"meterName": "A1 VM",
"unitOfMeasure": "100 Hours",
"includedQuantity": 0,
"partNumber": "N7H-00015",
"unitPrice": 0.00,
"currencyCode": "USD"
},
{
"id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
"billingPeriodId": "201404",
"meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
"meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
"unitOfMeasure": "100 GB",
"includedQuantity": 0,
"partNumber": "N9H-00402",
"unitPrice": 0.00,
"currencyCode": "USD"
},
...
]
Nya svarsändringar
Egenskaperna för prisdokumentet är följande:
| Namn | Typ | Beskrivning |
|---|---|---|
| basePrice | sträng | Enhetspriset vid den tidpunkt då kunden loggar in eller enhetspriset vid tidpunkten för servicemätarens GA-start om det är efter inloggning. Det gäller för företagsavtal användare |
| currencyCode | sträng | Valuta där företagsavtal signerades |
| effectiveEndDate | sträng | Gällande slutdatum för faktureringsperioden för prisdokumentet |
| effectiveStartDate | sträng | Gällande startdatum för faktureringsperioden för prisdokumentet |
| enrollmentNumber | sträng | Unik identifierare för EA-faktureringskontot. |
| includedQuantity | sträng | Kvantiteter av en specifik tjänst som en EA-kund har rätt att använda utan inkrementella avgifter. |
| marketPrice | sträng | Det aktuella listpriset för en viss produkt eller tjänst. Det här priset är utan förhandlingar och baseras på din Microsoft-avtalstyp. För PriceType-förbrukning återspeglas marknadspriset som betala per användning-pris. För PriceType Savings Plan återspeglar marknadspriset förmånen för sparplanen utöver betala per användning-priset för motsvarande åtagandeperiod. För PriceType ReservedInstance återspeglar marknadspriset det totala priset för ett eller tre års åtagande. Obs! För EA-kunder utan förhandlingar kan marknadspriset avrundas till en annan decimalprecision än enhetspriset. |
| meterCategory | sträng | Namnet på mätarens klassificeringskategori. Det här kan till exempel vara Molntjänster eller Nätverk. |
| meterId | sträng | Unik identifierare för mätaren |
| meterName | sträng | Namnet på mätaren. Mätaren representerar den distribuerbara resursen för en Azure-tjänst. |
| meterRegion | sträng | Namnet på den Azure-region där mätaren för tjänsten är tillgänglig. |
| meterSubCategory | sträng | Namn på kategorin för mätarens underklassificering. |
| meterType | sträng | Namnet på mätartypen |
| partNumber | sträng | Delnummer som är associerat med mätaren |
| priceType | sträng | Pristyp för en produkt. Till exempel en Azure-resurs med ett betala per användning-pris med priceType som förbrukning. Andra pristyper är ReservedInstance och Sparplan. |
| produkt | sträng | Namnet på den produkt som ackumulerar avgifterna. |
| productId | sträng | Unik identifierare för produkten vars mätare förbrukas. |
| serviceFamily | Nummer | Typ av Azure-tjänst. Till exempel Compute, Analytics och Security. |
| skuId | sträng | Unik identifierare för SKU:n |
| Benämna | sträng | Tidslängd för Azure Savings Plan eller Reservation term – ett år eller tre år (P1Y eller P3Y) |
| unitOfMeasure | sträng | Hur användningen mäts för tjänsten |
| unitPrice | sträng | Priset per enhet vid tidpunkten för faktureringen för en viss produkt eller tjänst, inklusive eventuella förhandlade rabatter utöver marknadspriset. För PriceType ReservedInstance återspeglar enhetspriset den totala kostnaden för ett eller tre års åtagande, inklusive rabatter. Obs! Enhetspriset är inte detsamma som det effektiva priset i nedladdningar av användningsinformation när tjänsterna har olika priser på olika nivåer. Om tjänsterna är priser med flera nivåer är det effektiva priset en blandad ränta mellan nivåerna och visar inte ett nivåspecifikt enhetspris. Det blandade priset eller det effektiva priset är nettopriset för den förbrukade kvantiteten och sträcker sig över flera nivåer (där varje nivå har ett visst enhetspris). |