Dela via

Granska faktureringen för företagsregistrering med hjälp av REST-API:er

Rapporterings-API:er i Azure hjälper dig att granska och hantera dina Azure-kostnader.

I den här artikeln lär du dig att hämta faktureringsinformationen som är associerad med faktureringskonton, avdelnings- eller enterprise-avtalsregistreringskonton (EA) med hjälp av Azure REST API:er.

Fakturering för enskilda konton

Så här hämtar du användningsinformation för konton på en avdelning:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-06-30
Content-Type: application/json   
Authorization: Bearer

Parametern {billingAccountId} krävs och ska innehålla ID:t för kontot.

Följande rubriker krävs:

Förfrågningshuvudrad Beskrivning
Innehållstyp: Obligatoriskt. Ställ in på application/json.
Behörighet: Obligatoriskt. Ange till en giltig Bearer API-nyckel.

Det här exemplet visar ett synkront anrop som returnerar information för den aktuella faktureringsperioden. Av prestandaskäl returnerar synkrona anrop information för den senaste månaden. Du kan också anropa API:et asynkront för att returnera data i 36 månader.

Svar

Statuskod 200 (OK) returneras för ett lyckat svar, som innehåller en lista över detaljerade kostnader för kontot.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/BillingAccounts/1234/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/usageDetails/usageDetailsId1",
      "name": "usageDetailsId1",
      "type": "Microsoft.Consumption/usageDetails",
      "properties": {
        ...
        "usageStart": "2017-02-13T00:00:00Z",
        "usageEnd": "2017-02-13T23:59:59Z",
        "instanceName": "shared1",
        "instanceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/Default-Web-eastasia/providers/Microsoft.Web/sites/shared1",
        "currency": "USD",
        "usageQuantity": 0.00328,
        "billableQuantity": 0.00328,
        "pretaxCost": 0.67,
        "isEstimated": false,
        ...
      }
    }
  ]
}

Det här exemplet är förkortat. Se Hämta användningsinformation för ett faktureringskonto för en fullständig beskrivning av varje svarsfält och felhantering.

Avdelningsfakturering

Hämta användningsinformation aggregerad för alla konton på en avdelning.

GET https://management.azure.com/providers/Microsoft.Billing/departments/{departmentId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-06-30
Content-Type: application/json   
Authorization: Bearer

Parametern {departmentId} krävs och ska innehålla ID:t för avdelningen i registreringskontot.

Följande rubriker krävs:

Förfrågningshuvudrad Beskrivning
Innehållstyp: Obligatoriskt. Ställ in på application/json.
Behörighet: Obligatoriskt. Ange till en giltig Bearer API-nyckel.

Det här exemplet visar ett synkront anrop som returnerar information för den aktuella faktureringsperioden. Av prestandaskäl returnerar synkrona anrop information för den senaste månaden. Du kan också anropa API:et asynkront för att returnera data i 36 månader.

Svar

Statuskod 200 (OK) returneras för ett lyckat svar, som innehåller en lista med detaljerad användningsinformation och kostnader för en viss faktureringsperiod och faktura-ID för avdelningen.

I följande exempel visas utdata från REST-API:et för avdelningen 1234.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/Departments/1234/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/usageDetails/usageDetailsId1",
      "name": "usageDetailsId1",
      "type": "Microsoft.Consumption/usageDetails",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/Departments/1234/providers/Microsoft.Billing/billingPeriods/201702",
        "invoiceId": "/providers/Microsoft.Billing/Departments/1234/providers/Microsoft.Billing/invoices/201703-123456789",
        "usageStart": "2017-02-13T00:00:00Z",
        "usageEnd": "2017-02-13T23:59:59Z",
        "instanceName": "shared1",
        "instanceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/Default-Web-eastasia/providers/Microsoft.Web/sites/shared1",
        "instanceLocation": "eastasia",
        "currency": "USD",
        "usageQuantity": 0.00328,
        "billableQuantity": 0.00328,
        "pretaxCost": 0.67,
        ...
      }
    }
  ]
}

Det här exemplet är förkortat. Se Hämta användningsinformation för en avdelning för en fullständig beskrivning av varje svarsfält och felhantering.

Fakturering av registreringskonto

Hämta användningsinformation aggregerad för registreringskontot.

GET https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-06-30
Content-Type: application/json   
Authorization: Bearer

Parametern {enrollmentAccountId} krävs och ska innehålla ID:t för registreringskontot.

Följande rubriker krävs:

Förfrågningshuvudrad Beskrivning
Innehållstyp: Obligatoriskt. Ställ in på application/json.
Behörighet: Obligatoriskt. Ange till en giltig Bearer API-nyckel.

Det här exemplet visar ett synkront anrop som returnerar information för den aktuella faktureringsperioden. Av prestandaskäl returnerar synkrona anrop information för den senaste månaden. Du kan också anropa API:et asynkront för att returnera data i 36 månader.

Svar

Statuskod 200 (OK) returneras för ett lyckat svar, som innehåller en lista med detaljerad användningsinformation och kostnader för en viss faktureringsperiod och faktura-ID för avdelningen.

I följande exempel visas utdata från REST-API:et för företagsregistrering 1234.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/EnrollmentAccounts/1234/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/usageDetails/usageDetailsId1",
      "name": "usageDetailsId1",
      "type": "Microsoft.Consumption/usageDetails",
      "properties": {
        "billingPeriodId": "/providers/Microsoft.Billing/EnrollmentAccounts/1234/providers/Microsoft.Billing/billingPeriods/201702",
        "invoiceId": "/providers/Microsoft.Billing/EnrollmentAccounts/1234/providers/Microsoft.Billing/invoices/201703-123456789",
        "usageStart": "2017-02-13T00:00:00Z",
        "usageEnd": "2017-02-13T23:59:59Z",
        ....
        "currency": "USD",
        "usageQuantity": 0.00328,
        "billableQuantity": 0.00328,
        "pretaxCost": 0.67,
        ...
      }
    }
  ]
}

Det här exemplet är förkortat. Se Hämta användningsinformation för ett registreringskonto för en fullständig beskrivning av varje svarsfält och felhantering.

Nästa steg