Freigeben über

Charges - List

  • Referenz
Dienst:
Consumption
API-Version:
2024-08-01

Listet die Gebühren auf, die für den definierten Bereich basieren.

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/charges?api-version=2024-08-01
Mit optionalen Parametern: 
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate={startDate}&endDate={endDate}&$filter={$filter}&$apply={$apply}

URI-Parameter

Name In Erforderlich Typ Beschreibung
scope
 path True

string

Der Bereich, der Gebührenvorgängen zugeordnet ist. Dies umfasst "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}" für den Abteilungsbereich und "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}" für den Bereich "EnrollmentAccount". Für Abteilungs- und Registrierungskonten können Sie auch den Abrechnungszeitraum mit "/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}" hinzufügen. Verwenden Sie z. B. zum Angeben des Abrechnungszeitraums im Abteilungsbereich "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}". Außerdem sind moderne Commerce-Kontobereiche "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}" für den Bereich "billingAccount", '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' für billingProfile scope, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' für invoiceSection scope, and '/providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' speziell für Partner.
api-version
 query True

string

Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2023-03-01.
$apply
 query

string

Kann verwendet werden, um Gebühren für den AbrechnungAccount-Bereich nach Eigenschaften/billingProfileId, Eigenschaften/invoiceSectionId, Eigenschaften/customerId (spezifisch für Partner led) oder für billingProfile-Bereich nach Eigenschaften/invoiceSectionId zu gruppieren.
$filter
 query

string

Kann verwendet werden, um Gebühren nach Eigenschaften/usageEnd (Utc-Zeit), Eigenschaften/UsageStart (Utc-Zeit) zu filtern. Der Filter unterstützt "eq", "lt", "gt", "le", "ge" und "and". Es unterstützt derzeit weder 'ne', 'or' oder 'not'. Der Tagfilter ist eine Schlüsselwertpaarzeichenfolge, bei der Schlüssel und Wert durch einen Doppelpunkt (:)) getrennt sind.
endDate
 query

string

Enddatum
startDate
 query

string

Startdatum

Antworten

Name Typ Beschreibung
200 OK

ChargesListResult

OKAY. Die Anforderung ist erfolgreich.
Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

ChangesForBillingPeriodByDepartment-Legacy
ChangesForBillingPeriodByEnrollmentAccount-Legacy
ChargesListByBillingAccount-Modern
ChargesListByBillingAccountGroupByBillingProfileId-Modern
ChargesListByBillingAccountGroupByCustomerId-Modern
ChargesListByBillingAccountGroupByInvoiceSectionId-Modern
ChargesListByBillingProfile-Modern
ChargesListByBillingProfileGroupByInvoiceSectionId-Modern
ChargesListByBillingProfileInvoiceSection-Modern
ChargesListByCustomer-Modern
ChargesListByDepartment-Legacy
ChargesListByInvoiceSectionId-Modern
ChargesListForEnrollmentAccount-Legacy

ChangesForBillingPeriodByDepartment-Legacy

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/departments/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/departments/42425/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "legacy",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201804",
        "usageStart": "2018-04-01",
        "usageEnd": "2018-04-30",
        "azureCharges": 5000,
        "chargesBilledSeparately": 60.9,
        "azureMarketplaceCharges": 100,
        "currency": "USD"
      }
    }
  ]
}

ChangesForBillingPeriodByEnrollmentAccount-Legacy

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/enrollmentAccounts/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/enrollmentAccounts/42425/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "legacy",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201804",
        "usageStart": "2018-04-01",
        "usageEnd": "2018-04-30",
        "azureCharges": 5000,
        "chargesBilledSeparately": 60.9,
        "azureMarketplaceCharges": 100,
        "currency": "USD"
      }
    }
  ]
}

ChargesListByBillingAccount-Modern

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-10-31

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-10-31",
        "azureCharges": {
          "currency": "USD",
          "value": 0
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 265.09
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 0
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": null,
        "invoiceSectionId": null
      }
    }
  ]
}

ChargesListByBillingAccountGroupByBillingProfileId-Modern

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-09-30&$apply=groupby((properties/billingProfileId))

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/123456/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/123456"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789/billingProfiles/42425/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425"
      }
    }
  ]
}

ChargesListByBillingAccountGroupByCustomerId-Modern

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-09-30&$apply=groupby((properties/customerId))

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/customers/67890/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "customerId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/customers/67890",
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/67890"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789/customers/123456/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "customerId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/customers/123456",
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/67890"
      }
    }
  ]
}

ChargesListByBillingAccountGroupByInvoiceSectionId-Modern

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-09-30&$apply=groupby((properties/invoiceSectionId))

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/4567/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/4567"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789//billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/67890"
      }
    }
  ]
}

ChargesListByBillingProfile-Modern

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/billingProfiles/2460/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2023-03-01",
        "usageEnd": "2023-05-31",
        "azureCharges": {
          "currency": "USD",
          "value": 0
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 265.09
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 0
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460",
        "invoiceSectionId": null
      }
    }
  ]
}

ChargesListByBillingProfileGroupByInvoiceSectionId-Modern

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-09-30&$apply=groupby((properties/invoiceSectionId))

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/4567/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/4567"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234:56789//billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/invoiceSections/67890"
      }
    }
  ]
}

ChargesListByBillingProfileInvoiceSection-Modern

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges?api-version=2024-08-01&startDate=2019-09-01&endDate=2019-10-31

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201909",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-09-30",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/4567"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/67890/providers/Microsoft.Consumption/charges/chargeSummaryId2",
      "name": "chargeSummaryId2",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2019-09-01",
        "usageEnd": "2019-10-31",
        "azureCharges": {
          "currency": "USD",
          "value": 5000
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 60.9
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 100
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/42425/invoiceSections/4567"
      }
    }
  ]
}

ChargesListByCustomer-Modern

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/customers/67890/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/customers/67890/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2023-03-01",
        "usageEnd": "2023-05-31",
        "azureCharges": {
          "currency": "USD",
          "value": 0
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 265.09
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 0
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": null,
        "invoiceSectionId": null
      }
    }
  ]
}

ChargesListByDepartment-Legacy

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/departments/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01&$filter=usageStart eq '2018-04-01' AND usageEnd eq '2018-05-30'

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/departments/42425/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "legacy",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201804",
        "usageStart": "2018-04-01",
        "usageEnd": "2018-04-30",
        "azureCharges": 5000,
        "chargesBilledSeparately": 60.9,
        "azureMarketplaceCharges": 100,
        "currency": "USD"
      }
    }
  ]
}

ChargesListByInvoiceSectionId-Modern

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234:56789/invoiceSections/97531/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460/invoiceSections/97531/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "modern",
      "properties": {
        "isInvoiced": false,
        "billingPeriodId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/providers/Microsoft.Billing/billingPeriods/201910",
        "usageStart": "2023-03-01",
        "usageEnd": "2023-05-31",
        "azureCharges": {
          "currency": "USD",
          "value": 12
        },
        "chargesBilledSeparately": {
          "currency": "USD",
          "value": 0
        },
        "marketplaceCharges": {
          "currency": "USD",
          "value": 0
        },
        "billingAccountId": "/providers/Microsoft.Billing/billingAccounts/1234:56789",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/1234:56789/billingProfiles/2460/invoiceSections/97531"
      }
    }
  ]
}

ChargesListForEnrollmentAccount-Legacy

Beispielanforderung

GET https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/1234/enrollmentAccounts/42425/providers/Microsoft.Consumption/charges?api-version=2024-08-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/enrollmentAccounts/42425/providers/Microsoft.Consumption/charges/chargeSummaryId1",
      "name": "chargeSummaryId1",
      "type": "Microsoft.Consumption/charges",
      "kind": "legacy",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201804",
        "usageStart": "2018-04-01",
        "usageEnd": "2018-04-30",
        "azureCharges": 5000,
        "chargesBilledSeparately": 60.9,
        "azureMarketplaceCharges": 100,
        "currency": "USD"
      }
    }
  ]
}

Definitionen

Name Beschreibung
amount

Der Betrag plus Währung .
ChargesListResult

Ergebnis der Auflistung der Gebührenzusammenfassung.
ErrorDetails

Die Details des Fehlers.
ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

  • 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.

  • 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.

  • 504 Gatewaytimeout – Diensttimeout beim Verarbeiten der Anforderung. Verringern Sie den Datumsbereich in der Anforderung, falls möglich.
LegacyChargeSummary

Zusammenfassung der älteren Gebühren.
ModernChargeSummary

Moderne Gebührenzusammenfassung.

amount

Objekt

Der Betrag plus Währung .

Name Typ Beschreibung
currency

string

Betragswährung.
value

number (decimal)

Menge.

ChargesListResult

Objekt

Ergebnis der Auflistung der Gebührenzusammenfassung.

Name Typ Beschreibung
value ChargeSummary[]:

Die Liste der Gebührenzusammenfassung

ErrorDetails

Objekt

Die Details des Fehlers.

Name Typ Beschreibung
code

string

Fehlercode.
message

string

Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponse

Objekt

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Einige Fehlerantworten:

  • 429 TooManyRequests – Anforderung wird gedrosselt. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "x-ms-ratelimit-microsoft.consumption-retry-after" angegebene Zeit.

  • 503 ServiceUnavailable – Dienst ist vorübergehend nicht verfügbar. Wiederholen Sie den Vorgang nach dem Warten auf die im Header "Retry-After" angegebene Zeit.

  • 504 Gatewaytimeout – Diensttimeout beim Verarbeiten der Anforderung. Verringern Sie den Datumsbereich in der Anforderung, falls möglich.

Name Typ Beschreibung
error

ErrorDetails

Die Details des Fehlers.

LegacyChargeSummary

Objekt

Zusammenfassung der älteren Gebühren.

Name Typ Beschreibung
eTag

string

eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
id

string

Ressourcen-ID.
kind string:

legacy

Gibt die Art der Gebührenzusammenfassung an.
name

string

Ressourcenname.
properties.azureCharges

number (decimal)

Azure-Gebühren.
properties.azureMarketplaceCharges

number (decimal)

Marketplace-Gebühren.
properties.billingPeriodId

string

Die ID der Abrechnungszeitraumsressource, zu der die Gebühr gehört.
properties.chargesBilledSeparately

number (decimal)

Gebühren separat abgerechnet.
properties.currency

string

Währungscode
properties.usageEnd

string

Enddatum der Verwendung.
properties.usageStart

string

Nutzungsanfangsdatum.
type

string

Ressourcentyp.

ModernChargeSummary

Objekt

Moderne Gebührenzusammenfassung.

Name Typ Beschreibung
eTag

string

eTag der Ressource. Um das Szenario für gleichzeitige Updates zu behandeln, wird dieses Feld verwendet, um zu bestimmen, ob der Benutzer die neueste Version aktualisiert oder nicht.
id

string

Ressourcen-ID.
kind string:

modern

Gibt die Art der Gebührenzusammenfassung an.
name

string

Ressourcenname.
properties.azureCharges

amount

Azure-Gebühren.
properties.billingAccountId

string

Abrechnungskonto-ID
properties.billingPeriodId

string

Die ID der Abrechnungszeitraumsressource, zu der die Gebühr gehört.
properties.billingProfileId

string

Abrechnungsprofil-ID
properties.chargesBilledSeparately

amount

Gebühren separat abgerechnet.
properties.customerId

string

Kunden-ID
properties.invoiceSectionId

string

Rechnungsabschnitts-ID
properties.isInvoiced

boolean

Wird in Rechnung gestellt
properties.marketplaceCharges

amount

Marketplace-Gebühren.
properties.subscriptionId

string

Abonnement-GUID.
properties.usageEnd

string

Enddatum der Verwendung.
properties.usageStart

string

Nutzungsanfangsdatum.
type

string

Ressourcentyp.