Exporter les données d’émissions d’optimisation du carbone Azure (préversion)

Exporter des données d’émission vers un fichier CSV à l’aide du portail Azure

Vous pouvez exporter vos données d’émissions au format CSV à partir de la page Tendances des émissions et de la page Détails des émissions dans l’optimisation carbone Azure dans le portail Azure. Téléchargez et analysez vos données d’émissions à l’aide de vos outils préférés, tels qu’Excel ou Power BI. Pour exporter des données d’émission à partir de ces pages, sélectionnez l'Exporter vers le fichier CSV.

Les données suivantes sont disponibles dans un fichier CSV téléchargé.

• Tendances des émissions. Données des 12 derniers mois pour les filtres sélectionnés, notamment :
  • Étendue 1, 2, 3 et émissions totales
  • Intensité carbone
• Détails des émissions
  • Abonnement/Groupe de ressources/Ressource/Service/Emplacement
  • Émissions du dernier mois
  • Émissions du mois précédent
• Réductions des émissions
  • Actions recommandées pour réduire les émissions

Exporter des données d’émission à l’aide de l’API REST

Pour exporter des données d’émission à l’aide de l’API REST, vous devez créer et autoriser un principal de service à accéder à vos données d’émission. Vous pouvez ensuite utiliser le principal de service pour obtenir un jeton d’autorisation, puis exporter des données d’émission à l’aide de l’API REST.

Créer et autoriser un principal de service à exporter des données d’émission

Un principal de service est une application dont les jetons peuvent être utilisés pour authentifier et accorder l’accès à des ressources Azure spécifiques à l’aide de l’ID Microsoft Entra (anciennement Azure Active Directory). Les ressources incluent des applications utilisateur, des services ou des outils d’automatisation.

1. Créer une application Microsoft Entra et un principal de service qui peuvent accéder aux ressources.

2. Enregistrez l’ID de locataire, le nouvel ID client et la valeur de clé secrète client pour votre application à utiliser dans les demandes de jetons.

3. L’application doit être affectée au rôle Carbon Optimization Reader pour les ressources pour lesquelles vous souhaitez exporter les données d’émission. Si vous envisagez d’utiliser l’application pour exporter des données d’émission pour de nombreuses ressources, vous pouvez attribuer le rôle au niveau du groupe de ressources ou de l’abonnement. Pour plus d’informations, consultez Attribuer des rôles Azure à l’aide du portail Azure.

Obtenir un jeton d’autorisation

Envoyez la requête suivante dans l’invite de commandes ou à l’aide d’un client comme 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'

Le corps de la réponse s’affiche :

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

Utilisez le jeton d’accès à partir de la réponse à utiliser dans les requêtes HTTP suivantes.

Exporter des données d’émission à l’aide de l’API REST

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

Exemple de requête

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

exemple 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"
    }
}
'

Exemple de sortie

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

Types de rapports

Exporter les paramètres de l’API d’émission

Le tableau suivant décrit les paramètres que vous pouvez utiliser pour exporter des données d’émission à l’aide de l’API REST.

Paramètres spécifiques au rapport

Le tableau suivant présente des paramètres supplémentaires requis pour chaque type de rapport.

Ordre par colonnes

Les colonnes de résultats suivantes prennent en charge le paramètre orderBy.

Pour plus d’informations sur les rapports de l’API REST, consultez Service carbone - Répertorier les rapports d’émission de carbone.