Service version index file for an Amazon Web Service - Amazon Billing
Example: Service version index file for a serviceService version index file definitions
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Service version index file for an Amazon Web Service

Note

To provide feedback about Amazon Price List, complete this short survey. Your responses will be anonymous. Note: This survey is in English only.

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

Example: Service version index file for a service

The service version index file looks like the following.

{
   "formatVersion":"The version number for the service version index format",
   "disclaimer":"The disclaimers for this service version index",
   "publicationDate":"The publication date of this service version index",
   "offerCode": "The service code/Savings Plan code",
   "currentVersion": "The latest version of the service"
   "versions":{
      "firstVersion":{
         "versionEffectiveBeginDate":"The date starting which this version is effective",
         "versionEffectiveEndDate":"The date until which this version is effective",
         "offerVersionUrl":"The relative URL for the service price list file of this version"
      },
      "secondVersion":{
         "versionEffectiveBeginDate": ...,
         "versionEffectiveEndDate": ...,
         "offerVersionUrl": ...
      },
      ...
   },
}

Service version index file definitions

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

formatVersion

An attribute that tracks which format version the service version 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 version index file.

publicationDate

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

offerCode

A unique code for the product of an Amazon Web Service. For example, AmazonRDS or AmazonS3.

currentVersion

The latest version number of the Amazon Web Service. For example, 20230328234721.

versions

The list of available versions for this Amazon Web Service.

versions:version

A unique code for the version of a price list for an Amazon Web Service. This is used as the lookup key in the versions list. For example, 20230328234721,

versions:version:versionEffectiveBeginDate

The start date and time in UTC format, which this version is effective. For example, 2023-03-28T23:47:21Z.

versions:version:versionEffectiveEndDate

The end date and time in UTC format, which this version is effective. For example, 2023-03-28T23:47:21Z. If this property isn't set, this means that this version is the currently active version.

versions:version:offerVersionUrl

The relative URL for the service price list files of the version. For example, /offers/v1.0/aws/AmazonRDS/20230328234721/index.json.