# Reading the service Region index file
<a name="reading-service-region-index-files"></a>


|  | 
| --- |
| To provide feedback about AWS Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 

The service Region index file is available in JSON format. To read the file, you can use a text program or an application that parses the JSON.

The service Region index file consists of two main sections: 
+ Metadata about the service Region index file
+  List of all AWS Regions in which AWS services, Savings Plan or a service representing limited AWS Marketplace offerings are available. 

The information about a service Region includes the URL where you can download the prices for that service for the specified time period and Region.

**Topics**
+ [Service Region index file for AWS services](service-region-index-file-for-service.md)
+ [Service Region index file for Savings Plan](service-region-index-files-for-savings-plan.md)

# Service Region index file for AWS services
<a name="service-region-index-file-for-service"></a>


|  | 
| --- |
| To provide feedback about AWS Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 

To understand the service version index file for AWS services, see the following references:

**Contents**
+ [Example: Service Region index file for an AWS service](#service-region-index-file-for-service)
+ [Service Region index definitions](#service-region-index-definitions-services)

## Example: Service Region index file for an AWS service
<a name="service-region-index-file-for-service"></a>

The service Region index file for an AWS service looks like the following.

```
{
   "formatVersion":"The version number for the service region index format",
   "disclaimer":"The disclaimers for this service region index",
   "publicationDate":"The publication date of this service region index",
   "regions":{
      "firstRegion":{
         "regionCode":"A unique identifier that identifies this region",
         "currentVersionUrl":"The relative URL for the service regional price list file of this version"
      },
      "secondRegion":{
         "regionCode": ...,
         "currentVersionUrl": ...
      },
      ...
   }
}
```

## Service Region index definitions
<a name="service-region-index-definitions-services"></a>

The following list defines the terms in the service Region index file.

**formatVersion**  
An attribute that tracks which format version the service Region index file is in. The `formatVersion` of the file is updated when the structure is changed. For example, the version will change from `v1` to `v2`.

**disclaimer**  
Any disclaimers that apply to the service Region index file.

**publicationDate**  
The date and time in UTC format when a service Region index file was published. For example, `2023-03-28T23:47:21Z`.

**regions**  
The list of available AWS Region for the AWS service.

**regions:regionCode**  
A unique code for the Region in which this AWS service is offered. This is used as the lookup key in the Regions list. For example, `us-east-2` is the US East (Ohio) Region.

**regions:regionCode:currentVersionUrl**  
The relative URL for the service Region index file of this version. For example, `/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-2/index.json`.

# Service Region index file for Savings Plan
<a name="service-region-index-files-for-savings-plan"></a>


|  | 
| --- |
| To provide feedback about AWS Price List, complete this [short survey](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA). Your responses will be anonymous. **Note:** This survey is in English only. | 

To understand the service Region index file for Savings Plan, see the following references:

**Topics**
+ [Example: Service Region index file for Savings Plan](#service-region-index-file-for-savings-plans)
+ [Service Region index definitions](#service-region-index-file-definitions)

## Example: Service Region index file for Savings Plan
<a name="service-region-index-file-for-savings-plans"></a>

The service Region index file for Savings Plan looks like the following.

```
{
   "disclaimer":"The disclaimers for this service version index",
   "publicationDate":"The publication date of this service region index",
   "regions":[
      {
         "regionCode":"A unique identifier that identifies this region",
         "versionUrl":"The relative URL for the service regional price list file of this version"
      },
      {
         "regionCode": ...,
         "versionUrl": ...
      },
      ...
   ]
}
```

## Service Region index definitions
<a name="service-region-index-file-definitions"></a>

The following list defines the terms in the service Region index file.

**disclaimer**  
Any disclaimers that apply to the service Region index file.

**publicationDate**  
The date and time in UTC format when a service Region index file was published. For example, `2023-03-28T23:47:21Z`.

**regions**  
The list of available AWS Region for the AWS service.

**regions:regionCode**  
A unique code for the Region in which this AWS service is offered. This is used as the lookup key in the Regions list. For example, `us-east-2` is the (US East (Ohio) Region.

**regions:versionUrl**  
The relative URL for the service Region index file of this version. For example, `/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230407145705/us-east-2/index.json`.