

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

# 設定價格更新通知
<a name="notifications-price-list-api"></a>


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

價目表檔案可以隨時更改。價目表檔案有所更新時，Amazon Simple Notiﬁcation Service (Amazon SNS) 就會傳送通知。您可以設定 在價格變更時接收通知，例如當 AWS 降價時，或當新產品和服務啟動時。

您可以設定在每次價格變動時都收到通知，或每天只收到一次通知。如果您選擇每天收到一次通知，則通知內容會包含前一天的所有價格變動資訊。建議您設定通知，並在出現變動時取得最新檔案。

**Contents**
+ [設定 Amazon SNS 通知](#set-up-sns-notifications-price-changes)
+ [的通知結構 AWS 服務](#notification-structure-for-aws-services)
+ [Savings Plans 通知結構](#notification-structures-for-aws-savings-plans)

## 設定 Amazon SNS 通知
<a name="set-up-sns-notifications-price-changes"></a>

您可以使用 來 AWS Management Console 註冊 Amazon SNS 通知。

**為價目表檔案更新設定 Amazon SNS 通知**

1. 登入 AWS Management Console ，並在 [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home)：// 開啟 Amazon SNS 主控台。

1. 若您是初次使用 Amazon SNS，請選擇**開始使用**。

1. 如有必要，請將導覽列 AWS 區域 上的 變更為**美國東部 （維吉尼亞北部）**。

1. 在導覽窗格中，選擇**訂閱**。

1. 選擇**建立訂閱**。

1. 針對**主題 ARN**，視需求輸入以下內容：
   + 針對服務定價：
     + 若要在每次價格變動時收到通知，請輸入：`arn:aws:sns:us-east-1:278350005181:price-list-api`
     + 若要每天只收到一次價格變動通知，請輸入：`arn:aws:sns:us-east-1:278350005181:daily-aggregated-price-list-api`
   + 針對 Savings Plans 價格，輸入：`arn:aws:sns:us-east-1:626627529009:SavingsPlanPublishNotifications`

1. 針對**協定**，請使用預設的 `HTTP` 設定。

1. 針對**端點**，指定您要接收通知的格式，例如 Amazon Simple Queue Service (Amazon SQS) AWS Lambda或電子郵件。

1. 選擇**建立訂閱**。

   價格變動時，您會以您在步驟 8 指定的偏好格式收到通知。

**重要**  
如果您收到錯誤訊息無法建立訂閱。錯誤碼：InvalidParameter - 錯誤訊息：參數無效：TopicArn，很有可能是您的區域並未設為美國東部 (維吉尼亞北部)。帳單指標資料存放在此區域中，即使對於其他區域中的資源也是如此。請返回步驟 3 完成本程序的其餘設定。

## 的通知結構 AWS 服務
<a name="notification-structure-for-aws-services"></a>

定價更新通知具有主旨行，格式如下所示。

```
[Pricing Update] New {{<serviceCode>}} offer file available.
```

**Example 範例：主旨行**  
Amazon Relational Database Service (Amazon RDS) 的價格更新通知如下所示。  

```
[Pricing Update] New AmazonRDS offer file available.
```

**Example 範例：通知訊息**  
如果您訂閱 AWS 服務 Amazon SQS、Lambda 或其他 服務，定價更新通知訊息內文的結構如下所示。  

```
{
    "formatVersion":"v1.0",
    "offerCode":"{{<serviceCode>}}",
    "version":"{{<Version number of this new price list>}}",
    "timeStamp":"{{<Publish date of this new price list>}}",
    "url":{
        "JSON":"{{<JSON URL of the current version price list>}}",
        "CSV":"{{<CSV URL of the current version price list>}}"
    },
    "regionIndex":"<Region index url of the current version price list>",
    "operation":"Publish"
}
```
舉例來說，Amazon RDS 的通知訊息如下所示。  

```
{
    "formatVersion":"v1.0",
    "offerCode":"AmazonRDS",
    "version":"20230328234721",
    "timeStamp":"2023-03-28T23:47:21Z",
    "url":{
        "JSON":"https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/index.json",
        "CSV":"https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/index.csv"
    },
    "regionIndex":"https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/region_index.json",
    "operation":"Publish"
}
```

**Example 範例：電子郵件通知**  
如果您訂閱電子郵件，定價更新電子郵件訊息內文的結構如下所示。  

```
Hello,
You've received this notification because you subscribed to receiving updates from SNS topic arn:aws:sns:us-east-1:278350005181:price-list-api.

We've published a new version of the offer file for Service <serviceCode>. To download the offer file, use the following URLs:
  - JSON format : {{<JSON URL of the current version price list>}}
  - CSV format : {{<CSV URL url of the current version price list>}}

To download the index for the region-specific offer files, use the following URL:
   - RegionIndexUrl : {{<Region index URL of the current version price list>}}

To get a daily email that shows all price changes made the previous day, subscribe to the following SNS topic: arn:aws:sns:us-east-1:278350005181:daily-aggregated-price-list-api.

To learn more about offer files and index files, see  http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html.

Thank You,
Amazon Web Services Team
```
Amazon RDS 的範例電子郵件訊息如下所示。  

```
Hello,
You've received this notification because you subscribed to receiving updates from SNS topic arn:aws:sns:us-east-1:278350005181:price-list-api.

We've published a new version of the offer file for Service AmazonRDS. To download the offer file, use the following URLs:
  - JSON format : https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/index.json
  - CSV format : https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/index.csv

To download the index for the region-specific offer files, use the following URL:
   - RegionIndexUrl : https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/current/region_index.json

To get a daily email that shows all price changes made the previous day, subscribe to the following SNS topic: arn:aws:sns:us-east-1:278350005181:daily-aggregated-price-list-api.

To learn more about offer files and index files, see  http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html.

Thank You,
Amazon Web Services Team
```

## Savings Plans 通知結構
<a name="notification-structures-for-aws-savings-plans"></a>

定價更新通知具有主旨行，格式如下所示。

```
[Pricing Update] New {{<Savings Plan name>}} is available.
```

**Example 範例：Savings Plan 的主旨行**  
Savings Plan 的主旨行如下所示。  

```
[Pricing Update] New AWS Compute Savings Plan is available.
```

**Example 範例：通知訊息**  
如果您訂閱 AWS 服務 Amazon SQS、Lambda 或其他 服務，定價更新通知訊息內文的結構如下所示：  

```
{
  "version":"<Version number of this new price list>",
  "offerCode":"<savingsPlanCode which can be used as input to API calls>",
  "savingsPlanCode":"{{<savingsPlan Name>}}",
  "topicArn":"arn:aws:sns:us-east-1:626627529009:SavingsPlanPublishNotifications",
  "versionIndex":"{{<version index url of the version price list>}}",
  "regionIndex":"{{<Region index URL of the version price list>}}"
}
```
舉例來說，`ComputeSavingsPlans` 的通知如下所示。  

```
{
  "version":"20230509202901",
  "offerCode":"AWSComputeSavingsPlan",
  "savingsPlanCode":"ComputeSavingsPlans",
  "topicArn":"arn:aws:sns:us-east-1:626627529009:SavingsPlanPublishNotifications",
  "versionIndex":"https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230509202901/index.json",
  "regionIndex":"https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230509202901/region_index.json"
}
```

**Example 範例：電子郵件通知**  
如果您訂閱電子郵件，定價更新電子郵件內文的結構如下所示。  

```
Hello,

You've received this notification because you subscribed to receiving updates from SNS topic arn:aws:sns:us-east-1:626627529009:SavingsPlanPublishNotifications.

We've published a new version of {{<Savings Plan name>}}.

To download the index of current region specific savings plans, use the following URL:
  - {{<Region index URL of the version price list>}}
  
To download the index of previous versions of savings plans, use the following URL:
  - {{<version index URL of the version price list>}}

To learn more about Savings Plans, see http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html.
To learn about finding Savings Plan prices in an offer file, see https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/sp-offer-file.html

Thank You,
Amazon Web Services Team
```
舉例來說，Savings Plan 的電子郵件內文如下所示。  

```
Hello,

You've received this notification because you subscribed to receiving updates from SNS topic arn:aws:sns:us-east-1:626627529009:SavingsPlanPublishNotifications.

We've published a new version of Compute Savings Plans.

To download the index of current region specific savings plans, use the following URL:
  - https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230509202901/region_index.json
  
To download the index of previous versions of savings plans, use the following URL:
  - https://pricing.us-east-1.amazonaws.com/savingsPlan/v1.0/aws/AWSComputeSavingsPlan/20230509202901/index.json

To learn more about savings plans, see http://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html.
To learn about finding Savings Plan prices in an offer file, see https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/sp-offer-file.html

Thank You,
Amazon Web Services Team
```