Usare l'API per esportare l'ottimizzazione del carbonio nei dati sulle emissioni di Azure

Questo articolo illustra come comprendere e usare la versione più recente dell'API REST carbon service per esportare l'ottimizzazione del carbonio nei dati sulle emissioni di Azure. I dati sulle emissioni sono disponibili per il mese precedente entro il giorno 19 del mese corrente.

Per esportare i dati sulle emissioni usando l'API REST, è necessario creare e autorizzare un'entità servizio ad accedere ai dati sulle emissioni. È quindi possibile usare l'entità servizio per ottenere un token di autorizzazione e quindi esportare i dati sulle emissioni usando l'API REST.

Creare e autorizzare un service principal

L'entità principale del servizio è un'applicazione i cui token possono essere usati per autenticare e concedere l'accesso a risorse di Azure specifiche usando Microsoft Entra ID. Le risorse includono app utente, servizi o strumenti di automazione.

  1. Creare un'applicazione Microsoft Entra e un principal del servizio che possano accedere alle risorse.
  2. Salvare l'ID tenant, il nuovo ID client e il valore del segreto client della tua app per l'utilizzo delle richieste di token.
  3. Assegnare all'app un ruolo nell'ambito dei dati da esportare: un ruolo a livello di abbonamento per le richieste di abbonamento o un ruolo supportato a livello di account di fatturazione per le richieste di account di fatturazione. Per altre informazioni, vedere Assegnare l'accesso all'ottimizzazione del carbonio in Azure.

Ottenere un token di autorizzazione

Inviare la richiesta seguente POST al prompt dei comandi o usando un client. Usare l'URL https://management.azure.com della risorsa per ottenere un token di accesso per l'API di gestione delle risorse.

curl -X POST 'https://login.microsoftonline.com/<tennant ID>/oauth2/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=<your apps client ID>' \
--data-urlencode 'client_secret=<your apps client secret' \
--data-urlencode 'resource=https://management.azure.com'

Il corpo della risposta viene visualizzato come segue:

{
    "token_type": "Bearer",
    "expires_in": "86399",
    "ext_expires_in": "86399",
    "expires_on": "1672826207",
    "not_before": "1672739507",
    "resource": "https://management.azure.com",
    "access_token": "eyJ0eXAiOiJKV1Qi....gpHWoRzeDdVQd2OE3dNsLIvUIxQ"
}

Usare il token di accesso dalla risposta da usare nelle richieste HTTP seguenti.

Esportare i dati sulle emissioni usando l'API REST

Per le richieste a livello di sottoscrizione, usare la richiesta seguente POST e includere subscriptionList nel corpo:

POST /providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer \<token value\>

Esportare i dati sulle emissioni usando l'API REST a livello di account di fatturazione

Per le richieste a livello di account di fatturazione, usare l'endpoint seguente con un account di fatturazione o un identificatore di iscrizione. Nell'esempio seguente viene omesso l'oggetto opzionale subscriptionList. Le richieste di account di fatturazione includono tutte le sottoscrizioni nell'account di fatturazione specificato.

POST /providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer <token value>

Richiesta e risposta di esempio

POST https://management.azure.com/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "MonthlySummaryReport",
  "subscriptionList": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "carbonScopeList": [
    "Scope1",
    "Scope3"
  ],
  "dateRange": {
    "start": "2024-03-01",
    "end": "2024-05-01"
  }
}

Output di esempio

{
  "subscriptionAccessDecisionList": [
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "decision": "Allowed"
    }
  ],
  "value": [
    {
      "dataType": "MonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05
    }
  ]
}

Nell'esempio di riepilogo a livello di account di fatturazione seguente viene omesso il parametro facoltativo subscriptionList:

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "MonthlySummaryReport",
  "carbonScopeList": ["Scope1", "Scope3"],
  "dateRange": {
    "start": "2024-03-01",
    "end": "2024-05-01"
  }
}

La risposta dell'account di fatturazione non include subscriptionAccessDecisionList:

{
  "value": [
    {
      "dataType": "MonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05
    }
  ]
}

Ecco un esempio di comando curl:

curl --location 'https://management.azure.com/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ0eXA...2-KgVBNrsvg' \
--data '{
  "reportType": "ItemDetailsReport",
  "subscriptionList": [
    "00000000-0000-0000-0000-000000000000",
    "00000000-0000-0000-0000-000000000001,",
    "00000000-0000-0000-0000-000000000002",
    "00000000-0000-0000-0000-000000000003",
    "00000000-0000-0000-0000-000000000004",
    "00000000-0000-0000-0000-000000000005",
    "00000000-0000-0000-0000-000000000006",
    "00000000-0000-0000-0000-000000000007",
    "00000000-0000-0000-0000-000000000008"
  ],
  "carbonScopeList": [
    "Scope1",
    "Scope3"
  ],
  "dateRange": {
    "start": "2024-05-01",
    "end": "2024-05-01"
  },
  "categoryType": "Resource",
  "orderBy": "LatestMonthEmissions",
  "sortDirection": "Desc",
  "pageSize": 100
}
'

Output curl di esempio:

{
  "subscriptionAccessDecisionList": [
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000001",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000002",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000003",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000004",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000005",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000006",
      "decision": "Denied"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000007",
      "decision": "Denied"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000008",
      "decision": "Denied",
      "denialReason": "Carbon Optimization Reader permisison required"
    }
  ],
  "value": [
    {
      "dataType": "ResourceItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "rgName1",
      "resourceGroup": "rgGroup",
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgGroup/providers/microsoft.storage/storageaccounts/rgName1",
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "categoryType": "Resource",
      "resourceType": "microsoft.storage/storageaccounts",
      "location": "east us"
    },
    {
      "dataType": "ResourceItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "rgName2",
      "resourceGroup": "rgGroup",
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgGroup/providers/microsoft.storage/storageaccounts/rgName2",
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "categoryType": "Resource",
      "resourceType": "microsoft.storage/storageaccounts",
      "location": "east us"
    },
    {
      "dataType": "ResourceItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "rgName3",
      "resourceGroup": "rgGroup",
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgGroup/providers/microsoft.storage/storageaccounts/rgName3",
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "categoryType": "Resource",
      "resourceType": "microsoft.storage/storageaccounts",
      "location": "east us"
    },
    {
      "dataType": "ResourceItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "rgName4",
      "resourceGroup": "rgGroup",
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000002/resourceGroups/rgGroup/providers/microsoft.storage/storageaccounts/rgName4",
      "subscriptionId": "00000000-0000-0000-0000-000000000002",
      "categoryType": "Resource",
      "resourceType": "microsoft.storage/storageaccounts",
      "location": "east us"
    },
    {
      "dataType": "ResourceItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "rgName5",
      "resourceGroup": "rgGroup",
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000002/resourceGroups/rgGroup/providers/microsoft.storage/storageaccounts/rgName5",
      "subscriptionId": "00000000-0000-0000-0000-000000000002",
      "categoryType": "Resource",
      "resourceType": "microsoft.storage/storageaccounts",
      "location": "east us"
    }
  ],
  "skipToken": "dGVzZGZhZGZzZnNkZg=="
}

Per una richiesta di dettagli dell'elemento a livello di account di fatturazione, usare lo stesso filtro senza subscriptionList:

curl --location 'https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token value>' \
--data '{
  "reportType": "ItemDetailsReport",
  "carbonScopeList": ["Scope1", "Scope3"],
  "dateRange": {"start": "2024-05-01", "end": "2024-05-01"},
  "categoryType": "Resource",
  "orderBy": "LatestMonthEmissions",
  "sortDirection": "Desc",
  "pageSize": 100
}'

La risposta contiene ResourceItemDetailsData voci e può contenere un skipToken per la pagina successiva:

{
  "value": [
    {
      "dataType": "ResourceItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "rgName1",
      "resourceGroup": "rgGroup",
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rgGroup/providers/microsoft.storage/storageaccounts/rgName1",
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "categoryType": "Resource",
      "resourceType": "microsoft.storage/storageaccounts",
      "location": "east us"
    }
  ],
  "skipToken": "dGVzZGZhZGZzZnNkZg=="
}

Tipi di report

L'ottimizzazione del carbonio offre diversi tipi di report che consentono di analizzare i dati sulle emissioni. Ogni tipo di report ha uno scopo diverso e viene usato per esigenze specifiche:

Tipo di report Descrizione Quando utilizzare
Rapporto di sintesi complessivo Fornisce emissioni di carbonio totali per l'intervallo di date e i parametri di query specificati e i valori comparativi per una panoramica generale. Questo tipo di report accetta valori diversi nei campi iniziale e finale all'interno di DateRange. Ad esempio, start: 2024-03-01 e fine: 2024-06-01. Dati di report di alto livello necessari
ReportMensileDiSintesi Fornisce i dati sulle emissioni di carbonio per mese per i parametri di query specificati. Questo tipo di report accetta valori diversi nei campi iniziale e finale all'interno di DateRange. Ad esempio, start: 2024-03-01 e fine: 2024-06-01. Dettagli per un mese specificato
Rapporto Sommario Articoli Principali Fornisce gli N elementi di emissione più alti per i filtri di query specificati. Questo report restituisce i dati per un singolo mese alla volta, quindi richiede gli stessi valori per i campi di inizio e fine all'interno di DateRange. Viene restituito un massimo di N=10 elementi alla volta. Dati per gli elementi principali per categoria
Rapporto mensile di riepilogo sugli articoli principali Fornisce gli N elementi con emissione massima per mese per il filtro di query specificato. Restituisce i dati sulle emissioni per i primi N elementi al mese entro l'intervallo di date specificato. Viene restituito un massimo di N=10 elementi alla volta. Dati per gli elementi principali per categoria e mese
Rapporto dettagli dell’articolo Elenco granulare di elementi in base al tipo di categoria specificato (tra cui Resource, ResourceGroup, ResourceType, Location o Subscription) per il filtro di query. È possibile eseguire una query per un solo mese alla volta. DateRange richiede gli stessi valori per i campi iniziale e finale. Dati sulle emissioni per categoria

Esportare i parametri dell'API per le emissioni

Per ogni reportType, vengono definiti parametri di query diversi. Nelle sezioni seguenti vengono fornite informazioni dettagliate sui parametri di query per ogni reportTypeoggetto .

Name Required Type Descrizione
billingAccountId Conditional corda Identificatore dell'account di fatturazione nell'URI della richiesta. Obbligatorio per le richieste a livello di account di fatturazione; omettere per le richieste a livello di sottoscrizione.
Nome Descrizione
ItemDetailsQueryFilter Parametri di query per ItemDetailsReport
MonthlySummaryReportQueryFilter Parametri di filtro delle query per configurare MonthlySummaryReport le query.
OverallSummaryReportQueryFilter Parametri di filtro delle query per configurare OverallSummaryReport le query.
TopItemsMonthlySummaryReportQueryFilter Parametri di filtro delle query per configurare TopItemsMonthlySummaryReport le query.
TopItemsSummaryReportQueryFilter Parametri di filtro delle query per configurare TopItemsSummaryReport le query.

Per altre informazioni sui report dell'API REST, vedere le informazioni di riferimento sull'API REST Carbon Service.

Filtro di Ricerca Dettagli Articolo

Ecco i parametri di query per ItemDetailsReport.

Nome Obbligatorio Tipo Descrizione
carbonScopeList Vero EmissionScopeEnum[] Elenco degli ambiti di emissione di carbonio. Obbligatorio. Accetta uno o più valori da EmissionScopeEnum. Ad esempio, Scope1, Scope2, Scope3 nel formato elenco. L'output include le emissioni totali per gli ambiti specificati.
tipoCategoria Vero CategoryTypeEnum Specifica il tipo di categoria per i dati dettagliati sulle emissioni, ad esempio Resource, ResourceGroup, ResourceType, Location o Subscription. Vedi i tipi supportati in CategoryTypeEnum.
intervallo di date Vero DateRange Date di inizio e fine per i dati sulle emissioni di carbonio. Obbligatorio. Per ItemDetailsReport e TopItemsSummaryReport, è supportato un solo mese di dati alla volta, pertanto le date di inizio e di fine devono essere uguali all'interno DateRangedi . Ad esempio, start: 2024-06-01 e fine: 2024-06-01.
orderBy Vero OrderByColumnEnum Nome della colonna in base al quale ordinare i risultati. Vedere i valori supportati in OrderByColumnEnum.
dimensione della pagina Vero integer (int32)

minimo: 1
massimo: 5000		 Numero di elementi da restituire in una richiesta, il valore massimo è 5000.
reportType Vero corda:

Rapporto dettagli dell’articolo		 ReportType ha richiesto i dati sulle emissioni di carbonio. Obbligatorio. Specifica la modalità di aggregazione e visualizzazione dei dati nell'output, come illustrato in ReportTypeEnum.
sortDirection Vero SortDirectionEnum Direzione per l'ordinamento dei risultati. Vedere i valori supportati in SortDirectionEnum.
elenco abbonamenti Conditional string[] ID della sottoscrizione per le richieste a livello di sottoscrizione; facoltativo per le richieste a livello di account di fatturazione. Ogni ID deve essere minuscolo, con un limite di 100 sottoscrizioni per ogni richiesta a livello di sottoscrizione. Le richieste a livello di account di fatturazione includono tutte le sottoscrizioni nell'account di fatturazione specificato senza un limite di conteggio delle sottoscrizioni.
locationList string[] Elenco di località (nome visualizzato dell'area di Azure) per i dati sulle emissioni di carbonio, con ogni località specificata in lettere minuscole. Ad esempio: east us. Opzionale. È possibile usare il comando az account list-locations -o table per trovare i nomi visualizzati dell'area di Azure.
resourceGroupUrlList string[] Elenco degli URL del gruppo di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni URL deve seguire il formato /subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}e deve essere in lettere minuscole.
resourceTypeList string[] Elenco dei tipi di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni tipo di risorsa deve essere specificato in lettere minuscole, seguendo il formato microsoft.{service}/{resourceType}. Ad esempio: microsoft.storage/storageaccounts.
skipToken corda Token di paginazione per il recupero della pagina successiva dei dati. Questo token è nullabile e viene restituito nella risposta precedente se sono disponibili altre pagine di dati.

FiltroDiQueryPerRapportoDiSintesiMensile

Ecco i parametri di filtro delle query per configurare MonthlySummaryReport.

Nome Obbligatorio Tipo Descrizione
carbonScopeList Vero EmissionScopeEnum[] Elenco degli ambiti di emissione di carbonio. Obbligatorio. Accetta uno o più valori da EmissionScopeEnum. Ad esempio, Scope1, Scope2, Scope3 nel formato elenco. L'output include le emissioni totali per gli ambiti specificati.
intervallo di date Vero DateRange Date di inizio e fine per i dati sulle emissioni di carbonio. Obbligatorio. Per ItemDetailsReport e TopItemsSummaryReport, è supportato un solo mese di dati alla volta, pertanto le date di inizio e di fine devono essere uguali all'interno DateRangedi . Ad esempio, start: 2024-06-01 e fine: 2024-06-01.
reportType Vero corda:

ReportMensileDiSintesi		 ReportType ha richiesto i dati sulle emissioni di carbonio. Obbligatorio. Specifica la modalità di aggregazione e visualizzazione dei dati nell'output, come illustrato in ReportTypeEnum.
elenco abbonamenti Conditional string[] ID della sottoscrizione per le richieste a livello di sottoscrizione; facoltativo per le richieste a livello di account di fatturazione. Ogni ID deve essere minuscolo, con un limite di 100 sottoscrizioni per ogni richiesta a livello di sottoscrizione. Le richieste a livello di account di fatturazione includono tutti gli abbonamenti nell'account di fatturazione specificato senza un limite di conteggio degli abbonamenti.
locationList string[] Elenco di località (nome visualizzato dell'area di Azure) per i dati sulle emissioni di carbonio, con ogni località specificata in lettere minuscole. Ad esempio: east us. Opzionale. È possibile usare il comando az account list-locations -o table per trovare i nomi visualizzati dell'area di Azure.
resourceGroupUrlList string[] Elenco degli URL del gruppo di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni URL deve seguire il formato /subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}e deve essere in lettere minuscole.
resourceTypeList string[] Elenco dei tipi di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni tipo di risorsa deve essere specificato in lettere minuscole, seguendo il formato microsoft.{service}/{resourceType}. Ad esempio: microsoft.storage/storageaccounts.

FiltroQueryReportRiepilogoGenerale

Ecco i parametri del filtro di query per configurare le query OverallSummaryReport.

Nome Obbligatorio Tipo Descrizione
carbonScopeList Vero EmissionScopeEnum[] Elenco degli ambiti di emissione di carbonio. Obbligatorio. Accetta uno o più valori da EmissionScopeEnum. Ad esempio, Scope1, Scope2, Scope3 nel formato elenco. L'output include le emissioni totali per gli ambiti specificati.
intervallo di date Vero DateRange Date di inizio e fine per i dati sulle emissioni di carbonio. Obbligatorio. Per ItemDetailsReport e TopItemsSummaryReport, è supportato un solo mese di dati alla volta, pertanto le date di inizio e di fine devono essere uguali all'interno DateRangedi . Ad esempio, start: 2024-06-01 e fine: 2024-06-01.
reportType Vero corda:

Rapporto di sintesi complessivo		 ReportType ha richiesto i dati sulle emissioni di carbonio. Obbligatorio. Specifica la modalità di aggregazione e visualizzazione dei dati nell'output, come illustrato in ReportTypeEnum.
elenco abbonamenti Conditional string[] ID sottoscrizione per le richieste a livello di sottoscrizione; facoltativo per le richieste a livello di account di fatturazione. Ogni ID deve essere minuscolo, con un limite di 100 sottoscrizioni per ogni richiesta a livello di sottoscrizione. Le richieste a livello di account di fatturazione includono tutte le sottoscrizioni nell'account di fatturazione specificato senza un limite di conteggio delle sottoscrizioni.
locationList string[] Elenco di località (nome visualizzato dell'area di Azure) per i dati sulle emissioni di carbonio, con ogni località specificata in lettere minuscole. Ad esempio: east us. Opzionale. È possibile usare il comando az account list-locations -o table per trovare i nomi visualizzati dell'area di Azure.
resourceGroupUrlList string[] Elenco degli URL del gruppo di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni URL deve seguire il formato /subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}e deve essere in lettere minuscole.
resourceTypeList string[] Elenco dei tipi di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni tipo di risorsa deve essere specificato in lettere minuscole, seguendo il formato microsoft.{service}/{resourceType}. Ad esempio: microsoft.storage/storageaccounts.

FiltroDiInterrogazioneRapportoDiSintesiMensileOggettiPrincipali

Ecco i parametri di filtro delle query per configurare TopItemsMonthlySummaryReport.

Nome Obbligatorio Tipo Descrizione
carbonScopeList Vero EmissionScopeEnum[] Elenco degli ambiti di emissione di carbonio. Obbligatorio. Accetta uno o più valori da EmissionScopeEnum. Ad esempio, Scope1, Scope2, Scope3 nel formato elenco. L'output include le emissioni totali per gli ambiti specificati.
tipoCategoria Vero CategoryTypeEnum Specifica il tipo di categoria per recuperare gli elementi con le emissioni più elevate, aggregati per mese. Vedi i tipi supportati in CategoryTypeEnum.
intervallo di date Vero DateRange Date di inizio e fine per i dati sulle emissioni di carbonio. Obbligatorio. Per ItemDetailsReport e TopItemsSummaryReport, è supportato un solo mese di dati alla volta, pertanto le date di inizio e di fine devono essere uguali all'interno DateRangedi . Ad esempio, start: 2024-06-01 e fine: 2024-06-01.
reportType Vero corda:

Rapporto mensile di riepilogo sugli articoli principali		 ReportType ha richiesto i dati sulle emissioni di carbonio. Obbligatorio. Specifica la modalità di aggregazione e visualizzazione dei dati nell'output, come illustrato in ReportTypeEnum.
elenco abbonamenti Conditional string[] ID sottoscrizione per le richieste a livello di sottoscrizione; facoltativo per le richieste a livello di account di fatturazione. Ogni ID deve essere minuscolo, con un limite di 100 sottoscrizioni per ogni richiesta a livello di sottoscrizione. Le richieste a livello di account di fatturazione includono tutte le sottoscrizioni nell'account di fatturazione specificato senza un limite di conteggio delle sottoscrizioni.
elementi principali Vero integer (int32)

minimo: 1
massimo: 10		 Numero di articoli principali da restituire, in base alle emissioni. Deve essere compreso tra 1 e 10.
locationList string[] Elenco di località (nome visualizzato dell'area di Azure) per i dati sulle emissioni di carbonio, con ogni località specificata in lettere minuscole. Ad esempio: east us. Opzionale. È possibile usare il comando az account list-locations -o table per trovare i nomi visualizzati dell'area di Azure.
resourceGroupUrlList string[] Elenco degli URL del gruppo di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni URL deve seguire il formato /subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}e deve essere in lettere minuscole.
resourceTypeList string[] Elenco dei tipi di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni tipo di risorsa deve essere specificato in lettere minuscole, seguendo il formato microsoft.{service}/{resourceType}. Ad esempio: microsoft.storage/storageaccounts.

FiltroQueryReportSommarioElementiPrincipali

Ecco i parametri del filtro di query per configurare TopItemsSummaryReport queries.

Nome Obbligatorio Tipo Descrizione
carbonScopeList Vero EmissionScopeEnum[] Elenco degli ambiti di emissione di carbonio. Obbligatorio. Accetta uno o più valori da EmissionScopeEnum. Ad esempio, Scope1, Scope2, Scope3 nel formato elenco. L'output include le emissioni totali per gli ambiti specificati.
tipoCategoria Vero CategoryTypeEnum Specifica il tipo di categoria per cui recuperare gli elementi con le emissioni più elevate. Vedere i valori supportati definiti in CategoryTypeEnum.
intervallo di date Vero DateRange Date di inizio e fine per i dati sulle emissioni di carbonio. Obbligatorio. Per ItemDetailsReport e TopItemsSummaryReport, è supportato un solo mese di dati alla volta, pertanto le date di inizio e di fine devono essere uguali all'interno DateRangedi . Ad esempio, start: 2024-06-01 e fine: 2024-06-01.
reportType Vero corda:

Rapporto Sommario Articoli Principali		 ReportType ha richiesto i dati sulle emissioni di carbonio. Obbligatorio. Specifica la modalità di aggregazione e visualizzazione dei dati nell'output, come illustrato in ReportTypeEnum.
elenco abbonamenti Conditional string[] ID sottoscrizione per le richieste a livello di sottoscrizione; facoltativo per le richieste a livello di account di fatturazione. Ogni ID deve essere minuscolo, con un limite di 100 sottoscrizioni per ogni richiesta a livello di sottoscrizione. Le richieste a livello di account di fatturazione includono tutte le sottoscrizioni nell'account di fatturazione specificato senza un limite di conteggio delle sottoscrizioni.
elementi principali Vero integer (int32)

minimo: 1
massimo: 10		 Numero di articoli principali da restituire, in base alle emissioni. Questo valore deve essere compreso tra 1 e 10.
locationList string[] Elenco di località (nome visualizzato dell'area di Azure) per i dati sulle emissioni di carbonio, con ogni località specificata in lettere minuscole. Ad esempio: east us. Opzionale. È possibile usare il comando az account list-locations -o table per trovare i nomi visualizzati dell'area di Azure.
resourceGroupUrlList string[] Elenco degli URL del gruppo di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni URL deve seguire il formato /subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}e deve essere in lettere minuscole.
resourceTypeList string[] Elenco dei tipi di risorse per i dati sulle emissioni di carbonio. Opzionale. Ogni tipo di risorsa deve essere specificato in lettere minuscole, seguendo il formato microsoft.{service}/{resourceType}. Ad esempio: microsoft.storage/storageaccounts.

Esempi di report

Le sezioni seguenti illustrano le richieste e le risposte di esempio per ogni tipo di report.

I report a livello di sottoscrizione includono subscriptionAccessDecisionList, che mostra la decisione di accesso per ogni sottoscrizione di origine. I report a livello di account di fatturazione non includono questo campo.

Rapporto di sintesi complessivo

Il report mostra le emissioni totali per tutti gli ambiti delle sottoscrizioni e l'intervallo di date specificato nell'input. Utilizzare il report quando sono necessari i dati del report di alto livello.

Esempio di richiesta

POST https://management.azure.com/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "OverallSummaryReport",
  "subscriptionList": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "carbonScopeList": [
    "Scope1",
    "Scope3"
  ],
  "dateRange": {
    "start": "2024-03-01",
    "end": "2024-05-01"
  }
}

Risposta di esempio

{
  "subscriptionAccessDecisionList": [
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "decision": "Allowed"
    }
  ],
  "value": [
    {
      "dataType": "OverallSummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05
    }
  ]
}

Esempio a livello dell’account di fatturazione

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "OverallSummaryReport",
  "carbonScopeList": ["Scope1", "Scope3"],
  "dateRange": {"start": "2024-03-01", "end": "2024-05-01"}
}

{
  "value": [
    {
      "dataType": "OverallSummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05
    }
  ]
}

ReportMensileDiSintesi

Il report mostra le emissioni per tutte le sottoscrizioni e gli ambiti delle emissioni per il mese specificato nell'intervallo di date. Usare il report quando sono necessari dettagli per un mese specificato.

Esempio di richiesta

POST https://management.azure.com/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "MonthlySummaryReport",
  "subscriptionList": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "carbonScopeList": [
    "Scope1",
    "Scope3"
  ],
  "dateRange": {
    "start": "2024-03-01",
    "end": "2024-05-01"
  }
}

Risposta di esempio

{
  "subscriptionAccessDecisionList": [
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "decision": "Allowed"
    }
  ],
  "value": [
    {
      "dataType": "MonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "date": "2024-05-01",
      "carbonIntensity": 22
    },
    {
      "dataType": "MonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "date": "2024-04-01",
      "carbonIntensity": 22
    },
    {
      "dataType": "MonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "date": "2024-03-01",
      "carbonIntensity": 22
    }
  ]
}

Rapporto Sommario Articoli Principali

Il report mostra le emissioni dei primi X elementi aggregati tra sottoscrizioni, emissioni, ambito, categoria e intervallo di date specificato, suddiviso per categoria. Usare il report quando sono necessari dati per gli elementi principali per categoria.

Esempio di richiesta

POST https://management.azure.com/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "TopItemsSummaryReport",
  "subscriptionList": [
    "00000000-0000-0000-0000-000000000000",
    "00000000-0000-0000-0000-000000000001,",
    "00000000-0000-0000-0000-000000000002",
    "00000000-0000-0000-0000-000000000003",
    "00000000-0000-0000-0000-000000000004",
    "00000000-0000-0000-0000-000000000005",
    "00000000-0000-0000-0000-000000000006",
    "00000000-0000-0000-0000-000000000007",
    "00000000-0000-0000-0000-000000000008"
  ],
  "carbonScopeList": [
    "Scope1",
    "Scope3"
  ],
  "dateRange": {
    "start": "2024-05-01",
    "end": "2024-05-01"
  },
  "categoryType": "Location",
  "topItems": 5
}

Risposta di esempio

{
  "subscriptionAccessDecisionList": [
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000001",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000002",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000003",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000004",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000005",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000006",
      "decision": "Denied"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000007",
      "decision": "Denied"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000008",
      "decision": "Denied",
      "denialReason": "Carbon Optimization Reader permission required"
    }
  ],
  "value": [
    {
      "dataType": "TopItemsSummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "east us",
      "categoryType": "Location"
    },
    {
      "dataType": "TopItemsSummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "west us",
      "categoryType": "Location"
    },
    {
      "dataType": "TopItemsSummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "west us 2",
      "categoryType": "Location"
    },
    {
      "dataType": "TopItemsSummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "west us 3",
      "categoryType": "Location"
    },
    {
      "dataType": "TopItemsSummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "east us 2",
      "categoryType": "Location"
    }
  ]
}

Esempio a livello dell'account di fatturazione

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "TopItemsSummaryReport",
  "carbonScopeList": ["Scope1", "Scope3"],
  "dateRange": {"start": "2024-05-01", "end": "2024-05-01"},
  "categoryType": "Location",
  "topItems": 5
}

{
  "value": [
    {"dataType": "TopItemsSummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "east us", "categoryType": "Location"},
    {"dataType": "TopItemsSummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "west us", "categoryType": "Location"},
    {"dataType": "TopItemsSummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "west us 2", "categoryType": "Location"},
    {"dataType": "TopItemsSummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "west us 3", "categoryType": "Location"},
    {"dataType": "TopItemsSummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "east us 2", "categoryType": "Location"}
  ]
}

Rapporto mensile di riepilogo sugli articoli principali

Il report mostra le emissioni degli elementi X principali aggregati tra sottoscrizioni, emissioni, ambiti e categoria per ogni mese specificato nell'intervallo di date. Le emissioni vengono suddivise per categoria. Gli elementi X principali sono basati sulle emissioni del mese scorso. Usare il report quando sono necessari dati per gli elementi principali per categoria e mese.

Esempio di richiesta

POST https://management.azure.com/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "TopItemsMonthlySummaryReport",
  "subscriptionList": [
    "00000000-0000-0000-0000-000000000000",
    "00000000-0000-0000-0000-000000000001,",
    "00000000-0000-0000-0000-000000000002",
    "00000000-0000-0000-0000-000000000003",
    "00000000-0000-0000-0000-000000000004",
    "00000000-0000-0000-0000-000000000005",
    "00000000-0000-0000-0000-000000000006",
    "00000000-0000-0000-0000-000000000007",
    "00000000-0000-0000-0000-000000000008"
  ],
  "carbonScopeList": [
    "Scope1",
    "Scope3"
  ],
  "dateRange": {
    "start": "2024-03-01",
    "end": "2024-05-01"
  },
  "categoryType": "Location",
  "topItems": 2
}

Risposta di esempio

{
  "subscriptionAccessDecisionList": [
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000001",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000002",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000003",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000004",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000005",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000006",
      "decision": "Denied"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000007",
      "decision": "Denied"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000008",
      "decision": "Denied",
      "denialReason": "Carbon Optimization Reader permission required"
    }
  ],
  "value": [
    {
      "dataType": "TopItemsMonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "east us",
      "categoryType": "Location",
      "date": "2024-05-01"
    },
    {
      "dataType": "TopItemsMonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "east us",
      "categoryType": "Location",
      "date": "2024-04-01"
    },
    {
      "dataType": "TopItemsMonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "east us",
      "categoryType": "Location",
      "date": "2024-03-01"
    },
    {
      "dataType": "TopItemsMonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "west us",
      "categoryType": "Location",
      "date": "2024-05-01"
    },
    {
      "dataType": "TopItemsMonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "west us",
      "categoryType": "Location",
      "date": "2024-04-01"
    },
    {
      "dataType": "TopItemsMonthlySummaryData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "west us",
      "categoryType": "Location",
      "date": "2024-03-01"
    }
  ]
}

Esempio a livello dell'account di fatturazione

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "TopItemsMonthlySummaryReport",
  "carbonScopeList": ["Scope1", "Scope3"],
  "dateRange": {"start": "2024-03-01", "end": "2024-05-01"},
  "categoryType": "Location",
  "topItems": 2
}

{
  "value": [
    {"dataType": "TopItemsMonthlySummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "east us", "categoryType": "Location", "date": "2024-05-01"},
    {"dataType": "TopItemsMonthlySummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "east us", "categoryType": "Location", "date": "2024-04-01"},
    {"dataType": "TopItemsMonthlySummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "east us", "categoryType": "Location", "date": "2024-03-01"},
    {"dataType": "TopItemsMonthlySummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "west us", "categoryType": "Location", "date": "2024-05-01"},
    {"dataType": "TopItemsMonthlySummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "west us", "categoryType": "Location", "date": "2024-04-01"},
    {"dataType": "TopItemsMonthlySummaryData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "west us", "categoryType": "Location", "date": "2024-03-01"}
  ]
}

Rapporto dettagli dell’articolo

Il report mostra le emissioni aggregate tra ambiti selezionati e ID sottoscrizione per un determinato intervallo di date e suddiviso in base alla categoria specificata. Usare il report quando sono necessari dati sulle emissioni per categoria e per ottenere dati a livello di risorsa e gruppo di risorse.

Esempio di richiesta

POST https://management.azure.com/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "ItemDetailsReport",
  "subscriptionList": [
    "00000000-0000-0000-0000-000000000000",
    "00000000-0000-0000-0000-000000000001,",
    "00000000-0000-0000-0000-000000000002",
    "00000000-0000-0000-0000-000000000003",
    "00000000-0000-0000-0000-000000000004",
    "00000000-0000-0000-0000-000000000005",
    "00000000-0000-0000-0000-000000000006",
    "00000000-0000-0000-0000-000000000007",
    "00000000-0000-0000-0000-000000000008"
  ],
  "carbonScopeList": [
    "Scope1",
    "Scope3"
  ],
  "dateRange": {
    "start": "2024-05-01",
    "end": "2024-05-01"
  },
  "categoryType": "Location",
  "orderBy": "LatestMonthEmissions",
  "sortDirection": "Desc",
  "pageSize": 100
}

Risposta di esempio

{
  "subscriptionAccessDecisionList": [
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000001",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000002",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000003",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000004",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000005",
      "decision": "Allowed"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000006",
      "decision": "Denied"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000007",
      "decision": "Denied"
    },
    {
      "subscriptionId": "00000000-0000-0000-0000-000000000008",
      "decision": "Denied",
      "denialReason": "Carbon Optimization Reader permission required"
    }
  ],
  "value": [
    {
      "dataType": "ItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "east us",
      "categoryType": "Location"
    },
    {
      "dataType": "ItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "west us",
      "categoryType": "Location"
    },
    {
      "dataType": "ItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "west us 2",
      "categoryType": "Location"
    },
    {
      "dataType": "ItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "west us 3",
      "categoryType": "Location"
    },
    {
      "dataType": "ItemDetailsData",
      "latestMonthEmissions": 0.1,
      "previousMonthEmissions": 0.05,
      "monthOverMonthEmissionsChangeRatio": 1,
      "monthlyEmissionsChangeValue": 0.05,
      "itemName": "east us 2",
      "categoryType": "Location"
    }
  ]
}

Esempio a livello di account di fatturazione

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2026-05-01-preview

{
  "reportType": "ItemDetailsReport",
  "carbonScopeList": ["Scope1", "Scope3"],
  "dateRange": {"start": "2024-05-01", "end": "2024-05-01"},
  "categoryType": "Location",
  "orderBy": "LatestMonthEmissions",
  "sortDirection": "Desc",
  "pageSize": 100
}

{
  "value": [
    {"dataType": "ItemDetailsData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "east us", "categoryType": "Location"},
    {"dataType": "ItemDetailsData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "west us", "categoryType": "Location"},
    {"dataType": "ItemDetailsData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "west us 2", "categoryType": "Location"},
    {"dataType": "ItemDetailsData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "west us 3", "categoryType": "Location"},
    {"dataType": "ItemDetailsData", "latestMonthEmissions": 0.1, "previousMonthEmissions": 0.05, "monthOverMonthEmissionsChangeRatio": 1, "monthlyEmissionsChangeValue": 0.05, "itemName": "east us 2", "categoryType": "Location"}
  ]
}

Contenuti correlati

  • Ultimo aggiornamento: