

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用價目表大量 API 取得 AWS 價目表檔案
<a name="using-the-aws-price-list-bulk-api"></a>


|  | 
| --- |
| 若要提供有關 的意見回饋 AWS 價格表，請完成此[簡短問卷](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回覆將採匿名處理。**注意：**這份問卷僅提供英文版本。 | 

如果要執行下列任務，建議您使用 Price List Bulk API：
+ 使用 AWS 服務的大量產品和定價資訊。
+ 以高輸送量使用 AWS 服務的產品和定價資訊，例如大量處理。

此外，如果 Price List Query API 無法為您的使用案例提供足夠的輸送量和配額，也請使用 Price List Bulk API。<a name="using-the-aws-price-list-bulk-api-fetching-price-list-files"></a>

我們建議您使用 AWS Price List Bulk 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 操作尋找 Price List Bulk API 支援的所有可用 AWS 服務 。此 API 操作會傳回服務清單中的 `ServiceCode` 值。您稍後可以使用此值來尋找相關的價目表檔案。

**Example 範例：尋找可用服務**  
以下命令示範如何尋找可用 AWS 服務。  

```
aws pricing describe-services --region us-east-1
```
 AWS 區域 是 Price List Bulk API 的 API 端點。端點與產品或服務屬性無關。  
**回應**  

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

如需此 API 操作的詳細資訊，請參閱*AWS 帳單與成本管理 《 API 參考*》中的 [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)和語言特定 SDK [AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html#API_pricing_DescribeServices_SeeAlso) 

**注意**  
雖然 `DescribeServices` API 目前不會傳回 `serviceCodes` Savings Plans，但您需要下列項目`serviceCodes`，才能在後續 API 呼叫中使用 Savings Plans：  


| 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 區域 是 Price List Bulk 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` 參數。舉例來說，您可以指定過去的日期，尋找特定的價目表檔案。  
得到回應後，您接著可以在 [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 操作中使用 `PriceListArn` 值，以取得偏好的價目表檔案。  

```
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 操作的詳細資訊，請參閱*AWS 帳單與成本管理 《 API 參考*》中的 [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)和語言特定 SDK。 [AWS SDKs](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) *AWS 帳單與成本管理 API 參考*中的 [和語言特定 AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html#API_pricing_GetPriceListFileUrl_SeeAlso) 
+ [讀取價目表檔案](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 Price List Bulk 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 Price List Bulk 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 中顯示為如下 URL。

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

**注意**  
除了服務版本索引檔案中的可用版本之外，還有另一個名稱為 `current` 的版本. `current` 版本指向特定 的最新版價目表檔案 AWS 服務。

若要下載 Savings Plan 的最新服務版本索引檔案，請在 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
```

若要下載 Savings Plan 的服務區域索引檔案，請前往下列 URL。將 *<savingsPlanCode>* 更改成您自己的資訊。

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

舉例來說，`AWSComputeSavingsPlan` 的 Savings Plan 及其 `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 服務相關資訊：
+ 服務代碼
+ Savings Plan 代碼
+ 版本
+ AWS 區域

接下來，您可以使用這些資訊在服務價目表檔案中尋找價格。這些檔案會使用 JSON 和 CSV 格式。

**Contents**
+ [尋找服務價目表檔案](#fetching-price-list-files-manually-step-4-finding-service-price-list-files)
+ [尋找 Savings Plan 的服務價目表檔案](#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 格式的價格。

您可以變更下列 URL，藉此指定所需格式 (JSON 或 CSV)。

若要下載服務價目表檔案，請前往下列 URL。將每個*使用者輸入預留位置*替換為自己的資訊。

```
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 format (CSV 格式)  

```
https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/us-east-2/index.csv
```
JSON format (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 format (CSV 格式)  

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

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

### 尋找 Savings Plan 的服務價目表檔案
<a name="find-service-price-list-files-for-savings-plans"></a>

Savings Plan 的服務價目表檔案會提供與 Savings Plan 相關的詳細資訊，例如：
+ 該檔案中價格的生效日期
+ 服務價目表的版本
+ 供應產品清單及其詳細資訊，以及 JSON 和 CSV 格式的價格。

您可以變更下列 URL，藉此指定所需格式 (JSON 或 CSV)。

若要下載 Savings Plan 的服務價目表檔案，請使用以下 URL。將每個*使用者輸入預留位置*替換為自己的資訊。

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

**Example 範例：Amazon SageMaker AI 的服務價目表檔案**  
若要取得美國東部 （俄亥俄`20230509202901`) 區域中 SageMaker AI (`AWSComputeSavingsPlan`) 的特定價目表檔案版本 ()，請使用下列 URL。   
CSV format (CSV 格式)  

```
https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230509202901/us-east-2/index.csv
```
JSON format (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 提供或透過 AWS Marketplace 的服務清單。

服務索引檔案的相關資訊包含可下載價格的 URL，以及該服務的區域索引檔案 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**  
可用的服務價目表檔案清單。

**Offers:OfferCode**  
 AWS 服務產品的唯一程式碼。舉例來說，它可能是 `AmazonEC2` 或 `AmazonS3`。`OfferCode` 被用作索引的查找索引鍵。

**Offers:CurrentVersionUrl**  
可下載最新服務價目表檔案的 URL。

**Offers:currentRegionIndexUrl**  
案區域區分的可用服務價目表檔案清單。

**Offers: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)
+ [Savings Plan 的服務版本索引檔案](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`、

**versions:version:versionEffectiveBeginDate**  
UTC 格式的開始日期和時間，對該版本有效。例如 `2023-03-28T23:47:21Z`。

**versions:version:versionEffectiveEndDate**  
UTC 格式的結束日期和時間，對該版本有效。例如 `2023-03-28T23:47:21Z`。如果未設定此屬性，表示此版本為目前作用中的版本。

**versions:version:offerVersionUrl**  
版本的服務價目表檔案相對 URL。例如 `/offers/v1.0/aws/AmazonRDS/20230328234721/index.json`。

# Savings Plan 的服務版本索引檔案
<a name="service-version-index-file-for-savings-plans"></a>


|  | 
| --- |
| 若要提供有關 的意見回饋 AWS 價格表，請完成此[簡短問卷](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回覆將採匿名處理。**注意：**這份問卷僅提供英文版本。 | 

如需瞭解 Savings Plan 的服務版本索引檔案，請參閱下列參考資料：

**Contents**
+ [範例：Savings Plan 的服務版本索引檔案](#service-version-index-file-savings-plans-example)
+ [服務版本索引定義](#service-version-index-definitions)

## 範例：Savings Plan 的服務版本索引檔案
<a name="service-version-index-file-savings-plans-example"></a>

Savings Plan 服務版本索引檔案如下所示。

```
{
   "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`。

**currentOfferVersionUrl**  
服務所屬最新版本編號的區域索引檔案相對 URL。例如 `/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/current/region_index.json`。

**versions**  
此可用版本的清單 AWS 服務。

**versions:version:publicationDate**  
發行服務版本索引檔案的日期和時間，採用 UTC 格式。例如 `2023-04-07T14:57:05Z`

**versions:version: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 區域 AWS 服務 Savings Plan 或代表有限 AWS Marketplace 方案的服務的所有清單。

服務區域的相關資訊中包括的 URL，可在指定期間和區域內用來下載該服務的價格。

**Topics**
+ [的服務區域索引檔案 AWS 服務](service-region-index-file-for-service.md)
+ [Savings Plan 的服務區域索引檔案](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` 代表美國東部 (俄亥俄) 區域。

**regions:regionCode:currentVersionUrl**  
此版本的服務區域索引檔案相對 URL。例如 `/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-2/index.json`。

# Savings Plan 的服務區域索引檔案
<a name="service-region-index-files-for-savings-plan"></a>


|  | 
| --- |
| 若要提供有關 的意見回饋 AWS 價格表，請完成此[簡短問卷](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回覆將採匿名處理。**注意：**這份問卷僅提供英文版本。 | 

若要瞭解 Savings Plan 的服務區域索引檔案，請參閱下列參考資料：

**Topics**
+ [範例：Savings Plan 的服務區域索引檔案](#service-region-index-file-for-savings-plans)
+ [服務區域索引定義](#service-region-index-file-definitions)

## 範例：Savings Plan 的服務區域索引檔案
<a name="service-region-index-file-for-savings-plans"></a>

Savings Plan 的服務區域索引檔案如下所示。

```
{
   "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 服務 或 Savings Plan，或*特定區域中*的單一 AWS 服務 或 Savings Plan 的產品和價格。

服務價目表檔案會使用 JSON 和 CSV 格式。

若要讀取檔案，您可以使用試算表程式來讀取和排序 CSV 檔案，或使用應用程式來剖析 JSON 檔案。

**注意**  
在 CSV 檔案中，產品和定價詳細資訊會合併成一個區段。在 JSON 檔案中，產品詳細資訊和定價詳細資訊位在不同的區段。

**Topics**
+ [讀取 的服務價目表檔案 AWS 服務](reading-service-price-list-file-for-services.md)
+ [讀取 Savings Plan 的服務價目表](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 檔案的前五列包含價目表檔案的中繼資料。第六列包含產品及其屬性的資料欄名稱，例如 `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`。

**version**  
追蹤服務價目表檔案版本的屬性。每次發佈新檔案時，都會包含新的版本號碼。例如，`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` 代碼，關聯產品詳細資訊和定價。  
舉例來說，產品若有 `HCNSHWWAJSGVAHMH` SKU，則僅適用於同樣將 `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` 代碼，關聯產品詳細資訊和定價。  
舉例來說，產品若有 `HCNSHWWAJSGVAHMH` SKU，則僅適用於同樣將 `HCNSHWWAJSGVAHMH` 列出為 SKU 的價格。

**terms:termType:sku:Offer Term Code**  
特定有效期間類型的獨特代碼。例如 `KCAKZHGHG`。  
產品和價格組合是由 SKU 代碼引用，後面接著有效期間代碼，並以句點分隔。例如 `U7ADXS4BEK5XXHRU.KCAKZHGHG`。

**terms:termType:sku:Effective Date**  
服務價目表檔案生效的日期。舉例來說，如果期限中包含 2017 年 11 月 1 日的 `EffectiveDate`，則該日期之前的價格皆無效。

**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**  
此價格涵蓋的價格方案的下限。舉例來說，0 GB 或 1,001 個 API 操作呼叫。

**terms:termType:sku:Price Dimensions:Rate Code:Ending Range**  
此價格涵蓋的價格方案的上限。舉例來說，1,000 GB 或 10,000 個 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 USD。

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

在本節中， `termType`是指 `FlatRate`。

**terms：termType：plans**  
可用的固定費率定價計劃陣列。每個計劃代表具有綁定功能和固定訂閱成本的完整定價方案。

**terms：termType：plans：planCode**  
固定費率計劃的唯一識別符 （適用於檢查、「免費」、「專業」)。

**terms：termType：plans：sku**  
與此特定計劃相關聯的 SKU。將計劃連結至產品區段中的對應產品。

**terms：termType：plans：features**  
固定費率計劃中包含的一系列功能。

**terms：termType：plans：features：featureCode**  
功能的唯一識別符 （例如 "Requests"、"DataTransfer"、"S3Storage")。

**terms：termType：plans：features：featureName**  
功能的人類可讀取名稱 （例如，「請求」、「資料傳輸」)。

**terms：termType：plans：features：usageQuota**  
量化功能的用量限制。此物件是選用的，僅適用於具有可測量限制的功能。

**terms：termType：plans：features：usageQuota：value**  
功能的數值限制 （例如，100 萬個請求為 "1000000"，100 GB 為 "100")。

**terms：termType：plans：features：usageQuota：unit**  
用量限制的測量單位 （例如 "requests"、"GB")。

**terms：termType：plans：subscriptionPrice**  
固定費率方案的訂閱定價詳細資訊。

**terms：termType：plans：subscriptionPrice：rateCode**  
產品、優惠和定價層級組合的唯一代碼。

**terms：termType：plans：subscriptionPrice：Description**  
价格或費率的描述。

**terms：termType：plans：subscriptionPrice：Price per Unit**  
一項服務成本的有多少單一測量單位的計算。

**terms：termType：plans：subscriptionPrice：Price per Unit：Currency Code**  
表示特定產品價格貨幣的代碼。

**terms：termType：plans：subscriptionPrice：Price per Unit：Currency Rate**  
各種支援貨幣的產品費率 （例如，每單位 1.2536 美元）。

# 讀取 Savings Plan 的服務價目表
<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 檔案的前五列是價目表檔案的中繼資料。第六列包含產品及其屬性的資料欄名稱，例如 `SKU`、`RateCode` 等。

資料欄的數量因 Savings Plan 而異。前幾欄包含定價詳細資訊，而其他欄包含 Savings Plan 的產品詳細資訊。

## 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**  
價目表有效的區域所具有的區域代碼。

**version**  
追蹤價目表檔案版本的屬性。每次發佈新檔案時，都會包含新的版本號碼。例如，`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>

本節提供 Savings Plan 價目表檔案中的產品相關資訊。產品是依據 SKU 編製索引。

**products:product:sku**  
產品的獨特代碼。使用 `SKU` 代碼，關聯產品詳細資訊和定價。  
舉例來說，產品若有 `HCNSHWWAJSGVAHMH` SKU，則僅適用於同樣將 `HCNSHWWAJSGVAHMH` 列出為 SKU 的價格。

**products:product:productFamily**  
產品類型的類別。舉例來說，Compute Savings Plans 是 `EC2InstanceSavingsPlans`。

**products:product:serviceCode**  
Savings Plan 的服務代碼。例如 `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>

本節提供 Savings Plan 價目表檔案中的產品價格相關資訊。

 價格會先以期限 (`savingsPlan`) 建立索引。

**terms:termType**  
有效期間定義描述的特定有效期間類型。有效的期限類型為 `savingsPlan`。

**terms:termType:sku**  
產品的獨特代碼。使用 `SKU` 代碼，關聯產品詳細資訊和定價。  
舉例來說，產品若有 `T496KPMD8YQ8RZNC` SKU，則僅適用於同樣將 `496KPMD8YQ8RZNC` 列出為 SKU 的價格。

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

**terms:termType:sku:effectiveDate**  
服務價目表檔案生效的日期。舉例來說，如果期限中包含 2017 年 11 月 1 日的 `EffectiveDate`，則該日期之前的價格皆無效。

**terms:termType:sku:leaseContractLength:duration**  
租賃合約的長度。此值為數字。例如 1 或 3。

**terms:termType:sku:rates**  
列出 Savings Plan 產品所有適用折扣費率的清單。一項 Savings Plan 產品由多種其他服務的產品組成，其中包含多種提供給組合的費率。

**terms:termType:sku:rates:discountedSku**  
折扣隨需產品的 SKU。

**terms:termType:sku:rates:discountedUsageType**  
折扣隨需產品的使用類型。

**terms:termType:sku:rates:discountedOperation**  
折扣隨需產品的操作。

**terms:termType:sku:rates:discountedServiceCode**  
折扣隨需產品的服務代碼。

**terms:termType:sku:rates:rateCode**  
Savings Plan 產品提供的費率所使用的費率代碼。例如 `T496KPMD8YQ8RZNC.26PW7ZDSYZZ6YBTZ`

**terms:termType:sku:rates:unit**  
用於測量產品用量的單位。例如，Amazon EC2 執行個體是使用 `Hrs`。

**terms:termType:sku:rates:discountedRate:price**  
Savings Plan 產品所提供的折扣產品的價格。例如 `3.434`。

**terms:termType:sku:rates:discountedRate:currency**  
Savings Plan 產品提供的折扣產品的價格所用貨幣。例如 `USD`。

# 尋找服務價目表檔案中的價格
<a name="finding-prices-in-service-price-list-files"></a>


|  | 
| --- |
| 若要提供有關 的意見回饋 AWS 價格表，請完成此[簡短問卷](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回覆將採匿名處理。**注意：**這份問卷僅提供英文版本。 | 

 AWS Price List Bulk API 提供所有 AWS 產品的價格以供參考，包括隨需和預留執行個體定價。

您可以使用優惠檔案來尋找特定產品的價格和期限。例如，您可以找到 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體的價格清單。

**注意**  
 AWS Price List Bulk 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>

下列程序說明如何尋找 的隨需價格 AWS 服務，例如 Amazon EC2。

**使用 CSV 檔案尋找隨需價格**

1. 下載服務的 CSV 檔案。

1. 使用偏好的應用程式開啟 CSV 檔案。

1. 在 **TermType** 欄位下，使用篩選條件以顯示 **OnDemand**。

1. 尋找您想要的用量類型和操作。

1. 在 **PricePerUnit** 欄位中，查看對應的價格。

**使用 JSON 檔案尋找隨需價格**

1. 下載服務的 JSON 檔案。

1. 使用偏好的應用程式開啟 JSON 檔案。

1. 找到**期限**與**隨需**，在底下尋找您要的 SKU。

   若您不知道該 SKU，請在 **產品** 下搜尋 **用量類型** 和 **操作**。

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** 欄位中，查看每個 **BeginRange** 和 **EndRange** 對應的價格。

**使用 JSON 檔案尋找服務的分級定價**

1. 下載 JSON 檔案。

1. 使用偏好的應用程式開啟 JSON 檔案。

1. 找到**期限**與**隨需**，在底下尋找您要的 SKU。

   若您不知道該 SKU，請在 **產品** 下搜尋 **用量類型** 和 **操作**。

1. 在每一個 **beginRange** 和 **endRange** 下，查看 **pricePerUnit** 以尋找對應的分級定價。

## 尋找擁有免費方案的服務分級定價
<a name="finding-tiered-prices-services-free-tier"></a>

下列程序顯示如何在 AWS Price List Bulk API 中尋找 AWS 服務 發佈免費方案價格，例如 AWS Lambda。

所有免費方案價格均受 [AWS 免費方案](https://aws.amazon.com/free)記載的期限所約束。

**使用 CSV 檔案尋找提供免費方案的服務價格**

1. 下載服務的 CSV 檔案。

1. 使用偏好的應用程式開啟 CSV 檔案。

1. 在 **TermType** 欄位下，使用篩選條件以顯示 **OnDemand**。

1. 在 **Location (位置)** 欄下，篩選以展示 **Any (任何)**。

   **在此** AWS 區域 案例中，任何 不代表所有 。它是由 CSV 檔案中其他行項目定義的區域子集，其中 **RelatedTo** 欄與地點為 **Any** 項目的 SKU 相符。

1. 若要尋找特定免費方案 SKU 所有符合資格的地點和產品清單，請在 **RelatedTo** 欄底下尋找免費方案 SKU。

1. 若要尋找所有合格地點的免費方案涵蓋用量，請參閱地點 **Any** (任何) 的 **StartingRange** 和 **EndingRange**。

### 範例
<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 | Location | 
| --- | --- | --- | --- | --- | --- | 
| 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。

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** 欄位下，使用篩選條件以顯示 **reserved (預留)**。

1. 尋找您想要的用量類型和操作。

1. 如需每個 **LeaseContractLength**、**PurchaseOption** 和 **OfferingClass**，請參閱對應價格的 **PricePerUnit** 欄位。

**使用 JSON 檔案尋找預留執行個體的價格**

1. 下載服務的 JSON 檔案。

1. 使用偏好的應用程式開啟 JSON 檔案。

1. 找到**期限**與**預留**，在底下尋找您要的 SKU。

   若您不知道該 SKU，請在 **產品** 下搜尋 **用量類型** 和 **操作**。

您可以找到相同產品的 **LeaseContractLength**、**PurchaseOption** 和 **OfferingClass** 價格。