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

# 讀取 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`。