@cloud-carbon-footprint/aws/src/lib/AWSRegions.ts

The core logic to get cloud usage data and estimate energy and carbon emissions from Amazon Web Services.

/*
 * © 2021 Thoughtworks, Inc.
 */

import { mappedRegionsToElectricityMapZones } from '@cloud-carbon-footprint/common'

export enum AWS_REGIONS {
  US_EAST_1 = 'us-east-1',
  US_EAST_2 = 'us-east-2',
  US_WEST_1 = 'us-west-1',
  US_WEST_2 = 'us-west-2',
  AF_SOUTH_1 = 'af-south-1',
  AP_EAST_1 = 'ap-east-1',
  AP_EAST_2 = 'ap-east-2',
  AP_SOUTH_1 = 'ap-south-1',
  AP_SOUTH_2 = 'ap-south-2',
  AP_NORTHEAST_1 = 'ap-northeast-1',
  AP_NORTHEAST_2 = 'ap-northeast-2',
  AP_NORTHEAST_3 = 'ap-northeast-3',
  AP_SOUTHEAST_1 = 'ap-southeast-1',
  AP_SOUTHEAST_2 = 'ap-southeast-2',
  AP_SOUTHEAST_3 = 'ap-southeast-3',
  AP_SOUTHEAST_4 = 'ap-southeast-4',
  AP_SOUTHEAST_5 = 'ap-southeast-5',
  AP_SOUTHEAST_6 = 'ap-southeast-6',
  AP_SOUTHEAST_7 = 'ap-southeast-7',
  CA_CENTRAL_1 = 'ca-central-1',
  CA_WEST_1 = 'ca-west-1',
  CN_NORTH_1 = 'cn-north-1',
  CN_NORTHWEST_1 = 'cn-northwest-1',
  EU_CENTRAL_1 = 'eu-central-1',
  EU_CENTRAL_2 = 'eu-central-2',
  EU_WEST_1 = 'eu-west-1',
  EU_WEST_2 = 'eu-west-2',
  EU_WEST_3 = 'eu-west-3',
  EU_SOUTH_1 = 'eu-south-1',
  EU_SOUTH_2 = 'eu-south-2',
  EU_NORTH_1 = 'eu-north-1',
  IL_CENTRAL_1 = 'il-central-1',
  ME_SOUTH_1 = 'me-south-1',
  ME_CENTRAL_1 = 'me-central-1',
  MX_CENTRAL_1 = 'mx-central-1',
  SA_EAST_1 = 'sa-east-1',
  US_GOV_EAST_1 = 'us-gov-east-1',
  US_GOV_WEST_1 = 'us-gov-west-1',
  UNKNOWN = 'Unknown',
}

export const AWS_MAPPED_REGION_NAMES_TO_CODES: { [key: string]: string } = {
  'US East (Ohio)': AWS_REGIONS.US_EAST_2,
  'US East (N. Virginia)': AWS_REGIONS.US_EAST_1,
  'US West (N. California)': AWS_REGIONS.US_WEST_1,
  'US West (Oregon)': AWS_REGIONS.US_WEST_2,
  'Africa (Cape Town)': AWS_REGIONS.AF_SOUTH_1,
  'Asia Pacific (Hong Kong)': AWS_REGIONS.AP_EAST_1,
  'Asia Pacific (Taipei)': AWS_REGIONS.AP_EAST_2,
  'Asia Pacific (Mumbai)': AWS_REGIONS.AP_SOUTH_1,
  'Asia Pacific (Hyderabad)': AWS_REGIONS.AP_SOUTH_2,
  'Asia Pacific (Osaka)': AWS_REGIONS.AP_NORTHEAST_3,
  'Asia Pacific (Seoul)': AWS_REGIONS.AP_NORTHEAST_2,
  'Asia Pacific (Singapore)': AWS_REGIONS.AP_SOUTHEAST_1,
  'Asia Pacific (Sydney)': AWS_REGIONS.AP_SOUTHEAST_2,
  'Asia Pacific (Tokyo)': AWS_REGIONS.AP_NORTHEAST_1,
  'Asia Pacific (Jakarta)': AWS_REGIONS.AP_SOUTHEAST_3,
  'Asia Pacific (Melbourne)': AWS_REGIONS.AP_SOUTHEAST_4,
  'Asia Pacific (Malaysia)': AWS_REGIONS.AP_SOUTHEAST_5,
  'Asia Pacific (New Zealand)': AWS_REGIONS.AP_SOUTHEAST_6,
  'Asia Pacific (Thailand)': AWS_REGIONS.AP_SOUTHEAST_7,
  'Canada (Central)': AWS_REGIONS.CA_CENTRAL_1,
  'Canada West (Calgary)': AWS_REGIONS.CA_WEST_1,
  'EU (Frankfurt)': AWS_REGIONS.EU_CENTRAL_1,
  'Europe (Zurich)': AWS_REGIONS.EU_CENTRAL_2,
  'EU (Ireland)': AWS_REGIONS.EU_WEST_1,
  'EU (London)': AWS_REGIONS.EU_WEST_2,
  'EU (Milan)': AWS_REGIONS.EU_SOUTH_1,
  'Europe (Spain)': AWS_REGIONS.EU_SOUTH_2,
  'EU (Paris)': AWS_REGIONS.EU_WEST_3,
  'EU (Stockholm)': AWS_REGIONS.EU_NORTH_1,
  'Israel (Tel Aviv)': AWS_REGIONS.IL_CENTRAL_1,
  'Middle East (Bahrain)': AWS_REGIONS.ME_SOUTH_1,
  'Middle East (UAE)': AWS_REGIONS.ME_CENTRAL_1,
  'Mexico (Central)': AWS_REGIONS.MX_CENTRAL_1,
  'South America (Sao Paulo)': AWS_REGIONS.SA_EAST_1,
  'AWS GovCloud (US-East)': AWS_REGIONS.US_GOV_EAST_1,
  'AWS GovCloud (US-West)': AWS_REGIONS.US_GOV_WEST_1,
  'China (Beijing)': AWS_REGIONS.CN_NORTH_1,
  'China (Ningxia)': AWS_REGIONS.CN_NORTHWEST_1,
}

export const AWS_MAPPED_REGIONS_TO_ELECTRICITY_MAPS_ZONES: mappedRegionsToElectricityMapZones =
  {
    [AWS_REGIONS.US_EAST_1]: 'US-MIDA-PJM',
    [AWS_REGIONS.US_EAST_2]: 'US-MIDW-MISO',
    [AWS_REGIONS.US_WEST_1]: 'US-CAL-CISO',
    [AWS_REGIONS.US_WEST_2]: 'US-NW-PACW',
    [AWS_REGIONS.AF_SOUTH_1]: 'ZA',
    [AWS_REGIONS.AP_EAST_1]: 'HK',
    [AWS_REGIONS.AP_EAST_2]: 'TW',
    [AWS_REGIONS.AP_SOUTH_1]: 'IN-WE',
    [AWS_REGIONS.AP_SOUTH_2]: 'IN-SO',
    [AWS_REGIONS.AP_NORTHEAST_1]: 'JP-TK',
    [AWS_REGIONS.AP_NORTHEAST_2]: 'KR',
    [AWS_REGIONS.AP_NORTHEAST_3]: 'JP-KN',
    [AWS_REGIONS.AP_SOUTHEAST_1]: 'SG',
    [AWS_REGIONS.AP_SOUTHEAST_2]: 'AU-NSW',
    [AWS_REGIONS.AP_SOUTHEAST_3]: 'ID',
    [AWS_REGIONS.AP_SOUTHEAST_4]: 'AU-VIC',
    [AWS_REGIONS.AP_SOUTHEAST_5]: 'MY-WM',
    [AWS_REGIONS.AP_SOUTHEAST_6]: 'NZ',
    [AWS_REGIONS.AP_SOUTHEAST_7]: 'TH',
    [AWS_REGIONS.CA_CENTRAL_1]: 'CA-ON',
    [AWS_REGIONS.CA_WEST_1]: 'CA-AB',
    [AWS_REGIONS.CN_NORTH_1]: 'CN',
    [AWS_REGIONS.CN_NORTHWEST_1]: 'CN',
    [AWS_REGIONS.EU_CENTRAL_1]: 'DE',
    [AWS_REGIONS.EU_CENTRAL_2]: 'CH',
    [AWS_REGIONS.EU_WEST_1]: 'IE',
    [AWS_REGIONS.EU_WEST_2]: 'GB',
    [AWS_REGIONS.EU_WEST_3]: 'FR',
    [AWS_REGIONS.EU_SOUTH_1]: 'IT-NO',
    [AWS_REGIONS.EU_SOUTH_2]: 'ES',
    [AWS_REGIONS.EU_NORTH_1]: 'SE-SE3',
    [AWS_REGIONS.IL_CENTRAL_1]: 'IL',
    [AWS_REGIONS.ME_SOUTH_1]: 'BH',
    [AWS_REGIONS.ME_CENTRAL_1]: 'AE',
    [AWS_REGIONS.MX_CENTRAL_1]: 'MX',
    [AWS_REGIONS.SA_EAST_1]: 'BR-CS',
    [AWS_REGIONS.US_GOV_EAST_1]: 'US-MIDA-PJM',
    [AWS_REGIONS.US_GOV_WEST_1]: 'US-NW-PACW',
    [AWS_REGIONS.UNKNOWN]: null,
  }