

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 设置价格更新通知
<a name="notifications-price-list-api"></a>


|  | 
| --- |
| 要提供相关的反馈 AWS 价目表，请完成这[份简短的调查](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA)。您的回复将是匿名的。**注意：**本调查仅提供英文版。 | 

价目表文件可以随时更改。更新价目表文件后，系统将发送 Amazon Simple Notification Service（Amazon SNS）通知。您可以设置为在价格发生变化时接收通知，例如价格 AWS 下调或推出新产品和服务时。

您可在每次价格更改时收到通知，或每天接收一次通知。如果选择每天收到一次通知，则通知将包含前一天应用的所有价格更改。我们建议您设置通知，方便在其更改时获取最新文件。

**Contents**
+ [设置 Amazon SNS 通知](#set-up-sns-notifications-price-changes)
+ [的通知结构 AWS 服务](#notification-structure-for-aws-services)
+ [节省计划的通知结构](#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 并在 v3/home 上打开亚马逊 SNS 控制台。https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)

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`
   + 对于节省计划定价 – 请输入 `arn:aws:sns:us-east-1:626627529009:SavingsPlanPublishNotifications`

1. 对于**协议**，请使用默认的 `HTTP` 设置。

1. 对于 **Endpoint**，请指定您想要接收通知的格式，例如亚马逊简单队列服务 (Amazon SQS) Simple Queue Service AWS Lambda或电子邮件。

1. 选择**创建订阅**。

   当价格发生变化时，您将收到采用步骤 8 中指定的首选格式的通知。

**重要**  
如果您收到错误消息 Couldn't create subscription. 错误代码： 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
```

## 节省计划的通知结构
<a name="notification-structures-for-aws-savings-plans"></a>

定价更新通知的主题行采用以下格式。

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

**Example 示例：节省计划的主题行**  
节省计划的主题行如下所示。  

```
[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
```
例如，节省计划的电子邮件正文如下所示。  

```
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
```