Экспорт данных о выбросах выбросов выбросов углерода Azure (предварительная версия)

Экспорт данных о выбросах в CSV-файл с помощью портала Azure

Вы можете экспортировать данные о выбросах в формате CSV на странице "Тенденции выбросов" и на странице "Сведения о выбросах" в оптимизации углерода Azure на портале Azure. Скачайте и проанализируйте данные о выбросах с помощью предпочитаемых средств, таких как Excel или Power BI. Чтобы экспортировать данные о выбросах на этих страницах, выберите Экспорт в CSV-.

Следующие данные доступны в скачанном CSV-файле.

• Тенденции выбросов. Данные за последние 12 месяцев для выбранных фильтров, в том числе:
  • Область 1, 2, 3 и общая выбросы
  • Интенсивность углерода
• Сведения о выбросах
  • Подписка,группа ресурсов/ресурс/служба/расположение
  • Последние выбросы месяца
  • Выбросы за предыдущий месяц
• Сокращение выбросов
  • Рекомендуемые действия по сокращению выбросов

Экспорт данных о выбросах с помощью REST API

Чтобы экспортировать данные о выбросах с помощью REST API, необходимо создать и авторизовать субъект-службу для доступа к данным о выбросах. Затем можно использовать субъект-службу для получения маркера авторизации и экспорта данных о выбросах с помощью REST API.

Создание и авторизация субъекта-службы для экспорта данных о выбросах

Субъект-служба — это приложение, маркеры которого можно использовать для проверки подлинности и предоставления доступа к определенным ресурсам Azure с помощью идентификатора Microsoft Entra (ранее Azure Active Directory). Ресурсы включают пользовательские приложения, службы или средства автоматизации.

1. создание приложения Microsoft Entra и субъекта-службы, которые могут получить доступ к ресурсам.

2. Сохраните идентификатор клиента, новый идентификатор клиента и значение секрета клиента для приложения для использования в запросах маркеров.

3. Приложению необходимо назначить роль Carbon Optimization Reader для ресурсов, для которого требуется экспортировать данные о выбросах. Если вы планируете использовать приложение для экспорта данных о выбросах для многих ресурсов, можно назначить роль на уровне группы ресурсов или подписки. Дополнительные сведения см. в статье Назначение ролей Azure с помощью портала 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 см. в разделе Углеродная служба — список отчетов о выбросах углерода.