Esportare i dati sulle emissioni di ottimizzazione delle emissioni di carbonio di Azure (anteprima)

Esportare i dati sulle emissioni in un file CSV usando il portale di Azure

È possibile esportare i dati sulle emissioni in formato CSV dalla pagina Tendenze emissioni e dalla pagina Dettagli emissioni in Ottimizzazione carbonio di Azure nel portale di Azure. Scaricare e analizzare i dati sulle emissioni usando gli strumenti preferiti, ad esempio Excel o Power BI. Per esportare i dati sulle emissioni da queste pagine, selezionare l'Esporta in CSV.

I dati seguenti sono disponibili in un file CSV scaricato.

• Tendenze delle emissioni. I dati degli ultimi 12 mesi per i filtri selezionati, tra cui:
  • Ambito 1, 2, 3 e emissioni totali
  • Intensità di carbonio
• Dettagli sulle emissioni
  • Sottoscrizione/Gruppo di risorse/Risorsa/Servizio/Località
  • Emissioni del mese più recenti
  • Emissioni del mese precedente
• Riduzioni delle emissioni
  • Azioni consigliate per ridurre le emissioni

Esportare i dati sulle emissioni usando l'API REST

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'entità servizio a esportare i dati sulle emissioni

Un'entità servizio è un'applicazione i cui token possono essere usati per autenticare e concedere l'accesso a risorse di Azure specifiche usando Microsoft Entra ID (in precedenza Azure Active Directory). Le risorse includono app utente, servizi o strumenti di automazione.

1. Creare un'applicazione Microsoft Entra e un'entità servizio che possano accedere alle risorse.

2. Salvare l'ID tenant, il nuovo ID client e il valore del segreto client per l'app da usare nelle richieste di token.

3. All'app deve essere assegnato il ruolo Carbon Optimization Reader per le risorse per cui si vogliono esportare i dati sulle emissioni. Se si prevede di usare l'app per esportare i dati sulle emissioni per molte risorse, è possibile assegnare il ruolo a livello di gruppo di risorse o sottoscrizione. Per altre informazioni, vedere Assegnare ruoli di Azure usando il portale di Azure.

Ottenere un token di autorizzazione

Inviare la richiesta seguente al prompt dei comandi o usando un client come Postman.

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'

Viene visualizzato il corpo della risposta:

{
    "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

POST /providers/Microsoft.Carbon/carbonEmissionReports?api-version=2023-04-01-preview Host: management.azure.com Content-Type: application/json Authorization: Bearer <valore del token>

Richiesta di esempio

POST /providers/Microsoft.Carbon/carbonEmissionReports?api-version=2023-04-01-preview
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKJ...gVBNrsvg

{
    "reportType": "OverallSummaryReport",
    "subscriptionList": [
        "abcd1234-a1b2-d3c4-e3f5-976543210abc"
    ],
    "carbonScopeList": [
        "Scope1",
        "Scope2",
        "Scope3"
    ],
    "dateRange": {
        "start": "2023-12-01",
        "end": "2023-12-01"
    }
}

Esempio curl:

curl --location 'https://management.azure.com/providers/Microsoft.Carbon/carbonEmissionReports?api-version=2023-04-01-preview' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJ0eXA...2-KgVBNrsvg' \
--data '{
    "reportType": "OverallSummaryReport",
    "subscriptionList": [
        "abcd1234-a1b2-d3c4-e3f5-976543210abc"
    ],
    "carbonScopeList": [
        "Scope1",
        "Scope2",
        "Scope3"
    ],
    "dateRange": {
        "start": "2023-12-01",
        "end": "2023-12-01"
    }
}
'

Output di esempio

{
    "value": [
        {
            "dataType": "OverallSummaryData",
            "totalCarbonEmission": 7000.622265493289,
            "totalCarbonEmission12MonthsAgo": 0,
            "totalCarbonEmissionLastMonth": 7480.374908590786,
            "changeRatioFor12Months": 0,
            "changeRatioForLastMonth": -0.06413483935765417,
            "changeValueMonthOverMonth": 0
        }
    ]
}

Tipi di report

Esportare i parametri dell'API per le emissioni

La tabella seguente descrive i parametri che è possibile usare per esportare i dati sulle emissioni tramite l'API REST.

Parametri specifici del report

La tabella seguente mostra parametri aggiuntivi necessari per ogni tipo di report.

Ordina per colonne

Le colonne dei risultati seguenti supportano il parametro orderBy.

Per altre informazioni sui report dell'API REST, vedere Carbon Service - Elencare i report sulle emissioni di carbonio.