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

CostDetailsMetricType

A részletes jelentés típusa. Alapértelmezés szerint az ActualCost meg van adva

timePeriod

CostDetailsTimePeriod

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

CostDetailsOperationResults

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

GenerateCostDetailsReportErrorResponse

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
GenerateCostDetailsReportByBillingProfileAndInvoiceId
GenerateCostDetailsReportByBillingProfileAndInvoiceIdAndCustomerId
GenerateCostDetailsReportByCustomerAndTimePeriod
GenerateCostDetailsReportByDepartmentsAndTimePeriod
GenerateCostDetailsReportByEnrollmentAccountsAndTimePeriod
GenerateCostDetailsReportBySubscriptionAndTimePeriod

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
BlobInfo

A művelet által létrehozott blobadatok.

CostDetailsDataFormat

A jelentés adatformátuma

CostDetailsMetricType

A részletes jelentés típusa. Alapértelmezés szerint az ActualCost meg van adva

CostDetailsOperationResults

A cost details Api hosszú ideig futó műveletének eredménye.

CostDetailsStatusType

A költség részletei művelet állapota

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

ErrorDetails

A hiba részletei.

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.

GenerateCostDetailsReportRequestDefinition

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

ErrorDetails

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

BlobInfo[]

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

CostDetailsDataFormat

A jelentés adatformátuma

manifest.manifestVersion

string

A Jegyzék verziója.

manifest.requestContext.requestBody

GenerateCostDetailsReportRequestDefinition

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

CostDetailsStatusType

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

ErrorDetails

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

CostDetailsMetricType

A részletes jelentés típusa. Alapértelmezés szerint az ActualCost meg van adva

timePeriod

CostDetailsTimePeriod

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