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

# Notification
<a name="API_Notification"></a>

**注意**  
 AWS Snowball Edge 不再向新客户提供。新客户应探索[AWS DataSync](https://aws.amazon.com/datasync/)在线传输、用于安全物理[传输AWS 的数据传输终端](https://aws.amazon.com/data-transfer-terminal/)或 AWS 合作伙伴解决方案。对于边缘计算，请浏览 [AWS Out](https://aws.amazon.com/outposts/) posts。

与特定作业相关的 Amazon Simple Notification Service (Amazon SNS) 通知设置。该 `Notification` 对象作为 `JobMetadata` 数据类型中 `DescribeJob` 操作的响应语法的一部分返回。

在作业创建期间定义通知设置时，您可以选择使用 `JobStatesToNotify` 字符串数组根据一组特定的作业状态进行通知，也可以指定要在 `NotifyAll` 设置为 True 的情况下针对所有作业状态发出 Amazon SNS 通知。

## 内容
<a name="API_Notification_Contents"></a>

 ** DevicePickupSnsTopicARN **   <a name="Snowball-Type-Notification-DevicePickupSnsTopicARN"></a>
用于向设备取货人员发送 SNS 通知（在作业创建时识别）。  
类型：字符串  
长度限制：长度上限为 255。  
模式：`arn:aws.*:sns:.*:[0-9]{12}:.*`  
必需：否

 ** JobStatesToNotify **   <a name="Snowball-Type-Notification-JobStatesToNotify"></a>
将触发此作业通知的作业状态列表。  
类型：字符串数组  
有效值：`New | PreparingAppliance | PreparingShipment | InTransitToCustomer | WithCustomer | InTransitToAWS | WithAWSSortingFacility | WithAWS | InProgress | Complete | Cancelled | Listing | Pending`  
必需：否

 ** NotifyAll **   <a name="Snowball-Type-Notification-NotifyAll"></a>
作业状态的任何更改都将触发此作业的通知。  
类型：布尔值  
必需：否

 ** SnsTopicARN **   <a name="Snowball-Type-Notification-SnsTopicARN"></a>
要与此作业关联的新 SNS `TopicArn`。您可以使用 Amazon SNS API 操作为主题创建[CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)亚马逊资源名称 (ARNs)。  
您可以通过或使用订阅亚马逊简单通知服务 (Amazon SNS) Simple Notification API 操作订阅[亚马](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)逊 SNS 主题的电子邮件地址。 AWS 管理控制台  
类型：字符串  
长度限制：长度上限为 255。  
模式：`arn:aws.*:sns:.*:[0-9]{12}:.*`  
必需：否

## 另请参阅
<a name="API_Notification_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/Notification) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/Notification) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/Notification)