Cloud Computing Networking Emissions

Cloud Computing - Networking

This endpoint calculates the carbon emissions associated with network usage for a given provider ID.

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

We currently support three providers – azure, aws and gcp

Request : Azure Networking

{
    "region": "east_asia",
    "data": 1000,
    "data_unit": "GB",
    "year": 2021,
    "audit_trail": "enabled"
}

Request Parameters:

Attribute	Type	Description
region	string, required	Data center region name as specified by provider.
data	float, required	Data size for networking process.
data_unit	string, optional	Unit of Data. Accepted values are GB, KB, MB, PB, and TB.
year	integer, optional	The year in which the networking usage occurred.
audit_trail	string, optional	Valid values are 'enabled' or 'disabled'. If enabled, detailed information is shown in the response; if disabled, concise information is provided.

Response : Azure Networking

 
{
    "co2e": 0.91,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "AZURE (east-asia) networking",
        "activity_id": "networking-provider_azure-region_east_asia",
        "id": "83a888d9dbcf32daaebc251266ac8d4ad9d5d8236216f56b4b8b7a469dd4f3da",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2021,
        "region": "HK-HKG",
        "category": "Cloud Computing - Networking",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 0.91,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 1000.0,
        "activity_unit": "GB"
    },
    "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 which were multiplied by the factor to estimate emissions.
audit_trail	string	Indicates whether the 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.
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
activity_value	float
activity_unit	string

Request : AWS Networking

{
    "region": "ap_northeast_2",
    "data": 450,
    "data_unit": "GB",
    "year": 2022,
    "audit_trail": "enabled"
}

Response : AWS Networking

{
    "co2e": 0.21,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "AWS (ap-northeast-2) networking",
        "activity_id": "networking-provider_aws-region_ap_northeast_2",
        "id": "30fb0cd7084a41375af761fc15632082756c5a3c87d878e2cfe76fa228465ccb",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "KR-SEL",
        "category": "Cloud Computing - Networking",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 0.21,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 450.0,
        "activity_unit": "GB"
    },
    "audit_trail": "enabled"
}

Request : GCP Networking

{
    "region": "europe_central_2",
    "data":  590,
    "data_unit": "GB",
    "year": 2022,
    "audit_trail": "enabled"
}

Response : GCP Networking

{
    "co2e": 0.4,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "GCP CFE (europe_central_2) networking",
        "activity_id": "networking-provider_gcp_cfe-region_europe_central_2",
        "id": "e87be37565598985c7269b2e6589a1265d5754e1e13fa1925d91f77bb18cef70",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "PL-WAW",
        "category": "Cloud Computing - Networking",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 0.4,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 590.0,
        "activity_unit": "GB"
    },
    "audit_trail": "enabled"
}

Cloud Computing - Batch- Networking

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

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

We currently support three providers – azure, aws and gcp

Request : Batch Azure Networking

[
    {
        "region": "germany_west_central",
        "data": 4000,
        "data_unit": "GB",
        "year": 2022,
        "audit_trail": "enabled"
    },
    {
        "region": "uk",
        "data": 1,
        "data_unit": "GB",
        "year": 2022,
        "audit_trail": "enabled"
    },
    {
        "region": "canada_central",
        "data": 24,
        "data_unit": "GB",
        "year": 2022,
        "audit_trail": "enabled"
    }
]

Response : Batch Azure Networking

[
    {
        "co2e": 1.52,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (germany_west_central) networking",
            "activity_id": "networking-provider_azure-region_germany_west_central",
            "id": "9fbc9434b5b20f421791609b1ac63df362b4c3d844167471cadac6ace0ef36d2",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "DE-FRA",
            "category": "Cloud Computing - Networking",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 1.52,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 4000.0,
            "activity_unit": "GB"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.0,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (uk) networking",
            "activity_id": "networking-provider_azure-region_uk",
            "id": "a225f5fa98847438fbb83ef0f1c1894a8b6bfbe32f408140b9a359b4a85fc8e1",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "GB",
            "category": "Cloud Computing - Networking",
            "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": 1.0,
            "activity_unit": "GB"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.0,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (canada_central) networking",
            "activity_id": "networking-provider_azure-region_canada_central",
            "id": "cc37f4cdb0a953c24ee189c9a8e55d1d49ea6cb51e0b993a6434b83700764d4b",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "CA-TOR",
            "category": "Cloud Computing - Networking",
            "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": 24.0,
            "activity_unit": "GB"
        },
        "audit_trail": "enabled"
    }
]

Request : Batch AWS Networking

[
    {
        "region": "me_south_1",
        "data": 600,
        "data_unit": "GB",
        "year": 2021,
        "audit_trail": "enabled"
    },
    {
        "region": "eu_central_1",
        "data": 400,
        "data_unit": "GB",
        "year": 2021,
        "audit_trail": "enabled"
    },
    {
        "region": "ap_northeast_2",
        "data": 8500,
        "data_unit": "GB",
        "year": 2021,
        "audit_trail": "enabled"
    }
]

Response : Batch AWS Networking

[
    {
        "co2e": 0.5,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (me-south-1) networking",
            "activity_id": "networking-provider_aws-region_me_south_1",
            "id": "114d198cc6fc7f2a72849cf18cf59ceb40e4d0ad3fb63dc9661510c122d55083",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2021,
            "region": "BH-AMH",
            "category": "Cloud Computing - Networking",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.5,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 600.0,
            "activity_unit": "GB"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.15,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (eu-central-1) networking",
            "activity_id": "networking-provider_aws-region_eu_central_1",
            "id": "33ba5d331197fd7649d6d44149abad07045578cc5461e9389414128f7d0d9e43",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2021,
            "region": "DE-FRA",
            "category": "Cloud Computing - Networking",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.15,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 400.0,
            "activity_unit": "GB"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 4.82,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (ap-northeast-2) networking",
            "activity_id": "networking-provider_aws-region_ap_northeast_2",
            "id": "214566a0a10408e446de9c4f966f001f3f5cb48feb376687166bc3b4dd1cdecf",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2021,
            "region": "KR-SEL",
            "category": "Cloud Computing - Networking",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 4.82,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 8500.0,
            "activity_unit": "GB"
        },
        "audit_trail": "enabled"
    }
]

Request : Batch GCP Networking

[
    {
        "region": "australia_southeast_2",
        "data": 600,
        "data_unit": "GB",
        "year": 2022,
        "audit_trail": "enabled"
    },
    {
        "region": "europe_west_3",
        "data": 400,
        "data_unit": "GB",
        "year": 2022,
        "audit_trail": "enabled"
    },
    {
        "region": "us_west_1",
        "data": 8500,
        "data_unit": "GB",
        "year": 2022,
        "audit_trail": "enabled"
    }
]

Response : Batch GCP Networking

[
    {
        "co2e": 0.46,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP (australia_southeast_2) networking",
            "activity_id": "networking-provider_gcp-region_australia_southeast_2",
            "id": "06bbd719edb941cdf89a6929c679c6d86c2dfbe9d05e4e927b5b9efd6c003d90",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "AU-MEL",
            "category": "Cloud Computing - Networking",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.46,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 600.0,
            "activity_unit": "GB"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.05,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP CFE (europe_west_3) networking",
            "activity_id": "networking-provider_gcp_cfe-region_europe_west_3",
            "id": "099c8aa0d71f432b1c40ca7ab6a432f72761f3c2fa9258fcc96dfe8595190048",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "DE-FRA",
            "category": "Cloud Computing - Networking",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.05,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 400.0,
            "activity_unit": "GB"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.07,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP CFE (us_west_1) networking",
            "activity_id": "networking-provider_gcp_cfe-region_us_west_1",
            "id": "0d6a3299f6cd31d0457e38a5edb35b1dea041bc2bd34a5c861824f1d972718f0",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "US-OR",
            "category": "Cloud Computing - Networking",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.07,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 8500.0,
            "activity_unit": "GB"
        },
        "audit_trail": "enabled"
    }
]