本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 读取服务价目表文件 | | | --- | | 要提供相关的反馈 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 服务 | | | --- | | 要提供相关的反馈 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 文件 CSV 文件的前五行包含价目表文件的元数据。第 6 行包含产品及其属性的所有列名称，例如 `SKU`、`OfferTermCode`、`RateCode`、`TermType` 等。 列数因服务而异。前几个列包含定价详细信息，而其他列包含服务的产品详细信息。 ## JSON 文件 产品和定价详细信息位于不同的部分中。同一产品可根据多个期限提供，而同一期限可能适用于多种产品。例如，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 } ``` ## 术语定义 不同的术语类型在术语对象中具有不同的结构。 ### OnDemand 和保留术语定义 ``` { "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 术语 ``` { "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" } } }] } } ``` ## 服务价目表定义 以下列表定义服务价目表文件中使用的术语。 **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`。 ## 商品详细信息（商品）定义 此部分提供有关 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`（操作系统类型）。 ## 商品详细信息（期限）定义 此部分提供有关 AWS 服务的服务价目表文件中产品价格的信息。价格以条款为索引。 **terms:termType** 期限定义描述的特定类型的期限。有效的术语类型为`Reserved``OnDemand`、和`FlatRate`。 ## OnDemand 和保留的定义 在本节中，`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 定义 在本节中，`termType`请参阅`FlatRate`。 **条款：术语类型：计划** 提供一系列统一费率的定价计划。每个计划都代表一个完整的定价等级，包括捆绑功能和固定订阅费用。 **条款：术语类型：计划：计划代码** 统一费率套餐的唯一标识符（例如，“免费”、“Pro”）。 **条款：条款类型：计划：SKU** 与此特定计划关联的 SKU。将计划链接到产品部分中的相应产品。 **条款：术语类型：计划：功能** 统一费率计划中包含一系列功能。 **条款：术语类型：计划：功能：功能代码** 该功能的唯一标识符（例如，“请求”、“”、DataTransfer “S3Storage”）。 **条款：术语类型：计划：功能：功能名称** 该功能的可读名称（例如，“请求”、“数据传输”）。 **条款：术语类型：计划：特点：用法配额** 定量功能的使用限制。此对象是可选的，仅适用于具有可测量限制的功能。 **条款：术语类型：计划：特点：用法配额：值** 该功能的数值限制（例如，100 万个请求为 “1000000”，100 GB 为 “100”）。 **条款：术语类型：计划：特点：用法配额：单位** 使用限制的计量单位（例如，“请求”、“GB”）。 **条款：期限类型：计划：订阅价格** 统一费率套餐的订阅定价详情。 **条款：条款类型：套餐：订阅价格：费率代码** 产品、报价和定价套餐组合的唯一代码。 **条款：条款类型：套餐：订阅价格：描述** 价格或费率的描述。 **条款：期限类型：计划：订阅价格：每单位价格** 计算一个度量单位的服务成本。 **条款：期限类型：计划：订阅价格：每单位价格：货币代码** 指示特定产品价格货币的代码。 **条款：期限类型：计划：订阅价格：每单位价格：汇率** 以各种支持的货币表示的商品汇率（例如，每单位 1.2536 美元）。 # 读取节省计划的服务价目表文件 | | | --- | | 要提供相关的反馈 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 文件 CSV 文件的前 5 行是价目表文件的元数据。第 6 行包含产品及其属性的所有列名称，例如 `SKU`、`RateCode` 等。 列数因节省计划而异。前几个列包含所有定价详细信息，而其他列包含节省计划的产品详细信息。 ## JSON 文件 产品和定价详细信息位于不同的部分中。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" } }, ... ] }, ... ] } } ``` ## 服务价目表定义 以下列表定义服务价目表文件中使用的术语。 **regionCode** 价目表有效的区域的区域代码。 **版本** 跟踪价目表文件版本的属性。每次发布新文件时，都会包含一个新的版本号。例如，`20150409022205` 和 `20150910182105`。 **publicationDate** 发布服务价目表文件时的日期和时间，采用 UTC 格式。例如，`2015-04-09T02:22:05Z` 和 `2015-09-10T18:21:05Z`。 ## 商品详细信息（商品）定义 此部分提供有关节省计划价目表文件中产品的信息。按 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`（购买选项类型）。 ## 定价详细信息（期限）定义 此部分提供有关节省计划价目表文件中产品价格的信息。 价格首先按期限 (`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`。