Exportar dados de emissões de otimização de carbono do Azure (versão prévia)

Exportar dados de emissões para um arquivo CSV usando o portal do Azure

Você pode exportar seus dados de emissões no formato CSV da página Tendências de Emissões e da página Detalhes de Emissões na otimização de carbono do Azure no portal do Azure. Baixe e analise seus dados de emissões usando suas ferramentas preferenciais, como Excel ou Power BI. Para exportar dados de emissões dessas páginas, selecione o Exportar para o CSV.

Os dados a seguir estão disponíveis em um arquivo CSV baixado.

• Tendências de emissões. Os dados dos últimos 12 meses para os filtros selecionados, incluindo:
  • Escopo 1, 2, 3 e emissões totais
  • Intensidade de carbono
• Detalhes de emissões
  • Assinatura/Grupo de Recursos/Recurso/Serviço/Local
  • Emissões do último mês
  • Emissões do mês anterior
• Reduções de emissões
  • Ações recomendadas para reduzir as emissões

Exportar dados de emissões usando a API REST

Para exportar dados de emissões usando a API REST, você deve criar e autorizar uma entidade de serviço a acessar seus dados de emissões. Em seguida, você pode usar a entidade de serviço para obter um token de autorização e exportar dados de emissões usando a API REST.

Criar e autorizar uma entidade de serviço para exportar dados de emissões

Uma entidade de serviço é um aplicativo cujos tokens podem ser usados para autenticar e conceder acesso a recursos específicos do Azure usando a ID do Microsoft Entra (anteriormente do Azure Active Directory). Os recursos incluem aplicativos de usuário, serviços ou ferramentas de automação.

1. Criar um aplicativo do Microsoft Entra e uma entidade de serviço que possa acessar recursos.

2. Salve a ID do locatário, a nova ID do cliente e o valor do segredo do cliente para seu aplicativo para uso em solicitações de token.

3. O aplicativo deve receber a função Carbon Optimization Reader para os recursos para os quais você deseja exportar dados de emissões. Se você planeja usar o aplicativo para exportar dados de emissões para muitos recursos, poderá atribuir a função no nível do grupo de recursos ou da assinatura. Para obter mais informações, consulte Atribuir funções do Azure usando o portal do Azure.

Obter um token de autorização

Envie a solicitação a seguir no prompt de comando ou usando um cliente como o 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'

O corpo da resposta é exibido:

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

Use o token de acesso da resposta para uso nas solicitações HTTP a seguir.

Exportar dados de emissões usando a API REST

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

Solicitação de exemplo

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

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

Saída de exemplo

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

Tipos de relatório

Exportar parâmetros de API de emissões

A tabela a seguir descreve os parâmetros que você pode usar para exportar dados de emissões usando a API REST.

Parâmetros específicos do relatório

A tabela a seguir mostra parâmetros adicionais que são necessários para cada tipo de relatório.

Ordenar por colunas

As colunas de resultado a seguir dão suporte ao parâmetro orderBy.

Para obter mais informações sobre os relatórios da API REST, consulte Carbon Service – List Carbon Emission Reports.