sustainability/aws.sdk.kotlin.services.sustainability/SustainabilityClient/getEstimatedCarbonEmissions

getEstimatedCarbonEmissions

abstract suspend fun getEstimatedCarbonEmissions(input: GetEstimatedCarbonEmissionsRequest): GetEstimatedCarbonEmissionsResponse

Returns estimated carbon emission values based on customer grouping and filtering parameters. We recommend using pagination to ensure that the operation returns quickly and successfully.

Samples

import aws.sdk.kotlin.services.sustainability.model.Dimension
import aws.sdk.kotlin.services.sustainability.model.EmissionsType
import aws.sdk.kotlin.services.sustainability.model.TimeGranularity
import aws.sdk.kotlin.services.sustainability.model.TimePeriod

fun main() { 
   //sampleStart 
   // GetEstimatedCarbonEmissionsSuccess
val resp = sustainabilityClient.getEstimatedCarbonEmissions {
    timePeriod = TimePeriod {
        start = "2025-01-01T00:00:00.000Z"
        end = "2025-12-31T23:59:59.999Z"
    }
    groupBy = listOf<Dimension>(
        Dimension.fromValue("SERVICE")
    )
    emissionsTypes = listOf<EmissionsType>(
        EmissionsType.fromValue("TOTAL_LBM_CARBON_EMISSIONS"),
        EmissionsType.fromValue("TOTAL_MBM_CARBON_EMISSIONS"),
        EmissionsType.fromValue("TOTAL_SCOPE_1_CARBON_EMISSIONS"),
        EmissionsType.fromValue("TOTAL_SCOPE_2_LBM_CARBON_EMISSIONS"),
        EmissionsType.fromValue("TOTAL_SCOPE_2_MBM_CARBON_EMISSIONS"),
        EmissionsType.fromValue("TOTAL_SCOPE_3_LBM_CARBON_EMISSIONS"),
        EmissionsType.fromValue("TOTAL_SCOPE_3_MBM_CARBON_EMISSIONS")
    )
    granularity = TimeGranularity.fromValue("MONTHLY")
} 
   //sampleEnd
}