本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 AWS Price List Query API 尋找服務和產品
| |
| --- |
| 若要提供有關 的意見回饋 AWS 價格表，請完成此[簡短問卷](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回覆將採匿名處理。**注意：**這份問卷僅提供英文版本。 |
若您想要執行下列作業，建議您使用 Price List Query API：
+ 尋找產品的定價資訊。
+ 搜尋與篩選條件相符的產品和費率。
+ 在開發資源有限的應用程式 (例如前端環境) 時，快速尋找所需產品和價格。
若要尋找 AWS 服務其產品，以及產品屬性和價格，請參閱下列步驟。
## 步驟 1：可用的調查結果 AWS 服務
找到服務之後，您就可以使用 `DescribeServices` API 操作取得該服務的屬性。如果您知道服務代碼，也可以使用 AWS 價格清單查詢 API 來取得服務的屬性。接著，您就可以利用服務屬性，根據屬性值來尋找符合需求的產品。
### 範例：尋找服務
下列 AWS Command Line Interface (AWS CLI) 命令示範如何尋找 服務。
**Example 範例：尋找所有服務**
```
aws pricing describe-services --region us-east-1
```
**回應**
```
{
"FormatVersion": "aws_v1",
"NextToken": "abcdefg123",
"Services": [
{
"AttributeNames": [
"volumeType",
"maxIopsvolume",
"instanceCapacity10xlarge",
"locationType",
"operation"
],
"ServiceCode": "AmazonEC2"
},
{
"AttributeNames": [
"productFamily",
"volumeType",
"engineCode",
"memory"
],
"ServiceCode": "AmazonRDS"
},
{...}
]
}
```
**Example 範例：尋找 Amazon Elastic Compute Cloud (Amazon EC2) 的服務中繼資料**
下列命令示範如何尋找 Amazon EC2 的服務中繼資料。
```
aws pricing describe-services --region us-east-1 --service-code AmazonEC2
```
**回應**
```
{
"FormatVersion": "aws_v1",
"NextToken": "abcdefg123",
"Services": [
{
"AttributeNames": [
"productFamily",
"volumeType",
"engineCode",
"memory"
],
"ServiceCode": "AmazonEC2"
}
]
}
```
AWS 區域 是 Price List Query API 的 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)。
## 步驟 2：尋找屬性的可用值
在[步驟 1](#price-list-query-api-find-services) 中，您擷取了一項 AWS 服務的屬性清單。在此步驟中，您會使用這些屬性來搜尋產品。在步驟 3 中，您需要用到這些屬性可供使用的值。
若要尋找屬性的值，請使用 `GetAttributeValues` API 操作。若要呼叫 API，請指定 `AttributeName` 和 `ServiceCode` 參數。
### 範例：取得屬性值
following AWS Command Line Interface (AWS CLI) 命令顯示如何取得 的屬性值 AWS 服務。
**Example 範例：尋找 Amazon Relational Database Service (Amazon RDS) 的屬性值**
```
aws pricing get-attribute-values --service-code AmazonRDS --attribute-name operation --region us-east-1
```
**回應**
```
{
"AttributeValues": [
{
"Value": "CreateDBInstance:0002"
},
{
"Value": "CreateDBInstance:0003"
},
{
"Value": "CreateDBInstance:0004"
},
{
"Value": "CreateDBInstance:0005"
}
],
"NextToken": "abcdefg123"
}
```
AWS 區域 是 Price List Query API 的 API 端點。端點與產品或服務屬性無關。
如需詳細資訊，請參閱 *AWS 帳單與成本管理 API 參考*中的 [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetAttributeValues.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetAttributeValues.html)和語言特定 SDK。 [AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetAttributeValues.html#API_pricing_GetAttributeValues_SeeAlso)
## 步驟 3：透過屬性尋找產品
在此步驟中，您會使用[步驟 1](#price-list-query-api-find-services) 和[步驟 2](#price-list-query-api-find-attributes) 中的資訊來尋找產品及其期限。若要取得產品相關資訊，請使用 `GetProducts` API 操作。您可以指定篩選條件清單，讓系統傳回您要尋找的產品。
**注意**
Price List Query API 僅支援 `"AND"` 比對。命令傳回的回應只會包含與所有指定篩選條件相符的產品。
### 範例：透過屬性尋找產品
下列 AWS Command Line Interface (AWS CLI) 命令示範如何使用 屬性尋找 產品。
**Example 範例：以指定篩選條件尋找產品**
下列命令示範如何為 Amazon Relational Database Service (Amazon RDS) 指定篩選條件。
```
aws pricing get-products --service-code AmazonRDS --region us-east-1 --filters Type=TERM_MATCH,Field=operation,Value="CreateDBInstance:0002"
```
**回應**
```
{
"FormatVersion": "aws_v1",
"PriceList": ["{
\"product\":{
\"productFamily\":\"Database Instance\",
\"attributes\":{
\"engineCode\":\"2\",
\"enhancedNetworkingSupported\":\"Yes\",
\"memory\":\"64 GiB\",
\"dedicatedEbsThroughput\":\"2000 Mbps\",
\"vcpu\":\"16\",
\"locationType\":\"AWS Region\",
\"storage\":\"EBS Only\",
\"instanceFamily\":\"General purpose\",
\"regionCode\":\"us-east-1\",
\"operation\":\"CreateDBInstance:0002\",
...
},
\"sku\":\"22ANV4NNQP3UUCWY\"},
\"serviceCode\":\"AmazonRDS\",
\"terms\":{...}"
],
"NextToken": "abcd1234"
}
```
**Example 範例：使用 `filters.json` 檔案指定篩選條件**
下列命令示範如何指定包含所有篩選條件的 JSON 檔案。
```
aws pricing get-products --service-code AmazonRDS --region us-east-1 --filters file://filters.json
```
舉例來說，`filters.json` 檔案可能包含下列篩選條件。
```
[
{
"Type": "TERM_MATCH",
"Field": "operation",
"Value": "CreateDBInstance:0002"
}
]
```
下列範例示範如何指定多個篩選條件。
```
[
{
"Type": "TERM_MATCH",
"Field": "AttributeName1",
"Value": "AttributeValue1"
},
{
"Type": "TERM_MATCH",
"Field": "AttributeName2",
"Value": "AttributeValue2"
},
...
]
```
**回應**
```
{
"FormatVersion": "aws_v1",
"PriceList": ["{
\"product\":{
\"productFamily\":\"Database Instance\",
\"attributes\":{
\"engineCode\":\"2\",
\"enhancedNetworkingSupported\":\"Yes\",
\"memory\":\"64 GiB\",
\"dedicatedEbsThroughput\":\"2000 Mbps\",
\"vcpu\":\"16\",
\"locationType\":\"AWS Region\",
\"storage\":\"EBS Only\",
\"instanceFamily\":\"General purpose\",
\"regionCode\":\"us-east-1\",
\"operation\":\"CreateDBInstance:0002\",
...
},
\"sku\":\"22ANV4NNQP3UUCWY\"},
\"serviceCode\":\"AmazonRDS\",
\"terms\":{...}"
],
"NextToken": "abcd1234"
}
```
如需詳細資訊，請參閱下列主題：
+ [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetProducts.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetProducts.html) *AWS 帳單與成本管理 API 參考*中的 [和語言特定 AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetProducts.html#API_pricing_GetProducts_SeeAlso)
+ [讀取服務價目表檔案](reading-service-price-list-files.md)
+ [尋找服務價目表檔案中的價格](finding-prices-in-service-price-list-files.md)