Generate Cost Details Report - Create Operation
Ez az API az összes korábban kiadott Usage Details API lecserélése. Kérelem költségadatok jelentésének létrehozásához a megadott dátumtartományhoz, számlázási időszakhoz (csak vállalati ügyfelek) vagy számlaazonosítóhoz aszinkron módon egy adott hatókörben. A jelentés igénylésére irányuló kezdeti hívás egy 202-et ad vissza egy "Hely" és egy "Újrapróbálkozás után" fejléccel. A "Hely" fejléc biztosítja a lekérdezéshez szükséges végpontot a jelentésgenerálás eredményének lekéréséhez. Az "Újrapróbálkozás után" megadja a létrehozott jelentés lekérdezése előtti várakozás időtartamát. Ha a művelet még folyamatban van, a jelentésművelet lekérdezésére irányuló hívás egy 202-s választ ad egy "Hely" fejléccel. A jelentésgenerálási művelet befejeződése után a lekérdezési végpont 200 választ ad a letölthető jelentésblob(ok) részleteivel együtt. A letölthető fájl(ok) részletei a lekérdezési válasz törzsében lesznek elérhetők. A fájlokban található költségadatok (korábbi nevén használati adatok) megismeréséhez tekintse meg a https://learn.microsoft.com/en-us/azure/cost-management-billing/automate/understand-usage-details-fields
POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2026-06-01
URI-paraméterek
| Name | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
scope
|
path | True |
string |
Az előfizetés, a számlázási fiók vagy más számlázási hatókörök ARM-erőforrás-azonosítója. Jelenleg az erőforráscsoport és a felügyeleti csoport nem támogatott. További részletekért lásd: https://aka.ms/costmgmt/scopes. |
|
api-version
|
query | True |
string minLength: 1 |
A művelethez használni kívánt API-verzió. |
Kérelem törzse
| Name | Típus | Description |
|---|---|---|
| billingPeriod |
string |
Ezt a paramétert csak nagyvállalati szerződéssel rendelkező ügyfelek használhatják. Használja a YearMonth (pl. 202008) formátumot. Ez a paraméter sem a invoiceId, sem a timePeriod paraméter mellett nem használható. Ha a kérelem törzsében nincs megadva timePeriod, invoiceId vagy billingPeriod paraméter, az API az aktuális havi költséget adja vissza. |
| invoiceId |
string |
Ezt a paramétert csak Microsoft Ügyfélszerződés ügyfelek használhatják. Emellett csak a számlázási profilban vagy az ügyfél hatókörében használható. Ez a paraméter nem használható a billingPeriod vagy timePeriod paraméterekkel együtt. Ha a kérelem törzsében nincs megadva timePeriod, invoiceId vagy billingPeriod paraméter, az API az aktuális havi költséget adja vissza. |
| metric |
A részletes jelentés típusa. Alapértelmezés szerint az ActualCost meg van adva |
|
| timePeriod |
A jelentéshez kért költségadatok megadott dátumtartománya. Ez a paraméter sem a invoiceId, sem a billingPeriod paraméter mellett nem használható. Ha a kérelem törzsében nincs megadva timePeriod, invoiceId vagy billingPeriod paraméter, az API az aktuális havi költséget adja vissza. Az API csak 1 hónap vagy annál rövidebb, 13 hónapnál nem régebbi adatok lekérését teszi lehetővé. Ha nincs megadva timePeriod vagy billingPeriod vagy invoiceId, akkor az API alapértelmezés szerint a nyílt havi időszakra esik |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
Az Azure működése sikeresen befejeződött. |
|
| 202 Accepted |
Az erőforrásművelet elfogadott. Fejlécek Location: string |
|
| 204 No Content |
A kéréshez nincs elküldhető tartalom, de a fejlécek hasznosak lehetnek. |
|
| Other Status Codes |
Váratlan hibaválasz. |
Biztonság
azure_auth
Azure Active Directory Oauth2-folyamat.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
| Name | Description |
|---|---|
| user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
GenerateCostDetailsReportByBillingAccountEnterpriseAgreementCustomerAndBillingPeriod
Mintakérelem
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2026-06-01
{
"billingPeriod": "202205",
"metric": "ActualCost"
}
Mintaválasz
{
"name": "00000000-0000-0000-0000-000000000000",
"id": "/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
"manifest": {
"blobCount": 1,
"blobs": [
{
"blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
"byteCount": 32741
}
],
"byteCount": 32741,
"compressData": false,
"dataFormat": "Csv",
"manifestVersion": "2025-03-01",
"requestContext": {
"requestBody": {
"billingPeriod": "202205",
"metric": "ActualCost"
},
"requestScope": "providers/Microsoft.Billing/billingAccounts/12345"
}
},
"status": "Completed",
"validTill": "2022-05-10T08:08:46.1973252Z"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2025-03-01
Retry-After: 60
GenerateCostDetailsReportByBillingProfileAndInvoiceId
Mintakérelem
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2026-06-01
{
"invoiceId": "M1234567",
"metric": "ActualCost"
}
Mintaválasz
{
"name": "00000000-0000-0000-0000-000000000000",
"id": "/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
"manifest": {
"blobCount": 1,
"blobs": [
{
"blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
"byteCount": 32741
}
],
"byteCount": 32741,
"compressData": false,
"dataFormat": "Csv",
"manifestVersion": "2025-03-01",
"requestContext": {
"requestBody": {
"billingPeriod": "202205",
"metric": "ActualCost"
},
"requestScope": "providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579"
}
},
"status": "Completed",
"validTill": "2022-05-10T08:08:46.1973252Z"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/billingProfiles/13579/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2025-03-01
Retry-After: 60
GenerateCostDetailsReportByBillingProfileAndInvoiceIdAndCustomerId
Mintakérelem
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2026-06-01
{
"invoiceId": "M1234567",
"metric": "ActualCost"
}
Mintaválasz
{
"name": "00000000-0000-0000-0000-000000000000",
"id": "/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
"manifest": {
"blobCount": 1,
"blobs": [
{
"blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
"byteCount": 32741
}
],
"byteCount": 32741,
"compressData": false,
"dataFormat": "Csv",
"manifestVersion": "2025-03-01",
"requestContext": {
"requestBody": {
"billingPeriod": "202205",
"metric": "ActualCost"
},
"requestScope": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579"
}
},
"status": "Completed",
"validTill": "2022-05-10T08:08:46.1973252Z"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2025-03-01
Retry-After: 60
GenerateCostDetailsReportByCustomerAndTimePeriod
Mintakérelem
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2026-06-01
{
"metric": "ActualCost",
"timePeriod": {
"end": "2020-03-15",
"start": "2020-03-01"
}
}
Mintaválasz
{
"name": "00000000-0000-0000-0000-000000000000",
"id": "/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
"manifest": {
"blobCount": 1,
"blobs": [
{
"blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
"byteCount": 32741
}
],
"byteCount": 32741,
"compressData": false,
"dataFormat": "Csv",
"manifestVersion": "2025-03-01",
"requestContext": {
"requestBody": {
"metric": "ActualCost",
"timePeriod": {
"end": "2020-03-15",
"start": "2020-03-01"
}
},
"requestScope": "providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579"
}
},
"status": "Completed",
"validTill": "2022-05-10T08:08:46.1973252Z"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/12345:6789/customers/13579/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2025-03-01
Retry-After: 60
GenerateCostDetailsReportByDepartmentsAndTimePeriod
Mintakérelem
POST https://management.azure.com/providers/Microsoft.Billing/departments/12345/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2026-06-01
{
"metric": "ActualCost",
"timePeriod": {
"end": "2020-03-15",
"start": "2020-03-01"
}
}
Mintaválasz
{
"name": "00000000-0000-0000-0000-000000000000",
"id": "/providers/Microsoft.Billing/departments/12345/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
"manifest": {
"blobCount": 1,
"blobs": [
{
"blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
"byteCount": 32741
}
],
"byteCount": 32741,
"compressData": false,
"dataFormat": "Csv",
"manifestVersion": "2025-03-01",
"requestContext": {
"requestBody": {
"metric": "ActualCost",
"timePeriod": {
"end": "2020-03-15",
"start": "2020-03-01"
}
},
"requestScope": "providers/Microsoft.Billing/departments/12345"
}
},
"status": "Completed",
"validTill": "2022-05-10T08:08:46.1973252Z"
}
Location: https://management.azure.com/providers/Microsoft.Billing/departments/12345/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2025-03-01
Retry-After: 60
GenerateCostDetailsReportByEnrollmentAccountsAndTimePeriod
Mintakérelem
POST https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/1234/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2026-06-01
{
"metric": "ActualCost",
"timePeriod": {
"end": "2020-03-15",
"start": "2020-03-01"
}
}
Mintaválasz
{
"name": "00000000-0000-0000-0000-000000000000",
"id": "/providers/Microsoft.Billing/enrollmentAccounts/1234/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
"manifest": {
"blobCount": 1,
"blobs": [
{
"blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
"byteCount": 32741
}
],
"byteCount": 32741,
"compressData": false,
"dataFormat": "Csv",
"manifestVersion": "2025-03-01",
"requestContext": {
"requestBody": {
"metric": "ActualCost",
"timePeriod": {
"end": "2020-03-15",
"start": "2020-03-01"
}
},
"requestScope": "providers/Microsoft.Billing/enrollmentAccounts/1234"
}
},
"status": "Completed",
"validTill": "2022-05-10T08:08:46.1973252Z"
}
Location: https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/1234/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2025-03-01
Retry-After: 60
GenerateCostDetailsReportBySubscriptionAndTimePeriod
Mintakérelem
POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/generateCostDetailsReport?api-version=2026-06-01
{
"metric": "ActualCost",
"timePeriod": {
"end": "2020-03-15",
"start": "2020-03-01"
}
}
Mintaválasz
{
"name": "00000000-0000-0000-0000-000000000000",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
"manifest": {
"blobCount": 1,
"blobs": [
{
"blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
"byteCount": 32741
}
],
"byteCount": 32741,
"compressData": false,
"dataFormat": "Csv",
"manifestVersion": "2025-03-01",
"requestContext": {
"requestBody": {
"metric": "ActualCost",
"timePeriod": {
"end": "2020-03-15",
"start": "2020-03-01"
}
},
"requestScope": "subscriptions/00000000-0000-0000-0000-000000000000"
}
},
"status": "Completed",
"validTill": "2022-05-10T08:08:46.1973252Z"
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2025-03-01
Retry-After: 60
Definíciók
| Name | Description |
|---|---|
|
Blob |
A művelet által létrehozott blobadatok. |
|
Cost |
A jelentés adatformátuma |
|
Cost |
A részletes jelentés típusa. Alapértelmezés szerint az ActualCost meg van adva |
|
Cost |
A cost details Api hosszú ideig futó műveletének eredménye. |
|
Cost |
A költség részletei művelet állapota |
|
Cost |
A költségalapú jelentés adatainak lekérésének kezdő és záró dátuma. Az API csak 1 hónap vagy annál rövidebb, 13 hónapnál nem régebbi adatok lekérését teszi lehetővé. |
|
Error |
A hiba részletei. |
|
Generate |
A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg. Néhány hibaválasz:
|
|
Generate |
A részletes költségjelentés definíciója. |
BlobInfo
A művelet által létrehozott blobadatok.
| Name | Típus | Description |
|---|---|---|
| blobLink |
string |
A fájl letöltéséhez hivatkozzon a blobra. |
| byteCount |
integer (int64) |
Bájtok a blobban. |
CostDetailsDataFormat
A jelentés adatformátuma
| Érték | Description |
|---|---|
| Csv |
Csv adatformátum. |
CostDetailsMetricType
A részletes jelentés típusa. Alapértelmezés szerint az ActualCost meg van adva
| Érték | Description |
|---|---|
| ActualCost |
Tényleges költségadatok. |
| AmortizedCost |
Amortizált költségadatok. |
CostDetailsOperationResults
A cost details Api hosszú ideig futó műveletének eredménye.
| Name | Típus | Description |
|---|---|---|
| error |
A hiba részletei. |
|
| id |
string |
A hosszú ideig futó művelet azonosítója. |
| manifest.blobCount |
integer (int32) |
A blobok teljes száma. |
| manifest.blobs |
Blob |
A művelet által létrehozott blobadatok listája. |
| manifest.byteCount |
integer (int64) |
Az összes blob bájtjainak teljes száma. |
| manifest.compressData |
boolean |
Az adatok tömörített formátumban jelennek meg. |
| manifest.dataFormat |
A jelentés adatformátuma |
|
| manifest.manifestVersion |
string |
A Jegyzék verziója. |
| manifest.requestContext.requestBody |
A Költség részletei hívásban megadott hasznos adattörzs |
|
| manifest.requestContext.requestScope |
string |
A kérelem hatóköre. |
| name |
string |
A hosszú ideig futó művelet neve. |
| status |
A költség részletei művelet állapota |
|
| type |
string |
A hosszú ideig futó művelet típusa. |
| validTill |
string (date-time) |
A jelentés URL-címének érvénytelenné válásának/lejáratának időpontja UTC-ben(pl. 2020-12-08T05:55:59.4394737Z). |
CostDetailsStatusType
A költség részletei művelet állapota
| Érték | Description |
|---|---|
| Completed |
A művelet befejeződött. |
| NoDataFound |
A művelet befejeződött, és nem találhatók költségadatok. |
| Failed |
A művelet nem sikerült. |
CostDetailsTimePeriod
A költségalapú jelentés adatainak lekérésének kezdő és záró dátuma. Az API csak 1 hónap vagy annál rövidebb, 13 hónapnál nem régebbi adatok lekérését teszi lehetővé.
| Name | Típus | Description |
|---|---|---|
| end |
string |
Az adatok lekérésének záró dátuma. példaformátum 2020.03.15. |
| start |
string |
Az adatok lekérésének kezdő dátuma. példaformátum 2020.03.15. |
ErrorDetails
A hiba részletei.
| Name | Típus | Description |
|---|---|---|
| code |
string |
Hibakód. |
| message |
string |
A művelet sikertelen voltát jelző hibaüzenet. |
GenerateCostDetailsReportErrorResponse
A hibaválasz azt jelzi, hogy a szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.
Néhány hibaválasz:
400 Hibás kérelem – Érvénytelen kérelem hasznos adatai. A kérelem hasznos adatai nem JSON formátumban vannak megadva, vagy érvénytelen tagot nem fogadtak el a kérelem hasznos adatai között.
400 Hibás kérelem – Érvénytelen kérelem hasznos adata: csak timePeriod, invoiceId vagy billingPeriod lehet. Az API csak a timePeriod, a invoiceId vagy a billingPeriod adatok lekérését teszi lehetővé. Az ügyfélnek csak egy paramétert kell megadnia.
400 Hibás kérelem – A kezdési dátumnak utána kell lennie. Az API csak 13 hónapnál nem régebbi adatok lekérését teszi lehetővé.
400 Hibás kérelem – A maximálisan engedélyezett dátumtartomány 1 hónap. Az API csak 1 hónapig vagy annál rövidebb ideig engedélyezi az adatok lekérését.
429 TooManyRequests – A kérés szabályozva van. Próbálkozzon újra az "újrapróbálkozás után" fejlécben megadott időre való várakozás után.
503 ServiceUnavailable – A szolgáltatás átmenetileg nem érhető el. Próbálkozzon újra az "Újrapróbálkozás után" fejlécben megadott időre való várakozás után.
| Name | Típus | Description |
|---|---|---|
| error |
A hiba részletei. |
GenerateCostDetailsReportRequestDefinition
A részletes költségjelentés definíciója.
| Name | Típus | Description |
|---|---|---|
| billingPeriod |
string |
Ezt a paramétert csak nagyvállalati szerződéssel rendelkező ügyfelek használhatják. Használja a YearMonth (pl. 202008) formátumot. Ez a paraméter sem a invoiceId, sem a timePeriod paraméter mellett nem használható. Ha a kérelem törzsében nincs megadva timePeriod, invoiceId vagy billingPeriod paraméter, az API az aktuális havi költséget adja vissza. |
| invoiceId |
string |
Ezt a paramétert csak Microsoft Ügyfélszerződés ügyfelek használhatják. Emellett csak a számlázási profilban vagy az ügyfél hatókörében használható. Ez a paraméter nem használható a billingPeriod vagy timePeriod paraméterekkel együtt. Ha a kérelem törzsében nincs megadva timePeriod, invoiceId vagy billingPeriod paraméter, az API az aktuális havi költséget adja vissza. |
| metric |
A részletes jelentés típusa. Alapértelmezés szerint az ActualCost meg van adva |
|
| timePeriod |
A jelentéshez kért költségadatok megadott dátumtartománya. Ez a paraméter sem a invoiceId, sem a billingPeriod paraméter mellett nem használható. Ha a kérelem törzsében nincs megadva timePeriod, invoiceId vagy billingPeriod paraméter, az API az aktuális havi költséget adja vissza. Az API csak 1 hónap vagy annál rövidebb, 13 hónapnál nem régebbi adatok lekérését teszi lehetővé. Ha nincs megadva timePeriod vagy billingPeriod vagy invoiceId, akkor az API alapértelmezés szerint a nyílt havi időszakra esik |