Azure カーボン最適化の排出量データをエクスポートする (プレビュー)

Azure portal を使用して排出量データを CSV ファイルにエクスポートする

排出量データは、Azure portal の Azure カーボン最適化の [排出量の傾向] ページと [排出量の詳細] ページから CSV 形式でエクスポートできます。 Excel や Power BI などの任意のツールを使用して、排出量データをダウンロードして分析します。 これらのページから排出量データをエクスポートするには、[CSV にエクスポート] を選択します。

ダウンロードした CSV ファイルでは、次のデータを使用できます。

• 排出量の傾向。 選択したフィルターの過去 12 か月のデータ。次のものが含まれます。
  • スコープ 1、2、3、および総排出量
  • 炭素強度
• 排出量の詳細
  • サブスクリプション/リソース グループ/リソース/サービス/場所
  • 最新の月の排出量
  • 前月の排出量
• 排出量削減
  • 排出削減に向けて推奨されるアクション

REST API を使用して排出データをエクスポートする

REST API を使用して排出量データをエクスポートするには、サービス プリンシパルを作成して承認して、排出量データにアクセスする必要があります。 その後、サービス プリンシパルを使用して承認トークンを取得し、REST API を使用して排出量データをエクスポートできます。

排出量データをエクスポートするサービス プリンシパルを作成して承認する

サービス プリンシパルは、Microsoft Entra ID (以前は Azure Active Directory ) を使用して、トークンを使用して特定の Azure リソースへのアクセスを認証および付与できるアプリケーションです。 リソースには、ユーザー アプリ、サービス、または自動化ツールが含まれます。

1. リソースにアクセスできる Microsoft Entra アプリケーションとサービス プリンシパル を作成します。

2. トークン要求で使用するために、アプリのテナント ID、新しいクライアント ID、クライアント シークレットの値を保存します。

3. アプリには、排出量データをエクスポートするリソースの Carbon Optimization Reader ロールが割り当てられている必要があります。 アプリを使用して多くのリソースの排出量データをエクスポートする場合は、リソース グループまたはサブスクリプション レベルでロールを割り当てることができます。 詳細については、Azure portalを使用した Azure ロールの割り当て に関するページを参照してください。

承認トークンを取得する

コマンド プロンプトで、または 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'

応答本文が表示されます。

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

次の HTTP 要求で使用するために、応答からのアクセス トークンを使用します。

REST API を使用して排出データをエクスポートする

POST /providers/Microsoft.Carbon/carbonEmissionReports?api-version=2023-04-01-preview Host: management.azure.com Content-Type: application/json Authorization: Bearer <トークン値>

要求の例

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

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

サンプル出力

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

レポートの種類

出力 API パラメーターをエクスポートする

次の表では、REST API を使用して排出量データをエクスポートするために使用できるパラメーターについて説明します。

レポート固有のパラメーター

次の表は、各レポートの種類に必要な追加のパラメーターを示しています。

列別に並べ替え

次の結果列は、orderBy パラメーターをサポートしています。

REST API レポートの詳細については、「Carbon Service - List Carbon Emission Reports」を参照してください。