Cloud Computing Storage Emissions

Cloud Computing - Storage

Calculate total estimated use-phase emissions based on the electricity consumption of storing data for a set amount of time.

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

We currently support three providers – azure, aws and gcp

Request : Azure Storage

{
    "region": "south_central_us",
    "storage_type": "ssd",
    "data": 49900,
    "data_unit": "TB",
    "duration": 200,
    "duration_unit": "min",
    "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.
storage_type	string, required	Which type of hard drive the data is stored on. Valid values are ssd (solid-state drive) and hdd (hard disk drive). The cloud provider does not always specify this for managed services, so you might have to make an informed guess.
data	float, required	How much data is stored. If you use managed services for storage that replicate data across multiple datacenters or hard drives, you might need to take your data amount and multiply it by a replication factor.
data_unit	string, optional	Unit of Data. Accepted values are GB, KB, MB, PB and TB.
duration	float, required	Amount of time or period for which storage processes are running.
duration_unit	string, optional	How long the data is stored for. 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 response; if disabled, the response provides concise information.

Response : Azure Storage

{
    "co2e": 83.82,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "AZURE (south_central_us) SSD storage",
        "activity_id": "storage-provider_azure-region_south_central_us-type_ssd",
        "id": "eeea6672b0329d2f3303793ba4ab66a928283d4bdcdfdb88ad3bb46404eac9ac",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "US-TX",
        "category": "Cloud Computing - Storage",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 83.82,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 166333.67,
        "activity_unit": "TB-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 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 N2O - 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 Storage

{
    "region": "us_east_2",
    "storage_type": "hdd",
    "data": 800,
    "data_unit": "TB",
    "duration": 70,
    "duration_unit": "hour",
    "year": 2022,
    "audit_trail": "enabled"
}

Response : AWS Storage

{
    "co2e": 16.96,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "AWS (us-east-2) HDD storage",
        "activity_id": "storage-provider_aws-region_us_east_2-type_hdd",
        "id": "77b3488c7598b3c6cb48d7aa2cc3c420087862167f890d30df9467fbd76497ad",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "US-OH",
        "category": "Cloud Computing - Storage",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 16.96,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 56000.0,
        "activity_unit": "TB-hour"
    },
    "audit_trail": "enabled"
}

Request : GCP Storage

{
    "region": "australia_southeast_2",
    "storage_type": "hdd",
    "data": 98700,
    "data_unit": "TB",
    "duration": 7500,
    "duration_unit": "hour",
    "year": 2022,
    "audit_trail": "enabled"
}

Response : GCP Storage

{
    "co2e": 365757.53,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar4",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "GCP (australia_southeast_2) HDD storage",
        "activity_id": "storage-provider_gcp-region_australia_southeast_2-type_hdd",
        "id": "0492552ce2fe0088b95a81554f8056de11b62c231157f74352c5c7311b6c6af9",
        "access_type": "public",
        "source": "CCF",
        "source_dataset": "Derived from CCF models",
        "year": 2022,
        "region": "AU-MEL",
        "category": "Cloud Computing - Storage",
        "source_lca_activity": "use_phase",
        "data_quality_flags": "['notable_methodological_variance']"
    },
    "constituent_gases": {
        "co2e_total": 365757.53,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 740250000.0,
        "activity_unit": "TB-hour"
    },
    "audit_trail": "enabled"
}

Cloud Computing - Batch - Storage

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

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

We currently support three providers – azure, aws and gcp

Request : Batch Azure Storage

[
{
    "region": "east_asia",
    "storage_type": "hdd",
    "data": 8700,
    "data_unit": "TB",
    "duration": 500,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "south_central_us",
    "storage_type": "ssd",
    "data": 700,
    "data_unit": "TB",
    "duration": 500,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "switzerland_north",
    "storage_type": "hdd",
    "data": 4500,
    "data_unit": "TB",
    "duration": 9500,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
}
]

Response : Batch Azure Storage

[
    {
        "co2e": 2258.52,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (east_asia) HDD storage",
            "activity_id": "storage-provider_azure-region_east_asia-type_hdd",
            "id": "022bb5253df26a96c3c688a5927651ca67eebd43dd567bd5c0219c3d179af00b",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "HK-HKG",
            "category": "Cloud Computing - Storage",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 2258.52,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 4350000.0,
            "activity_unit": "TB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 176.37,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (south_central_us) SSD storage",
            "activity_id": "storage-provider_azure-region_south_central_us-type_ssd",
            "id": "eeea6672b0329d2f3303793ba4ab66a928283d4bdcdfdb88ad3bb46404eac9ac",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "US-TX",
            "category": "Cloud Computing - Storage",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 176.37,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 350000.0,
            "activity_unit": "TB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 175.27,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AZURE (switzerland_north) HDD storage",
            "activity_id": "storage-provider_azure-region_switzerland_north-type_hdd",
            "id": "06fa7d626cfac5ba4a47bf9d0adc58dd1432b3d91f7a8f9fa676b6f50dfae0ee",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "CH-ZRH",
            "category": "Cloud Computing - Storage",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 175.27,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 42750000.0,
            "activity_unit": "TB-hour"
        },
        "audit_trail": "enabled"
    }
]

Request : Batch AWS Storage

[
{
    "region": "sa_east_1",
    "storage_type": "hdd",
    "data": 870,
    "data_unit": "TB",
    "duration": 50,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "ap_south_1",
    "storage_type": "hdd",
    "data": 70,
    "data_unit": "TB",
    "duration": 50,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "us_east_2",
    "storage_type": "ssd",
    "data": 450,
    "data_unit": "TB",
    "duration": 950,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
}
]

Response : Batch AWS Storage

[
    {
        "co2e": 1.98,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (sa-east-1) HDD storage",
            "activity_id": "storage-provider_aws-region_sa_east_1-type_hdd",
            "id": "017496372401ab08277eb437917ac3bfd0184a0132b925d025e67f75473b39fe",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "BR-SAO",
            "category": "Cloud Computing - Storage",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 1.98,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 43500.0,
            "activity_unit": "TB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 1.83,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (ap-south-1) HDD storage",
            "activity_id": "storage-provider_aws-region_ap_south_1-type_hdd",
            "id": "01bd83436cc271cbc9ac3f1de8d5862b27f0cace5a88052acd92a1f947bde6e7",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "IN-BOM",
            "category": "Cloud Computing - Storage",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 1.83,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 3500.0,
            "activity_unit": "TB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 239.06,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "AWS (us-east-2) SSD storage",
            "activity_id": "storage-provider_aws-region_us_east_2-type_ssd",
            "id": "05abdeb52df7a69e37758ae45281b9142db503be45d7076da4edeef2466b3b32",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "US-OH",
            "category": "Cloud Computing - Storage",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 239.06,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 427500.0,
            "activity_unit": "TB-hour"
        },
        "audit_trail": "enabled"
    }
]

Request : Batch GCP Storage

[
{
    "region": "europe_west_3",
    "storage_type": "hdd",
    "data": 870,
    "data_unit": "TB",
    "duration": 50,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "europe_north_1",
    "storage_type": "hdd",
    "data": 70,
    "data_unit": "TB",
    "duration": 50,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
},
{
    "region": "asia_southeast_2",
    "storage_type": "hdd",
    "data": 450,
    "data_unit": "TB",
    "duration": 950,
    "duration_unit": "hour",
    "year":2022,
    "audit_trail": "enabled"
}
]

Response : Batch GCP Storage

[
    {
        "co2e": 9.11,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP (europe-west-3) HDD storage",
            "activity_id": "storage-provider_gcp-region_europe_west_3-type_hdd",
            "id": "0000924848429f27bbea758fd2117ad5c5f6bce952b4b7570f875e80c0576784",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "DE-FRA",
            "category": "Cloud Computing - Storage",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 9.11,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 43500.0,
            "activity_unit": "TB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 0.33,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP (europe-north-1) HDD storage",
            "activity_id": "storage-provider_gcp-region_europe_north_1-type_hdd",
            "id": "87d6818d3068eb3044cab1371299fbc1af50dfae5efa7a89a87edbd1ea10d684",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "FI-HMN",
            "category": "Cloud Computing - Storage",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 0.33,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 3500.0,
            "activity_unit": "TB-hour"
        },
        "audit_trail": "enabled"
    },
    {
        "co2e": 197.76,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "GCP (asia-southeast-2) HDD storage",
            "activity_id": "storage-provider_gcp-region_asia_southeast_2-type_hdd",
            "id": "0220d067a85fdb7ff0e0556f2a5ddb0bbe96ce258108c18dae202f300925cff8",
            "access_type": "public",
            "source": "CCF",
            "source_dataset": "Derived from CCF models",
            "year": 2022,
            "region": "ID-JKT",
            "category": "Cloud Computing - Storage",
            "source_lca_activity": "use_phase",
            "data_quality_flags": "['notable_methodological_variance']"
        },
        "constituent_gases": {
            "co2e_total": 197.76,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 427500.0,
            "activity_unit": "TB-hour"
        },
        "audit_trail": "enabled"
    }
]