

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用批量价目表 API 获取 AWS 价目表文件
<a name="using-the-aws-price-list-bulk-api"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

我们建议您在要执行以下任务时使用价目表批量处理 API：
+ 消耗大量的 AWS 服务产品和定价信息。
+ 以高吞吐量消耗大量的 AWS 服务产品和定价信息，例如批量处理。

此外，当价目表查询 API 无法为您的用例提供足够的吞吐量和限额时，请使用价目表批量处理 API。<a name="using-the-aws-price-list-bulk-api-fetching-price-list-files"></a>

我们建议您使用批量 AWS 价目表 API 以编程方式查找和下载价目表文件。要获取价目表文件的 URL，请参阅以下步骤。

如果您不想使用批量 AWS 价目表 API，可以手动下载价目表文件。有关更多信息，请参阅 [手动获取价目表文件](using-the-aws-price-list-bulk-api-fetching-price-list-files-manually.md)。

### 第 1 步：查找可用 AWS 服务
<a name="price-bulk-api-step-1-find-available-services"></a>

使用 `DescribeServices` API 操作查找价目表批量处理 API 支持的所有可用 AWS 服务 。此 API 操作返回服务列表中的 `ServiceCode` 值。您稍后使用此值来查找相关的价目表文件。

**Example 示例：查找可用服务**  
以下命令说明如何查找可用的 AWS 服务。  

```
aws pricing describe-services --region us-east-1
```
 AWS 区域 是价目表批量 API 的 API 端点。端点与产品或服务属性无关。  
**响应**  

```
{
    "FormatVersion": "aws_v1", 
    "NextToken": "abcdefg123", 
    "Services": [ 
        {
            "AttributeNames": [ 
                "volumeType", 
                "maxIopsvolume", 
                "instanceCapacity10xlarge", 
                "locationType", 
                "operation" 
            ], 
            "ServiceCode": "AmazonEC2" 
        },
        {
            "AttributeNames": [ 
                "productFamily", 
                "volumeType", 
                "engineCode", 
                "memory" 
            ], 
            "ServiceCode": "AmazonRDS" 
        },
        {...} 
    ] 
}
```

*有关此 API 操作的更多信息，请参阅《API 参考》 AWS SDKs中的 “[https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html)AWS 账单与成本管理 和[特定语言](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html#API_pricing_DescribeServices_SeeAlso)”*

**注意**  
虽然 Savings Plans 目前不返回 `DescribeServices` `serviceCodes` API，但您需要满足以下条件`serviceCodes`才能在后续的 API 调用中使用储蓄计划：  


| ServiceCode | SavingsPlanCode | 
| --- | --- | 
| ComputeSavingsPlans | AWSComputeSavingsPlan | 
| MachineLearningSavingsPlans | AWSMachineLearningSavingsPlans | 
| DatabaseSavingsPlans | AWSDatabaseSavingsPlans | 
使用`ListPriceLists`和 `GetPriceListFileUrl` API 操作时使用这些`ServiceCode`值。`SavingsPlanCode`仅当您手动下载价目表文件而不是使用时，才需要 APIs。

### 步骤 2：查找可用价目表文件 AWS 服务
<a name="price-list-bulk-api-step-2-find-available-price-list-files"></a>

使用 `ListPriceLists` API 操作获取您有权查看的价目表参考清单。要筛选结果，您可以指定 `ServiceCode`、`CurrencyCode`、和 `EffectiveDate` 参数。

 AWS 区域 是价目表批量 API 的 API 端点。端点与产品或服务属性无关。

#### 查找价目表文件的示例
<a name="price-list-bulk-api-examples-find-price-list-files"></a>

**Example 示例：查找所有人的价目表文件 AWS 区域**  
如果您未指定 `--region-code` 参数，则 API 操作会返回所有可用 AWS 区域的价目表文件参考。  

```
aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --effective-date "2023-04-03 00:00"
```
**响应**  

```
{
   "NextToken": "abcd1234",
   "PriceLists": [ 
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1",
         "RegionCode": "us-east-1"
      },
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2",
         "RegionCode": "us-west-2"
      },
      ...
   ]
}
```

**Example 示例：查找特定区域的价目表文件**  
如果您指定 `RegionCode` 参数，API 操作将返回该区域特定的价目表文件参考。要查找历史价目表文件，请使用 `EffectiveDate` 参数。例如，您可以指定过去的日期来查找特定的价目表文件。  
然后，您可以从响应中将 `PriceListArn` 值与 [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html) API 操作配合使用，以获取您的首选价目表文件。  

```
aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --region-code us-west-2 --effective-date "2023-04-03 00:00"
```
**响应**  

```
{
   "PriceLists": [ 
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2",
         "RegionCode": "us-west-2"
      }
   ]
}
```

*有关此 API 操作的更多信息，请参阅《API 参考》 AWS SDKs中的 “[https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html)AWS 账单与成本管理 和[特定语言](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html#API_pricing_ListPriceLists_SeeAlso)”。*

### 步骤 3：获取特定的价目表文件
<a name="price-list-bulk-api-step-3-getting-specific-price-list"></a>

使用 `GetPriceListFileUrl` API 操作获取价目表文件的 URL。此 URL 基于您在[第 1 步](#price-bulk-api-step-1-find-available-services)和[第 2 步](#price-list-bulk-api-step-2-find-available-price-list-files)中从 `ListPriceLists` 响应中检索到的 `PriceListArn` 和 `FileFormats` 值。

**Example 示例：获取特定的价目表文件**  
以下命令获取 Amazon RDS 特定价目表文件的 URL。  

```
aws pricing get-price-list-file-url --price-list-arn arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1 --file-format json --region us-east-1
```
**响应**  

```
{
    "Url": "https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-1/index.json"
}
```
从响应中，您可以使用 URL 下载价目表文件。

有关此 API 操作的更多信息，请参阅以下主题：
+  [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html)*并在 [API 参考 AWS SDKs中针对特定语言](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html#API_pricing_GetPriceListFileUrl_SeeAlso)AWS 账单与成本管理 *
+ [读取价目表文件](bulk-api-reading-price-list-files.md)

# 手动获取价目表文件
<a name="using-the-aws-price-list-bulk-api-fetching-price-list-files-manually"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

我们建议您使用批量 AWS 价目表 API 以编程方式查找和下载价目表文件。有关更多信息，请参阅 [第 1 步：查找可用 AWS 服务](using-the-aws-price-list-bulk-api.md#price-bulk-api-step-1-find-available-services)。

如果您不想使用批量 AWS 价目表 API，可以手动下载价目表文件。如果您已经掌握了所需的信息，则可以跳至相关主题。

**Topics**

## 第 1 步：查找可用 AWS 服务
<a name="fetching-price-list-manually-step-1"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

您可以使用服务索引文件查找批量 AWS 价目表 API 提供的可用计划 AWS 服务 和 Savings Plans。

要下载服务索引文件，请导航至以下 URL：

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/index.json
```

您可以在服务索引文件中搜索服务以查询其定价。要下载特定服务的价目表文件，请使用 `offerCode` 或 `serviceCode`。

有关更多信息，请参阅以下主题：
+ [读取服务索引文件](bulk-api-reading-price-list-files.md#reading-service-index-files)
+ [第 1 步：查找可用 AWS 服务](using-the-aws-price-list-bulk-api.md#price-bulk-api-step-1-find-available-services)

## 第 2 步：查找的可用版本 AWS 服务
<a name="fetching-price-list-files-manually-step-2"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

对于您在[步骤 1](#fetching-price-list-manually-step-1) 中检索到的 AWS 服务 或 Savings Plan，您可以使用[服务版本索引文件查找价目表的所有历史版本](using-the-aws-price-list-bulk-api-reading-price-list-files-reading-service-version-index-file.md)。

要下载服务版本索引文件，请使用 `serviceCode` 或 `savingsPlanCode`。要查找 `serviceCode` 和 `savingsPlanCode` 的值，请参阅 [第 1 步：查找可用 AWS 服务](using-the-aws-price-list-bulk-api.md#price-bulk-api-step-1-find-available-services)。

要下载的服务版本索引文件 AWS 服务，请导航到以下 URL。*<serviceCode>*用您自己的信息替换。

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/<serviceCode>/index.json
```

例如，Amazon Elastic Compute Cloud（Amazon EC2）显示在如下所示的 URL 中。

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonEC2/index.json
```

**注意**  
除了服务版本索引文件中提供的版本外，还有另一个名为 `current` 的版本。该`current`版本指向特定价目表文件的最新版本 AWS 服务。

要下载节省计划的最新服务版本索引文件，请在 URL 中指定 `savingsPlanCode` 和 `current`。*<savingsPlanCode>*用您自己的信息替换。

```
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/<savingsPlanCode>/current/index.json
```

例如，的当前版本`AWSComputeSavingsPlan`显示为以下 URL。

```
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/current/index.json
```

有关更多信息，请参阅 [读取服务版本索引文件](using-the-aws-price-list-bulk-api-reading-price-list-files-reading-service-version-index-file.md)。

## 步骤 3：查找 AWS 区域 适用于某个版本的可用版本 AWS 服务
<a name="fetching-price-list-files-manually-step-3"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

对于上[一步](#fetching-price-list-files-manually-step-2)中的 AWS 服务 或 Savings Plan 版本，您可以找到 AWS 服务 提供产品供购买的所有 AWS 区域 和边缘站点。

要下载的服务区域索引文件 AWS 服务，请导航到以下 URL。将 *<serviceCode>* 和 *<version>* 替换为您自己的信息。

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/<serviceCode>/<version>/region_index.json
```

例如，`AmazonRDS` 的服务代码及其 `current` 版本的 URL 如下所示。

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/region_index.json
```

要下载节省计划的服务区域索引文件，请导航至以下 URL。*<savingsPlanCode>*用您自己的信息替换。

```
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/<savingsPlanCode>/current/region_index.json
```

例如，`AWSComputeSavingsPlan` 的节省计划及其 `current` 版本的 URL 如下所示。

```
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/current/region_index.json
```

有关更多信息，请参阅 [读取服务区域索引文件](reading-service-region-index-files.md)。

## 步骤 4：查找 AWS 区域 和版本的可用价目表 AWS 服务
<a name="fetching-price-list-files-manually-step-4"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

在前面的步骤中，您检索了以下有关 AWS 服务的信息：
+ 服务代码
+ 节省计划代码
+ 版本
+ AWS 区域

接下来，您可以使用此信息在服务价目表文件中查找定价。文件以 CSV 和 JSON 格式提供。

**Contents**
+ [查找服务价目表文件](#fetching-price-list-files-manually-step-4-finding-service-price-list-files)
+ [查找节省计划的服务价目表文件](#find-service-price-list-files-for-savings-plans)

### 查找服务价目表文件
<a name="fetching-price-list-files-manually-step-4-finding-service-price-list-files"></a>

服务价目表文件提供与服务相关的详细信息，例如：
+ 该文件中价格的生效日期
+ 服务价目表的版本
+ 提供的产品列表及其详细信息，以及以 JSON 和 CSV 格式提供的价格

在下文中 URLs，您可以更改 URL 以指定所需的格式（JSON 或 CSV）。

要下载服务价目表文件，请导航至以下 URL。将每个 *user input placeholder* 替换为您自己的信息。

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/<serviceCode>/<version>/<regionCode>/index.<format>
```

以下示例适用于 Amazon Relational Database Service（Amazon RDS）。此服务在 URL 中显示为 AmazonRDS。

**Example 示例：Amazon RDS 价目表文件的当前版本**  
要获取美国东部（俄亥俄州）区域的最新版本 Amazon RDS 价目表文件，请使用以下 URL。  
CSV 格式  

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/us-east-2/index.csv
```
JSON 格式  

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/us-east-2/index.json
```

**Example 示例：Amazon RDS 价目表文件的特定版本**  
要获取美国东部（俄亥俄州）区域的特定版本 Amazon RDS 价目表文件，请使用以下 URL。  
CSV 格式  

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-2/index.csv
```
JSON 格式  

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-2/index.json
```

### 查找节省计划的服务价目表文件
<a name="find-service-price-list-files-for-savings-plans"></a>

节省计划的服务价目表文件提供了与节省计划相关的详细信息，例如：
+ 该文件中价格的生效日期
+ 服务价目表的版本
+ 提供的产品列表及其详细信息，以及以 JSON 和 CSV 格式提供的价格

在下文中 URLs，您可以更改 URL 以指定所需的格式（JSON 或 CSV）。

要下载节省计划的服务价目表文件，请使用以下 URL。将每个 *user input placeholder* 替换为您自己的信息。

```
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/<savingsPlanCode>/<version>/<regionCode>/index.json
```

**Example 示例：Amazon A SageMaker I 的服务价目表文件**  
要获取美国东部（俄亥俄州`20230509202901`）地区的 SageMaker AI (`AWSComputeSavingsPlan`) 价目表文件的特定版本 ()，请使用以下 URL。  
CSV 格式  

```
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230509202901/us-east-2/index.csv
```
JSON 格式  

```
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230509202901/us-east-2/index.json
```

有关更多信息，请参阅 [读取服务价目表文件](reading-service-price-list-files.md)。

# 读取价目表文件
<a name="bulk-api-reading-price-list-files"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

此部分可用来了解如何阅读价目表文件。这包括服务索引文件、服务版本索引文件、区域索引文件以及两者 AWS 服务 和 Savings Plans 用例的价目表文件。

## 读取服务索引文件
<a name="reading-service-index-files"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

获得服务索引文件后，您可以用来查找服务价目表文件。

服务索引文件以 JSON 文件格式提供。您可以使用解析 JSON 的文本应用程序或程序来读取文件。

服务索引文件分为两个主要部分：
+  有关服务索引文件的元数据
+  要么是提供的服务清单，要么是通过 AWS Marketplace AWS 提供的服务。

有关服务索引文件的信息包含相关 URL，可用于下载该服务的价格及其服务区域索引文件。

### 示例：服务索引文件
<a name="service-index-file-example"></a>

服务索引文件如下所示。

```
{
   "formatVersion":"The version number for the offer index format",
   "disclaimer":"The disclaimers for this offer index",
   "publicationDate":"The publication date of this offer index",
   "offers":{
      "firstService":{
         "offerCode":"The service that this price list is for",
         "currentVersionUrl":"The URL for this offer file",
         "currentRegionIndexUrl":"The URL for the regional offer index file",
         "savingsPlanVersionIndexUrl":"The URL for the Savings Plan index file (if applicable)"
      },
      "secondService":{
         "offerCode": ...,
         "currentVersionUrl": ...,
         "currentRegionIndexUrl": ...,
         "savingsPlanVersionIndexUrl":...
      },
      ...
   },
}
```

### 服务索引文件定义
<a name="offer-index-termdef-version-2"></a>

以下列表定义服务索引文件中使用的术语：

**FormatVersion**  
跟踪服务索引文件所使用格式版本的属性。结构发生变化时，文件的 `formatVersion` 将更新。例如，版本将从 `v1` 更改为 `v2`。

**免责声明**  
适用于服务版本索引文件的任何免责声明。

**PublicationDate**  
发布服务版本索引文件的日期和时间，采用 UTC 格式。例如，这可能如 `2015-04-09T02:22:05Z` 和 `2015-09-10T18:21:05Z` 所示。

**Offers**  
可用服务价目表文件清单。

**优惠：OfferCode**  
 AWS 服务产品的唯一代码。例如，可能是 `AmazonEC2` 或 `AmazonS3`。`OfferCode` 用作索引的查找关键字。

**优惠：CurrentVersionUrl**  
您可以从中下载最多 up-to-date服务价目表文件的 URL。

**优惠：currentRegionIndex网址**  
按地区列出的可用服务价目表文件清单。

**优惠：savingsPlanVersionIndexUrl**  
适用的 Savings Plan 报价列表。

# 读取服务版本索引文件
<a name="using-the-aws-price-list-bulk-api-reading-price-list-files-reading-service-version-index-file"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

服务版本索引文件以 JSON 文件格式提供。您可以使用解析 JSON 的文本程序或应用程序来读取文件。

服务版本索引文件由两个主要部分组成：
+ 有关服务版本索引文件的元数据
+  AWS 服务可用的价目表文件的所有版本列表

有关服务版本的信息包括相关 URL，可用于下载该服务在指定时间段内的价格。

**Topics**
+ [的服务版本索引文件 AWS 服务](service-version-index-file-for-aws-service.md)
+ [节省计划的服务版本索引文件](service-version-index-file-for-savings-plans.md)

# 的服务版本索引文件 AWS 服务
<a name="service-version-index-file-for-aws-service"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

要了解服务版本索引文件，请参阅以下参考资料：

**Topics**
+ [示例：某项服务的服务版本索引文件](#example-service-version-index-file-service)
+ [服务版本索引文件定义](#service-version-index-definitions-sps)

## 示例：某项服务的服务版本索引文件
<a name="example-service-version-index-file-service"></a>

服务版本索引文件如下所示。

```
{
   "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": ...
      },
      ...
   },
}
```

## 服务版本索引文件定义
<a name="service-version-index-definitions-sps"></a>

以下列表定义服务版本索引文件中使用的术语：

**formatVersion**  
跟踪服务索引文件所使用格式版本的属性。结构发生变化时，文件的 `formatVersion` 将更新。例如，版本将从 `v1` 更改为 `v2`。

**disclaimer**  
适用于服务版本索引文件的任何免责声明。

**publicationDate**  
发布服务版本索引文件的日期和时间，采用 UTC 格式。例如 `2023-03-28T23:47:21Z`。

**offerCode**  
产品的唯一代码 AWS 服务。例如，`AmazonRDS` 或 `AmazonS3`。

**currentVersion**  
 AWS 服务的最新版本号。例如 `20230328234721`。

**versions**  
此 AWS 服务的可用版本列表。

**versions:version**  
 AWS 服务的价目表版本的唯一代码。此代码在版本列表中用作查找密钥。例如，`20230328234721`，

**版本:版本:日期 versionEffectiveBegin**  
此版本生效开始的日期和时间，采用 UTC 格式。例如 `2023-03-28T23:47:21Z`。

**版本:版本:日期 versionEffectiveEnd**  
此版本生效结束的日期和时间，采用 UTC 格式。例如 `2023-03-28T23:47:21Z`。如果未设置此属性，则表示此版本是当前有效的版本。

**版本:版本:offerVersionUrl**  
此版本的服务价目表文件的相对 URL。例如 `/offers/v1.0/aws/AmazonRDS/20230328234721/index.json`。

# 节省计划的服务版本索引文件
<a name="service-version-index-file-for-savings-plans"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

要了解节省计划的服务版本索引文件，请参阅以下参考资料：

**Contents**
+ [示例：节省计划的服务版本索引文件](#service-version-index-file-savings-plans-example)
+ [服务版本索引定义](#service-version-index-definitions)

## 示例：节省计划的服务版本索引文件
<a name="service-version-index-file-savings-plans-example"></a>

节省计划的服务版本索引文件如下所示。

```
{
   "disclaimer":"The disclaimers for this service version index",
   "publicationDate":"The publication date of this service version index",
   "currentOfferVersionUrl" "The relative URL of region index file for latest version number of the service"
   "versions":[
      {
         "publicationDate":"The publication date of this version of service from which this version was effective",
         "offerVersionUrl":"The relative URL for the service region index file of this version"
      },
      {
         "publicationDate": ...,
         "offerVersionUrl": ...
      },
      ...
   ],
}
```

## 服务版本索引定义
<a name="service-version-index-definitions"></a>

以下列表定义服务版本索引文件中使用的术语：

**disclaimer**  
适用于服务版本索引文件的任何免责声明。

**publicationDate**  
发布服务版本索引文件的日期和时间，采用 UTC 格式。例如 `2023-03-28T23:47:21Z`。

**currentOfferVersion网址**  
服务最新版本号的区域索引文件的相对 URL。例如 `/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/current/region_index.json`。

**versions**  
此版本的可用版本列表 AWS 服务。

**versions:version:publicationDate**  
发布服务版本索引文件的日期和时间，采用 UTC 格式。例如，`2023-04-07T14:57:05Z`

**版本:版本:offerVersionUrl**  
此版本的服务区域索引文件的相对 URL。例如 `/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230407145705/region_index.json`。

# 读取服务区域索引文件
<a name="reading-service-region-index-files"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

服务区域索引文件以 JSON 文件格式提供。您可以使用解析 JSON 的文本程序或应用程序来读取文件。

服务区域索引文件由两个主要部分组成：
+ 有关服务的元数据区域索引文件
+  列出所有 AWS 区域 可用的Savin AWS 服务 gs Plan或代表 AWS Marketplace有限产品的服务。

有关服务区域的信息包括相关 URL，可用于下载该服务在指定时间段和区域内价格。

**Topics**
+ [的服务区域索引文件 AWS 服务](service-region-index-file-for-service.md)
+ [节省计划的服务区域索引文件](service-region-index-files-for-savings-plan.md)

# 的服务区域索引文件 AWS 服务
<a name="service-region-index-file-for-service"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

要了解的服务版本索引文件 AWS 服务，请参阅以下参考资料：

**Contents**
+ [示例：的服务区域索引文件 AWS 服务](#service-region-index-file-for-service)
+ [服务区域索引定义](#service-region-index-definitions-services)

## 示例：的服务区域索引文件 AWS 服务
<a name="service-region-index-file-for-service"></a>

的服务区域索引文件 AWS 服务 如下所示。

```
{
   "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": ...
      },
      ...
   }
}
```

## 服务区域索引定义
<a name="service-region-index-definitions-services"></a>

以下列表定义服务区域索引文件中使用的术语。

**formatVersion**  
跟踪服务区域索引文件所使用格式版本的属性。结构发生变化时，文件的 `formatVersion` 将更新。例如，版本将从 `v1` 更改为 `v2`。

**disclaimer**  
适用于服务区域索引文件的任何免责声明。

**publicationDate**  
发布服务区域索引文件的日期和时间，采用 UTC 格式。例如 `2023-03-28T23:47:21Z`。

**区域**  
的可用 AWS 区域 列表 AWS 服务.

**regions:regionCode**  
提供此 AWS 服务 服务的地区的唯一代码。此代码在区域列表中用作查找密钥。例如，`us-east-2` 指美国东部（俄亥俄州）区域。

**地区：地区代码：currentVersionUrl**  
此版本的服务区域索引文件的相对 URL。例如 `/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-2/index.json`。

# 节省计划的服务区域索引文件
<a name="service-region-index-files-for-savings-plan"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

要了解节省计划的服务区域索引文件，请参阅以下参考资料：

**Topics**
+ [示例：节省计划的服务区域索引文件](#service-region-index-file-for-savings-plans)
+ [服务区域索引定义](#service-region-index-file-definitions)

## 示例：节省计划的服务区域索引文件
<a name="service-region-index-file-for-savings-plans"></a>

节省计划的服务区域索引文件如下所示。

```
{
   "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": ...
      },
      ...
   ]
}
```

## 服务区域索引定义
<a name="service-region-index-file-definitions"></a>

以下列表定义服务区域索引文件中使用的术语。

**disclaimer**  
适用于服务区域索引文件的任何免责声明。

**publicationDate**  
发布服务区域索引文件的日期和时间，采用 UTC 格式。例如 `2023-03-28T23:47:21Z`。

**区域**  
的可用 AWS 区域 列表 AWS 服务.

**regions:regionCode**  
提供此 AWS 服务 服务的地区的唯一代码。此代码在区域列表中用作查找密钥。例如，`us-east-2` 指美国东部（俄亥俄州）区域。

**regions:versionUrl**  
此版本的服务区域索引文件的相对 URL。例如 `/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230407145705/us-east-2/index.json`。

# 读取服务价目表文件
<a name="reading-service-price-list-files"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

服务价目表文件列出了单个或*全部*储蓄计划 AWS 服务 或单个储蓄计划 AWS 区域或*特定地区的*储蓄计划的产品和价格。 AWS 服务 

服务价目表文件以 CSV 或 JSON 文件格式提供。

要读取文件，您可以使用电子表格程序来读取 CSV 文件并对其进行排序，也可以使用能解析 JSON 文件的应用程序。

**注意**  
在 CSV 文件中，产品和定价详细信息已合并为一个部分。在 JSON 文件中，产品和定价详细信息位于不同的部分中。

**Topics**
+ [正在读取服务价目表文件 AWS 服务](reading-service-price-list-file-for-services.md)
+ [读取节省计划的服务价目表文件](reading-service-price-list-file-for-savings-plans.md)

# 正在读取服务价目表文件 AWS 服务
<a name="reading-service-price-list-file-for-services"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

的服务价目表文件 AWS 服务 包括以下类型的信息：
+ 服务价目表文件详细信息 – 有关服务价目表文件的元数据，例如格式版本和发布日期
+ 产品详细信息 – 列出服务价目表文件中的产品以及产品信息的产品元数据。
+ 定价详细信息（期限）– 此服务价目表文件中所有产品的价格

**Contents**
+ [CSV 文件](#reading-service-price-list-file-csv)
+ [JSON 文件](#reading-service-price-list-file-json)
+ [术语定义](#term-definitions)
  + [OnDemand 和保留术语定义](#on-demand-reserved-term-definition)
  + [FlatRate 术语](#flat-rate-term)
+ [服务价目表定义](#service-price-list-files-details)
+ [商品详细信息（商品）定义](#product-details-terms)
+ [商品详细信息（期限）定义](#product-details-metadata)
+ [OnDemand 和保留的定义](#ondemand-reserved-definitions)
+ [FlatRate 定义](#flatrate-definitions)

## CSV 文件
<a name="reading-service-price-list-file-csv"></a>

CSV 文件的前五行包含价目表文件的元数据。第 6 行包含产品及其属性的所有列名称，例如 `SKU`、`OfferTermCode`、`RateCode`、`TermType` 等。

列数因服务而异。前几个列包含定价详细信息，而其他列包含服务的产品详细信息。

## JSON 文件
<a name="reading-service-price-list-file-json"></a>

产品和定价详细信息位于不同的部分中。同一产品可根据多个期限提供，而同一期限可能适用于多种产品。例如，Amazon Elastic Compute Cloud（Amazon EC2） 实例的期限计算方式为 `Hourly` 或 `Reserved`。可以使用产品的 SKU 来确定产品可用的期限。

**Example 示例：常规 JSON 结构**  

```
{
   "formatVersion":"The version of the file format",
   "disclaimer":"The disclaimers for the price list file",
   "offerCode":"The code for the service", 
   "version":"The version of the price list file",
   "publicationDate":"The publication date of the price list file", 
   "products": {  
      "sku": {
         "sku":"The SKU of the product",
         "productFamily":"The product family of the product", 
         "attributes": {
            "attributeName":"attributeValue" 
         }    
      }  
   }, 
   "terms": TermDefinitions
}
```

## 术语定义
<a name="term-definitions"></a>

不同的术语类型在术语对象中具有不同的结构。

### OnDemand 和保留术语定义
<a name="on-demand-reserved-term-definition"></a>

```
{
   "OnDemand|Reserved": {
      "sku": {
         "sku.offerTermCode": {      
            "offerTermCode":"The term code of the product", 
            "sku":"The SKU of the product",
            "effectiveDate":"The effective date of the pricing details", 
            "termAttributesType":"The attribute type of the terms", 
            "termAttributes": { 
               "attributeName":"attributeValue" 
            }, 
            "priceDimensions": {       
               "rateCode": {     
                  "rateCode":"The rate code of the price", 
                  "description":"The description of the term", 
                  "unit":"The usage measurement unit for the price", 
                  "startingRange":"The start range for the term", 
                  "endingRange":"The end range for the term", 
                  "pricePerUnit": {       
                     "currencyCode":"currencyRate"
                  }            
               }          
            }        
         }      
      }    
   }
}
```

### FlatRate 术语
<a name="flat-rate-term"></a>

```
{
   "FlatRate": {
      "plans": [{
         "planCode": "Plan identifier (for example, Free, Pro, Business)",
         "sku": "The SKU associated with this plan",
         "features": [{
            "featureCode": "Unique feature identifier",
            "featureName": "Human-readable feature name",
            "usageQuota": {
               "value": "Usage limit (for quantitative features)",
               "unit": "Unit of measurement (for example, requests, GB)"
            }
         }],
         "subscriptionPrice": {
            "rateCode": "The rate code of the price",
            "description": "The description of the term",
            "pricePerUnit": {
               "currencyCode": "currencyRate"
            }
         }
      }]
   }
}
```

## 服务价目表定义
<a name="service-price-list-files-details"></a>

以下列表定义服务价目表文件中使用的术语。

**formatVersion**  
跟踪服务价目表文件所使用格式版本的属性。结构发生变化时，文件的 `formatVersion` 将更新。例如，版本将从 `v1` 更改为 `v2`。

**disclaimer**  
适用于服务价目表文件的任何免责声明。

**offerCode**  
产品的唯一代码 AWS 服务。例如，Amazon EC2 为 `AmazonEC2` 或 Amazon S3 为 `AmazonS3`。

**版本**  
跟踪服务价目表文件版本的属性。每次发布新文件时，都会包含一个新的版本号。例如，`20150409022205` 和 `20150910182105`。

**publicationDate**  
发布服务价目表文件时的日期和时间，采用 UTC 格式。例如，`2015-04-09T02:22:05Z` 和 `2015-09-10T18:21:05Z`。

## 商品详细信息（商品）定义
<a name="product-details-terms"></a>

此部分提供有关 AWS 服务的服务价目表文件中的产品的信息。按 SKU 为产品编制索引。

**products:sku**  
产品的唯一代码。使用 `SKU` 代码可关联产品详细信息和定价。  
例如，SKU 为 `HCNSHWWAJSGVAHMH` 的产品仅适用于将 `HCNSHWWAJSGVAHMH` 列为 SKU 的价格。

**products:sku:productFamily**  
产品类型的类别。例如，Amazon EC2 为 `compute` 或 Amazon S3 为 `storage`。

**products:sku:attributes**  
所有产品属性的列表。

**products:sku:attributes:Attribute Name**  
产品属性的名称。例如，`Instance Type`、`Processor` 或 `OS`。

**products:sku:attributes:Attribute Value**  
产品属性的值。例如，`m1.small`（实例类型）、`xen`（处理器类型）或 `Linux`（操作系统类型）。

## 商品详细信息（期限）定义
<a name="product-details-metadata"></a>

此部分提供有关 AWS 服务的服务价目表文件中产品价格的信息。价格以条款为索引。

**terms:termType**  
期限定义描述的特定类型的期限。有效的术语类型为`Reserved``OnDemand`、和`FlatRate`。

## OnDemand 和保留的定义
<a name="ondemand-reserved-definitions"></a>

在本节中，`termType`指的是`OnDemand`或`Reserved`。

**terms:termType:SKU**  
产品的唯一代码。使用 `SKU` 代码可关联产品详细信息和定价。  
例如，SKU 为 `HCNSHWWAJSGVAHMH` 的产品仅适用于将 `HCNSHWWAJSGVAHMH` 列为 SKU 的价格。

**terms:termType:sku:Offer Term Code**  
特定类型期限的唯一代码。例如 `KCAKZHGHG`。  
产品和价格组合由 SKU 代码引用，后跟期限代码，用句点分隔。例如 `U7ADXS4BEK5XXHRU.KCAKZHGHG`。

**terms:termType:sku:Effective Date**  
服务价目表文件的生效日期。例如，如果期限的 `EffectiveDate` 为 2017 年 11 月 1 日，则价格在该日期之前无效。

**terms:termType:sku:Term Attributes Type**  
明确期限所覆盖产品和产品报价的唯一代码。例如，`EC2-Reserved` 属性类型表示期限适用于 Amazon EC2 预留主机。

**terms:termType:sku:Term Attributes**  
适用于期限类型的所有属性列表。格式显示为 `attribute-name: attribute-value`。例如，这可以是期限时长和期限覆盖的购买类型。

**terms:termType:sku:Term Attributes:Attribute Name**  
`TermAttribute` 的名称。您可以使用它来查找特定属性。例如，您可以通过 `length` 或 `PurchaseOption` 查找期限。

**terms:termType:sku:Term Attributes:Attribute Value**  
`TermAttribute` 的值。例如，期限时长可以是一年，并且购买选项为 `All Upfront`。

**terms:termType:sku:Price Dimensions**  
服务价目表文件的定价详细信息，例如如何衡量使用情况、可用于付款的货币以及定价套餐限制。

**terms:termType:sku:Price Dimensions:Rate Code**  
产品、报价和定价套餐组合的唯一代码。产品和期限组合可以有多个价格维度，例如免费套餐、低使用量套餐和高使用量套餐。

**terms:termType:sku:Price Dimensions:Rate Code:Description**  
价格或费率的描述。

**terms:termType:sku:Price Dimensions:Rate Code:Unit**  
每项服务用于度量计费使用情况的单位类型。例如，Amazon EC2 使用小时，而 Amazon S3 使用 GB。

**terms:termType:sku:Price Dimensions:Rate Code:Starting Range**  
此价格所涵盖的价格套餐的下限。例如，0GB 或 1001 次 API 操作调用。

**terms:termType:sku:Price Dimensions:Rate Code:Ending Range**  
此价格所涵盖的价格套餐的上限。例如，1000GB 或 10000 次 API 操作调用。

**terms:termType:sku:Price Dimensions:Rate Code:Price Per Unit**  
计算一个度量单位的服务成本。

**terms:termType:sku:Price Dimensions:Rate Code:Price Per Unit:Currency Code**  
指示特定产品价格货币的代码。

**terms:termType:sku:Price Dimensions:Rate Code:Price Per Unit:Currency Rate**  
以各种支持货币表示的产品费率。例如，每个单位 1.2536 美元。

## FlatRate 定义
<a name="flatrate-definitions"></a>

在本节中，`termType`请参阅`FlatRate`。

**条款：术语类型：计划**  
提供一系列统一费率的定价计划。每个计划都代表一个完整的定价等级，包括捆绑功能和固定订阅费用。

**条款：术语类型：计划：计划代码**  
统一费率套餐的唯一标识符（例如，“免费”、“Pro”）。

**条款：条款类型：计划：SKU**  
与此特定计划关联的 SKU。将计划链接到产品部分中的相应产品。

**条款：术语类型：计划：功能**  
统一费率计划中包含一系列功能。

**条款：术语类型：计划：功能：功能代码**  
该功能的唯一标识符（例如，“请求”、“”、DataTransfer “S3Storage”）。

**条款：术语类型：计划：功能：功能名称**  
该功能的可读名称（例如，“请求”、“数据传输”）。

**条款：术语类型：计划：特点：用法配额**  
定量功能的使用限制。此对象是可选的，仅适用于具有可测量限制的功能。

**条款：术语类型：计划：特点：用法配额：值**  
该功能的数值限制（例如，100 万个请求为 “1000000”，100 GB 为 “100”）。

**条款：术语类型：计划：特点：用法配额：单位**  
使用限制的计量单位（例如，“请求”、“GB”）。

**条款：期限类型：计划：订阅价格**  
统一费率套餐的订阅定价详情。

**条款：条款类型：套餐：订阅价格：费率代码**  
产品、报价和定价套餐组合的唯一代码。

**条款：条款类型：套餐：订阅价格：描述**  
价格或费率的描述。

**条款：期限类型：计划：订阅价格：每单位价格**  
计算一个度量单位的服务成本。

**条款：期限类型：计划：订阅价格：每单位价格：货币代码**  
指示特定产品价格货币的代码。

**条款：期限类型：计划：订阅价格：每单位价格：汇率**  
以各种支持的货币表示的商品汇率（例如，每单位 1.2536 美元）。

# 读取节省计划的服务价目表文件
<a name="reading-service-price-list-file-for-savings-plans"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

的服务价目表文件 AWS 服务 包括以下类型的信息：
+ 服务价目表文件详细信息-有关服务价目表文件的元数据，例如版本 AWS 区域、和发布日期
+ 产品详细信息 – 列出服务价目表文件中的产品以及产品信息的产品元数据。
+ 定价详细信息（期限）– 服务价目表文件中所有产品的价格

**Contents**
+ [CSV 文件](#service-price-list-file-for-saving-plans-csv)
+ [JSON 文件](#service-price-list-file-for-saving-plans-json)
+ [服务价目表定义](#service-price-list-file-definitions-savings-plan)
+ [商品详细信息（商品）定义](#service-price-list-file-definitions-products-savings-plan)
+ [定价详细信息（期限）定义](#service-price-list-file-definitions-terms-savings-plan)

## CSV 文件
<a name="service-price-list-file-for-saving-plans-csv"></a>

CSV 文件的前 5 行是价目表文件的元数据。第 6 行包含产品及其属性的所有列名称，例如 `SKU`、`RateCode` 等。

列数因节省计划而异。前几个列包含所有定价详细信息，而其他列包含节省计划的产品详细信息。

## JSON 文件
<a name="service-price-list-file-for-saving-plans-json"></a>

产品和定价详细信息位于不同的部分中。JSON 服务价目表文件如下所示。

```
{
   "version" : "The version of the price list file",
   "publicationDate" : "The publication date of the price list file",
   "regionCode" : "Region for which price list file is valid for",
   "products" : [  
      {
         "sku" : "The SKU of the product",
         "productFamily" : "The product family of the product", 
         "serviceCode" : "Savings plan code",
         "attributes" : {
            "attributeName":"attributeValue", 
         }    
      },
      ...  
   ], 
   "terms" : {
      "savingsPlan" : [
         {
            "sku" : "The SKU of the product",
            "description" : "Description of the product",
            "effectiveDate" : "The effective date of the pricing details",
            "leaseContractLength" : {
                "duration" : "Length of the lease contract - it is a number",
                "unit" : "Unit of the duration"
            },
            "rates" : [
                {
                    "discountedSku" : "The SKU of the discounted on demand product",
                    "discountedUsageType" : "Usage type of the discounted product",
                    "discountedOperation" : "Operation of the discounted product",
                    "discountedServiceCode" : "Service code of the discounted product",
                    "rateCode" : "The rate code of this price detail",
                    "unit" : "Unit used to measure usage of the product",
                    "discountedRate" : {
                        "price" : "Price of the product",
                        "currency" : "Currency of the price"
                    }
                },
                ...
            ]
        },
        ...   
      ]  
   }
}
```

## 服务价目表定义
<a name="service-price-list-file-definitions-savings-plan"></a>

以下列表定义服务价目表文件中使用的术语。

**regionCode**  
价目表有效的区域的区域代码。

**版本**  
跟踪价目表文件版本的属性。每次发布新文件时，都会包含一个新的版本号。例如，`20150409022205` 和 `20150910182105`。

**publicationDate**  
发布服务价目表文件时的日期和时间，采用 UTC 格式。例如，`2015-04-09T02:22:05Z` 和 `2015-09-10T18:21:05Z`。

## 商品详细信息（商品）定义
<a name="service-price-list-file-definitions-products-savings-plan"></a>

此部分提供有关节省计划价目表文件中产品的信息。按 SKU 为产品编制索引。

**products:product:sku**  
产品的唯一代码。使用 `SKU` 代码可关联产品详细信息和定价。  
例如，SKU 为 `HCNSHWWAJSGVAHMH` 的产品仅适用于将 `HCNSHWWAJSGVAHMH` 列为 SKU 的价格。

**products:product:productFamily**  
产品类型的类别。例如，计算类节省计划的 `EC2InstanceSavingsPlans`。

**products:product:serviceCode**  
节省计划的服务代码。例如 `ComputeSavingsPlans`。

**products:product:attributes**  
所有产品属性的列表。

**products:product:attributes:attributeName**  
产品属性的名称。例如，`Instance Type`、`Location Type` 或 `Purchase Option`。

**products:product:attributes:attributeValue**  
产品属性的值。例如，`m1.small`（实例类型）、AWS Local Zone（位置类型）或 `No Upfront`（购买选项类型）。

## 定价详细信息（期限）定义
<a name="service-price-list-file-definitions-terms-savings-plan"></a>

此部分提供有关节省计划价目表文件中产品价格的信息。

 价格首先按期限 (`savingsPlan`) 进行索引。

**terms:termType**  
期限定义描述的特定类型的期限。有效的期限类型为 `savingsPlan`。

**terms:termType:sku**  
产品的唯一代码。使用 `SKU` 代码可关联产品详细信息和定价。  
例如，SKU 为 `T496KPMD8YQ8RZNC` 的产品仅适用于将 `496KPMD8YQ8RZNC` 列为 SKU 的价格。

**terms:termType:sku:description**  
产品的描述。

**terms:termType:sku:effectiveDate**  
服务价目表文件的生效日期。例如，如果期限的 `EffectiveDate` 为 2017 年 11 月 1 日，则价格在该日期之前无效。

**条款:术语类型:SKU:: 持续时间 leaseContractLength**  
租赁合同的期限。该值是一个数字。例如，1 或 3。

**terms:termType:sku:rates**  
适用于节省计划产品的所有折扣率列表。一个节省计划产品是其他服务中多种产品的组合，其中包含多种组合费率。

**terms:termType:sku:rates:discountedSku**  
按需折扣商品的 SKU。

**条款：术语类型：SKU：费率：discountedUsageType**  
按需折扣产品的使用类型。

**terms:termType:sku:rates:discountedOperation**  
按需折扣产品的操作。

**条款：术语类型：SKU：费率：discountedServiceCode**  
按需折扣产品的服务代码。

**terms:termType:sku:rates:rateCode**  
根据节省计划产品提供的此费率的费率代码。例如，`T496KPMD8YQ8RZNC.26PW7ZDSYZZ6YBTZ`

**terms:termType:sku:rates:unit**  
用于衡量产品使用量的单位。例如，Amazon EC2 实例采用 `Hrs`。

**terms:termType:sku:rates:discountedRate:price**  
根据节省计划产品提供的折扣产品的价格。例如 `3.434`。

**terms:termType:sku:rates:discountedRate:currency**  
根据节省计划产品提供的折扣产品价格的货币。例如 `USD`。

# 在服务价目表文件中查找价格
<a name="finding-prices-in-service-price-list-files"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

批量 AWS 价目表 API 提供了所有 AWS 产品的价格，以供参考，包括按需和预留实例的定价。

您可以使用报价文件查找特定产品的价格和期限。例如，您可以查找 Amazon Elastic Compute Cloud（Amazon EC2）实例价目表。

**注意**  
批量 AWS 价目表 API 不是限时优惠（例如 AWS 免费套餐 定价）的综合来源。有关免费套餐价格的信息，请参阅 [AWS 免费套餐](https://aws.amazon.com/free/)。

查找您感兴趣的产品的价格。

**Contents**
+ [查找服务的按需价格](#finding-one-demand-prices-services)
+ [查找服务的分层价格](#finding-tiered-prices-services)
+ [查找带有免费套餐的服务的分层价格](#finding-tiered-prices-services-free-tier)
  + [示例](#finding-tiered-prices-services-free-tier-example)
+ [查找带有预留实例的服务的价格](#finding-prices-services-reserved-instances)

## 查找服务的按需价格
<a name="finding-one-demand-prices-services"></a>

以下过程说明如何查找 Amazon EC2 AWS 服务等的按需价格。

**使用 CSV 文件查找按需价格**

1. 下载该服务的 CSV 文件。

1. 使用您的首选应用程序打开 CSV 文件。

1. 在该**TermType**列下方，筛选以显示**OnDemand**。

1. 查找所需的使用类型和操作。

1. 在**PricePerUnit**列中，查看相应的价格。

**使用 JSON 文件查找按需价格**

1. 下载该服务的 JSON 文件。

1. 使用您的首选应用程序打开 JSON 文件。

1. 在**期限**和**按需**下方，找到所需 SKU。

   如果您不知道此 SKU，请在 **products (产品)** 下搜索 **usage type (使用类型)** 和 **operation (操作)**。

1. 请参阅 **pricePerUnit**，查找 SKU 的相应按需价格。

## 查找服务的分层价格
<a name="finding-tiered-prices-services"></a>

以下过程显示如何查找服务的分层价格，例如查找 Amazon Simple Storage Service（Amazon S3）的分层价格。

**使用 CSV 文件查找服务的分层价格**

1. 下载该服务的 CSV 文件。

1. 使用您的首选应用程序打开 CSV 文件

1. 在该**TermType**列下方，筛选以显示**OnDemand**。

1. 查找所需的使用类型和操作。

1. 在**PricePerUnit**列中，查看每个**StartingRange**和的相应价格**EndingRange**。

**使用 JSON 文件查找服务的分层价格**

1. 下载 JSON 文件。

1. 使用您的首选应用程序打开 JSON 文件。

1. 在**期限**和**按需**下方，找到所需 SKU。

   如果您不知道此 SKU，请在 **products (产品)** 下搜索 **usage type (使用类型)** 和 **operation (操作)**。

1. **在每个 **beginRan** ge 和 endRange 下，请参阅，找到相应的分层价格**pricePerUnit**。**

## 查找带有免费套餐的服务的分层价格
<a name="finding-tiered-prices-services-free-tier"></a>

以下过程说明如何在价目表批量 API 中查找 AWS 服务 已发布的免费套餐 AWS 价格，例如 AWS Lambda。

所有免费套餐价格均受 [AWS 免费套餐](https://aws.amazon.com/free) 中所列的期限约束。

**使用 CSV 文件查找带有免费套餐的服务的价格**

1. 下载该服务的 CSV 文件。

1. 使用您的首选应用程序打开 CSV 文件。

1. 在该**TermType**列下方，筛选以显示**OnDemand**。

1. 在 **Location (位置)** 列下，筛选以显示 **Any (任意)**。

   在这种情况下，An@@ **y** 并不代表全部 AWS 区域 。它是由 CSV 文件中其他行项目定义的区域子集，其中一**RelatedTo**列与 “**任何**条目” 位置的 SKU 相匹配。

1. 要查找特定免费套餐 SKU 的所有符合条件的地点和产品的列表，请在该**RelatedTo**列下方找到免费套餐 SKU。

1. 要查看所有符合条件的地点的免费套餐承保使用情况，**EndingRange**请参阅**StartingRange**和，了解地点 An **y**。

### 示例
<a name="finding-tiered-prices-services-free-tier-example"></a>

此示例假设价格文件中没有其他**RelatedTo**等于 SKU `ABCD` 的条目。

如下表所示，带有 SKU `ABCD` 的免费套餐优惠在 `Asia Pacific (Singapore)` 和 `US East (Ohio)` 区域有效，但在 `AWS GovCloud (US)` 无效。免费套餐覆盖的总使用量为 400,000 秒，可用于两个符合条件的区域。


****  

| SKU | StartingRage | EndingRange | 单位 | RelatedTo | 位置 | 
| --- | --- | --- | --- | --- | --- | 
| ABCD | 0 | 400000 | seconds |  | Any | 
| QWER | 0 | Inf | seconds | ABCD | Asia Pacific (Singapore) | 
| WERT | 0 | Inf | seconds | ABCD | US East (Ohio) | 
| ERTY | 0 | Inf | seconds |  | AWS GovCloud (US) | 

**使用 JSON 文件查找带有免费套餐的服务的分层价格**

1. 下载该服务的 JSON 文件。

1. 使用您的首选应用程序打开 JSON 文件。

1. 在 **products**下，找到区域前缀为**Global** 的 **usagetype**。

1. 记下该 SKU，然后在**条款**和下查找相同的 SKU **OnDemand**。

1. 有关免费套餐的使用量，请参阅**BeginRange**和**EndRange**。

   有关免费套餐涵盖的产品和区域的列表，请参阅 **appliesTo (适用于)**。

## 查找带有预留实例的服务的价格
<a name="finding-prices-services-reserved-instances"></a>

以下过程显示如何查找带有预留实例的服务的价格，例如，Amazon Relational Database Service（Amazon RDS）。

**使用 CSV 文件查找预留实例的价格**

1. 下载 Amazon EC2 CSV 文件。

1. 使用您的首选应用程序打开 CSV 文件。

1. 在该**TermType**列下方，筛选以显示**已保留**。

1. 查找所需的使用类型和操作。

1. 对于每个**LeaseContractLength**、**PurchaseOption**、和 **OfferingClass**，请参见相应价格**PricePerUnit**栏中的相应价格。

**使用 JSON 文件查找预留实例的价格**

1. 下载该服务的 JSON 文件。

1. 使用您的首选应用程序打开 JSON 文件。

1. 在**期限**和**预留**下方，找到所需 SKU。

   如果您不知道此 SKU，请在 **products (产品)** 下搜索 **usage type (使用类型)** 和 **operation (操作)**。

您可以找到**LeaseContractLength**PurchaseOption****、和同一**OfferingClass**产品的价格。