Cloud Computing Memory Emissions

Cloud Computing - Memory

Calculate total estimated use-phase emissions based on the electricity consumption of having memory (RAM) available for a set amount of time.

EndPoint : POST -/compute/{provider_id}/memory

We currently support three providers – azure, aws and gcp

Request : Azure Memory

{
    "region": "france_central",
    "data": 450,
    "data_unit": "TB",
    "duration": 49,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
}

Request Parameters:

Attribute	Type	Description
region	string, required	The region that is relevant for the calculation, as specified by the cloud provider.
data	float, required	How much memory you have allocated. As memory requires power to be available even if unused, you should put in the amount of memory that you have available - not only the amount you're using.
data_unit	string, optional	Unit of Data. Accepted values are GB, KB, MB, PB, and TB.
duration	float, required	How long the memory is available.
duration_unit	string, optional	Unit of duration/time. Accepted values are hour, min, and sec. Default unit is hour.
year	integer, optional	The year that the computing resources were used.
audit_trail	string, optional	Valid values are 'enabled' or 'disabled'. If enabled, detailed information is shown in the response, and if disabled, it gives concise information in the response.

Response : Azure Memory

{
    "co2e": 498.33,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "AZURE (france_central) memory",
        "activity_id": "memory-provider_azure-region_france_central",
        "id": "82b712ac610d64b90336776471fc8cea4f14a002065bd0810e4bef55047c4caa",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "FR-PAR",
        "category": "Cloud Computing - Memory",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 498.33,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 22050000.0,
        "activity_unit": "GB-hour"
    },
    "audit_trail": "enabled"
}

Response Parameters:

Attribute	Type	Description
co2e	float	Emission factor carbon dioxide equivalent.
co2e_unit	string	The unit in which the co2e field is expressed.
co2e_calculation_method	string	Which calculation methodology was used for the calculation.
co2e_calculation_origin	string	Whether the data source or EarthEmission made the calculation.
emission_factor	Object	The emission factor that was used for the calculation.
constituent_gases	Object	Indicates which constituent gases the emission factor is composed of.
activity_data	Object	Indicates the parameters that were multiplied by the factor to estimate emissions.
audit_trail	string	Indicates whether Audit trail was enabled for this request.

Emission Factor:

Attribute	Type	Description
name	string	Emission factor name.
id	string	Unique ID for this emission factor.
activity_id	string	ID for the activity the emission factor applies to. Multiple factors can share the same activity_id.
factor	float	The emission factor value, indicating the amount of emissions in kg per unit of activity.
access_type	string	Data access type: private or public. Public factors are available to all, while private factors are only accessible to you.
source	string	Emission factor publisher.
source_dataset	string	Dataset published by the source.
year	integer	Most relevant year for the emission factor according to the source.
region	string	Geographic region the emission factor applies to.
category	string	Emission factor category.
source_lca_activity	string	Associated Life Cycle Assessment (LCA) activity.
data_quality_flags	string	List of data quality flags for this emission factor. An empty list means no detected data quality issues.

Constituent Gases:

Attribute	Type	Description
co2e_total	float or null	The total amount of GHG emitted per unit of activity expressed as kgCO2e, as reported by the source. It is null for EarthEmission-performed calculations.
co2e_other	float or null	The total amount of GHG emitted that are not CO2, CH4, or N20 - expressed in kgCO2e per unit of activity, as reported by the source.
co2	float or null	The amount of carbon dioxide (CO2) emitted per unit of activity expressed as kgCO2, as reported by the source.
ch4	float or null	The amount of methane (CH4) emitted per unit of activity expressed as kgCH4, as reported by the source.
n2o	float or null	The amount of nitrous oxide (N2O) emitted per unit of activity expressed as kgN2O, as reported by the source.

Activity Data:

Attribute	Type
activity_value	float
activity_unit	string

Request : AWS Memory

{
    "region": "eu_west_3",
    "data": 8760,
    "data_unit": "GB", 
    "duration": 150,
    "duration_unit": "hour",
    "year": 2022,
    "audit_trail": "enabled"
}

Response : AWS Memory

{
    "co2e": 29.83,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "AWS (eu-west-3) memory",
        "activity_id": "memory-provider_aws-region_eu_west_3",
        "id": "e6042c90f6d1d8aec325bb8d63672aaf0e883896dda51d7057d03555ce80df90",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "FR-PAR",
        "category": "Cloud Computing - Memory",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 29.83,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 1314000.0,
        "activity_unit": "GB-hour"
    },
    "audit_trail": "enabled"
}

Request : GCP Memory

{
    "region": "asia_northeast_2",
    "data": 50,
    "data_unit": "GB",
    "duration": 10000,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
}

Response : GCP Memory

{
    "co2e": 95.3,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "GCP (asia-northeast-2) memory",
        "activity_id": "memory-provider_gcp-region_asia_northeast_2",
        "id": "03e228e61201dd5e4c38cd4444d72878baf68cb7b6fc93a557bdeb18dbee0f52",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "JP-OSA",
        "category": "Cloud Computing - Memory",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 95.3,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 500000.0,
        "activity_unit": "GB-hour"
    },
    "audit_trail": "enabled"
}

Cloud Computing - Batch - Memory

For bulk data-processing, the Cloud Computing – Memory has a batch endpoint variant allowing for multiple calculations with one API call.

EndPoint : POST -/compute/{provider_id}/memory/batch

We currently support three providers – azure, aws and gcp

Request : Batch Azure Memory

[
{
    "region": "australia",
    "data": 230,
    "data_unit": "TB",
    "duration": 120,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "brazil",
    "data": 3200,
    "data_unit": "TB",
    "duration": 45,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "canada",
    "data": 650,
    "data_unit": "TB",
    "duration": 40,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
}
]

Response : Batch Azure Memory

[
    {
        "co2e": 9615.84,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (australia) memory",
            "activity_id": "memory-provider_azure-region_australia",
            "id": "dd4e763464b81fc5a9f2d595090bd44a98da19d8abe4c97e052660b9bcce8f0b",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "AU",
            "category": "Cloud Computing - Memory",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 9615.84,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 27600000.0,
            "activity_unit": "GB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 3916.8,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (brazil) memory",
            "activity_id": "memory-provider_azure-region_brazil",
            "id": "1d2e34b98e4b6f27972bb5e19108b718f33c8e261b9fbc4d99cfba915c63b61b",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "BR",
            "category": "Cloud Computing - Memory",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 3916.8,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 144000000.0,
            "activity_unit": "GB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 1375.4,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (canada) memory",
            "activity_id": "memory-provider_azure-region_canada",
            "id": "da13d10704e788f77d346745b3b26cadceb1710039c1a27970174fc8007b27c7",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "CA",
            "category": "Cloud Computing - Memory",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 1375.4,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 26000000.0,
            "activity_unit": "GB-hour"
        },
        "audit_trail": "enabled"
    }
]

Request : Batch AWS Memory

[
{
    "region": "eu_west_3",
    "data": 5200,
    "data_unit": "GB",
    "duration": 20,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "me_south_1",
    "data": 200,
    "data_unit": "GB",
    "duration": 45,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "sa_east_1",
    "data": 6500,
    "data_unit": "GB",
    "duration": 40,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
}
]

Response : Batch AWS Memory

[
    {
        "co2e": 2.36,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (eu-west-3) memory",
            "activity_id": "memory-provider_aws-region_eu_west_3",
            "id": "e6042c90f6d1d8aec325bb8d63672aaf0e883896dda51d7057d03555ce80df90",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "FR-PAR",
            "category": "Cloud Computing - Memory",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 2.36,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 104000.0,
            "activity_unit": "GB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 2.03,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (me-south-1) memory",
            "activity_id": "memory-provider_aws-region_me_south_1",
            "id": "188d575f3900755faed173af0764f0bcb7e7772fe8bc66b020a6ceb8507784fb",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "BH-AMH",
            "category": "Cloud Computing - Memory",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 2.03,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 9000.0,
            "activity_unit": "GB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 7.15,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (sa-east-1) memory",
            "activity_id": "memory-provider_aws-region_sa_east_1",
            "id": "99ac98f958210c82348075ddea1c1ba4a3a5cdcc97685b2503a0f199ef9c309e",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "BR-SAO",
            "category": "Cloud Computing - Memory",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 7.15,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 260000.0,
            "activity_unit": "GB-hour"
        },
        "audit_trail": "enabled"
    }
]

Request : Batch GCP Memory

[
{
    "region": "asia_east_1",
    "data": 5200,
    "data_unit": "GB",
    "duration": 20,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "asia_east_2",
    "data": 200,
    "data_unit": "GB",
    "duration": 45,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "asia_northeast_1",
    "data": 6500,
    "data_unit": "GB",
    "duration": 40,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
}
]

Response : Batch GCP Memory

[
    {
        "co2e": 19.85,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP CFE (asia_east_1) memory",
            "activity_id": "memory-provider_gcp_cfe-region_asia_east_1",
            "id": "6a8268b2a05d6ad6347e49e51b9b7b2394ffdc872ed46dbc430a9ca94a9d0134",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "TW",
            "category": "Cloud Computing - Memory",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 19.85,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 104000.0,
            "activity_unit": "GB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 1.76,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP (asia-east-2) memory",
            "activity_id": "memory-provider_gcp-region_asia_east_2",
            "id": "55a977100990823b71346bc8c7ff12bda8dbc9c3c1c08520d3be5da57ed44a2a",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "HK-HKG",
            "category": "Cloud Computing - Memory",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 1.76,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 9000.0,
            "activity_unit": "GB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 54.65,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP CFE (asia_northeast_1) memory",
            "activity_id": "memory-provider_gcp_cfe-region_asia_northeast_1",
            "id": "622e852e3d6fd31fe7686b18b496be2fe220898ada8c6c970d177f8fb6db4749",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "JP-TYO",
            "category": "Cloud Computing - Memory",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 54.65,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 260000.0,
            "activity_unit": "GB-hour"
        },
        "audit_trail": "enabled"
    }
]