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

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

**注意**  
 AWS Snowball 邊緣 不再提供給新客戶。新客戶應探索[AWS DataSync](https://aws.amazon.com/datasync/)線上傳輸、用於安全實體傳輸的[AWS 資料傳輸終端機](https://aws.amazon.com/data-transfer-terminal/)，或 AWS 合作夥伴解決方案。對於邊緣運算，請探索 [AWS Outposts](https://aws.amazon.com/outposts/)。

與特定任務相關聯的 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>
`TopicArn` 您要與此任務建立關聯的新 SNS。您可以使用 [CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html) Amazon SNS API 動作，為主題建立 Amazon Resource Name (ARNs)。  
您可以透過 AWS 管理主控台或使用[訂閱](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html) Amazon SNS) API 動作來訂閱電子郵件地址至 Amazon SNS 主題。  
類型：字串  
長度限制：長度上限為 255。  
模式：`arn:aws.*:sns:.*:[0-9]{12}:.*`  
必要：否

## 另請參閱
<a name="API_Notification_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/Notification) 
+  [AWS 適用於 Java V2 的 SDK](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)