Cloud Computing CPU Emissions

Cloud Computing - CPU

Calculate total estimated use-phase emissions based on the electricity usage for a set number of virtual CPU's (vCPUs).

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

We currently support three providers – azure, aws and gcp

Request : Azure CPU

 {
    "cpu_count": 50,
    "region": "korea_south",
    "average_vcpu_utilization": 1,
    "duration": 900,
    "duration_unit": "hour",
    "year": 2022,
    "audit_trail": "enabled"
}

Request Parameters:

Attribute	Type	Description
cpu_count	integer, required	The number of virtual cores you are calculating for. Note that vCPU load is fixed at 50%.
region	string, required	The region that is relevant for the calculation, as specified by the cloud provider.
average_vcpu_utilization	float, optional	The average load across all of your vCPU's specified as a float between 0 and 1. If you have two vCPU's that are both working at 100% efficiency across the calculation duration, you would put in 1. If you have four vCPU's where two are working at 100%, and two are working at 50%, you would put in 0.75 here. Default value is 0.5.
duration	float, required	Amount of time or period for which vCPUs are running for.
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 it’s enabled, then detailed information is shown in the response; if disabled, it gives concise information in the response.

Response : Azure CPU

{
    "co2e": 95.52,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "AZURE (korea_south) CPU",
        "activity_id": "cpu-provider_azure-region_korea_south",
        "id": "4138b5396e6de095f619683c48ac3c3882686139553aac07a2420b06dc545eed",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "KR",
        "category": "Cloud Computing - CPU",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 47.76,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 45000.0,
        "activity_unit": "CPU-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 or not 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 which 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, e.g. if they're from different sources or regions.
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 emitted 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	Description
activity_value	float	The value of the activity.
activity_unit	string	The unit in which the activity value is expressed.

Request : AWS CPU

{
    "cpu_count": 85430,
    "region": "ap_northeast_3",
    "average_vcpu_utilization": 1,
    "duration": 40,
    "duration_unit": "hour",
    "year": 2022,
    "audit_trail": "enabled"
}

Response : AWS CPU

{
    "co2e": 7660.0,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "AWS (ap-northeast-3) CPU",
        "activity_id": "cpu-provider_aws-region_ap_northeast_3",
        "id": "868422f8c89f94b365c3f64468051a5110a94497890153083030d7911e84f707",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "JP-OSA",
        "category": "Cloud Computing - CPU",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 3830.0,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 3417200.0,
        "activity_unit": "CPU-hour"
    },
    "audit_trail": "enabled"
}

Request : GCP CPU

{
    "cpu_count": 700,
    "region": "us_central_1",
    "average_vcpu_utilization": 1,
    "duration": 650,
    "duration_unit": "hour",
    "year": 2021,
    "audit_trail": "enabled"
}

Response : GCP CPU

{
    "co2e": 1515.15,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "GCP (us-central-1) CPU",
        "activity_id": "cpu-provider_gcp-region_us_central_1",
        "id": "718b3509b056a363211376b96fb4409dc875d4a207d99d781e7681d358664aee",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2021,
        "region": "US-IA",
        "category": "Cloud Computing - CPU",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 757.58,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 455000.0,
        "activity_unit": "CPU-hour"
    },
    "audit_trail": "enabled"
}

Cloud Computing - Batch- CPU

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

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

We currently support three providers – azure, aws and gcp

Request : Batch Azure CPU

[
    {
        "cpu_count": 30,
        "region": "uk_west",
        "average_vcpu_utilization": 1,
        "duration": 4000,
        "duration_unit": "min",
        "year": 2021,
        "audit_trail": "enabled"
    },
    {
        "cpu_count": 10,
        "region": "uk_west",
        "average_vcpu_utilization": 0.5,
        "duration": 1,
        "duration_unit": "hour",
        "audit_trail": "enabled"
    },
    {
        "cpu_count": 5,
        "region": "germany",
        "average_vcpu_utilization": 1,
        "duration": 24,
        "duration_unit": "hour",
        "audit_trail": "enabled"
    }
]

Response : Batch Azure CPU

[
    {
        "co2e": 2.31,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (uk-west) CPU",
            "activity_id": "cpu-provider_azure-region_uk_west",
            "id": "61fd448e703da42d08a80cca54c3ff5edfbc78f9fb149131b40870be3a8a9420",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2021,
            "region": "GB-CDF",
            "category": "Cloud Computing - CPU",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 1.16,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 2000.0,
            "activity_unit": "CPU-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.01,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (uk_west) CPU",
            "activity_id": "cpu-provider_azure-region_uk_west",
            "id": "14dee416ce21802629a04e0717c821b974af7ecc69d76167799896aa0575a680",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "GB-CDF",
            "category": "Cloud Computing - CPU",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.0,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 5.0,
            "activity_unit": "CPU-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.21,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (germany) CPU",
            "activity_id": "cpu-provider_azure-region_germany",
            "id": "8706f6938bc73a4b66fbb2727fd416a9e308064f1b671294ff33fb686ce78dd2",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "DE",
            "category": "Cloud Computing - CPU",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.1,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 120.0,
            "activity_unit": "CPU-hour"
        },
        "audit_trail": "enabled"
    }
]

Request : Batch AWS CPU

[
    {
        "cpu_count": 30,
        "region": "eu_central_1",
        "average_vcpu_utilization": 1,
        "duration": 4000,
        "duration_unit": "hour",
        "year": 2021,
        "audit_trail": "enabled"
    },
    {
        "cpu_count": 10,
        "region": "sa_east_1",
        "average_vcpu_utilization": 0.5,
        "duration": 1,
        "duration_unit": "hour",
        "audit_trail": "enabled"
    },
    {
        "cpu_count": 5,
        "region": "ca_central_1",
        "average_vcpu_utilization": 1,
        "duration": 24,
        "duration_unit": "hour",
        "audit_trail": "enabled"
    }
]

Response : Batch AWS CPU

[
    {
        "co2e": 191.97,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (eu-central-1) CPU",
            "activity_id": "cpu-provider_aws-region_eu_central_1",
            "id": "2a6244a7fd54b018281931c6a1d44674694b7d89e7a761c112bfce886a45e3bd",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2021,
            "region": "DE-FRA",
            "category": "Cloud Computing - CPU",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 95.98,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 120000.0,
            "activity_unit": "CPU-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.0,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (sa-east-1) CPU",
            "activity_id": "cpu-provider_aws-region_sa_east_1",
            "id": "71bd88d013488312489d91caca8d78885da28da5c89e1c32b4e747ce72597d03",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "BR-SAO",
            "category": "Cloud Computing - CPU",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.0,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 5.0,
            "activity_unit": "CPU-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.07,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (ca-central-1) CPU",
            "activity_id": "cpu-provider_aws-region_ca_central_1",
            "id": "7c2527727aed45b1b982eb75c57e3ac8140db043a13e0987ca75d8b5356203ce",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "CA-MTR",
            "category": "Cloud Computing - CPU",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.03,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 120.0,
            "activity_unit": "CPU-hour"
        },
        "audit_trail": "enabled"
    }
]

Request : Batch GCP CPU

[
    {
        "cpu_count": 300,
        "region": "asia_east_1",
        "average_vcpu_utilization": 1,
        "duration": 4000,
        "duration_unit": "hour",
        "year": 2022,
        "audit_trail": "enabled"
    },
    {
        "cpu_count": 150,
        "region": "asia_northeast_1",
        "average_vcpu_utilization": 1,
        "duration": 10,
        "duration_unit": "hour",
        "year": 2022,
        "audit_trail": "enabled"
    },
    {
        "cpu_count": 75,
        "region": "asia_northeast_3",
        "average_vcpu_utilization": 1,
        "duration": 40,
        "duration_unit": "hour",
        "year": 2022,
        "audit_trail": "enabled"
    }
]

Response : Batch GCP CPU

[
    {
        "co2e": 3542.64,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP (asia-east-1) CPU",
            "activity_id": "cpu-provider_gcp-region_asia_east_1",
            "id": "37def5258f85209f74fc33e7c1beb8bace1460a70f68601cd4c65d8cbf003384",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "TW",
            "category": "Cloud Computing - CPU",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 1771.32,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 1200000.0,
            "activity_unit": "CPU-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 4.0,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP CFE (asia_northeast_1) CPU",
            "activity_id": "cpu-provider_gcp_cfe-region_asia_northeast_1",
            "id": "46397a3b4b0553629a7a357fddc9e32925d74b073f66dd711cf61b84bff20216",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "JP-TYO",
            "category": "Cloud Computing - CPU",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 2.0,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 1500.0,
            "activity_unit": "CPU-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 5.17,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP CFE (asia_northeast_3) CPU",
            "activity_id": "cpu-provider_gcp_cfe-region_asia_northeast_3",
            "id": "aff9630149eadc13ade8e86c29bc67f14c604cee57ff955a81d94bd6e5f30d47",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "KR-SEL",
            "category": "Cloud Computing - CPU",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 2.59,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 3000.0,
            "activity_unit": "CPU-hour"
        },
        "audit_trail": "enabled"
    }
]