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

# JobMetadata
<a name="API_JobMetadata"></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/)。

包含特定任務的相關資訊，包括運送資訊、任務狀態和其他重要的中繼資料。此資訊會傳回為 `DescribeJob`動作回應語法的一部分。

## 目錄
<a name="API_JobMetadata_Contents"></a>

 ** AddressId **   <a name="Snowball-Type-JobMetadata-AddressId"></a>
您希望 Snow 裝置運送目的地之地址的 ID。  
類型：字串  
長度限制：固定長度為 40。  
模式：`ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}`  
必要：否

 ** ClusterId **   <a name="Snowball-Type-JobMetadata-ClusterId"></a>
叢集的 39 個字元 ID，例如 `CID123e4567-e89b-12d3-a456-426655440000`。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`.*`  
必要：否

 ** CreationDate **   <a name="Snowball-Type-JobMetadata-CreationDate"></a>
此任務的建立日期。  
類型：Timestamp  
必要：否

 ** DataTransferProgress **   <a name="Snowball-Type-JobMetadata-DataTransferProgress"></a>
定義 Snow 裝置在 時資料傳輸的即時狀態的值 AWS。此資料只有在任務`JobState`的值為 時`InProgress`，才能用於匯入和匯出任務。  
類型：[DataTransfer](API_DataTransfer.md) 物件  
必要：否

 ** Description **   <a name="Snowball-Type-JobMetadata-Description"></a>
任務的描述，在建立任務時提供。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`.*`  
必要：否

 ** DeviceConfiguration **   <a name="Snowball-Type-JobMetadata-DeviceConfiguration"></a>
的容器`SnowconeDeviceConfiguration`。  
類型：[DeviceConfiguration](API_DeviceConfiguration.md) 物件  
必要：否

 ** ForwardingAddressId **   <a name="Snowball-Type-JobMetadata-ForwardingAddressId"></a>
您的區域不支援此欄位。  
類型：字串  
長度限制：固定長度為 40。  
模式：`ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}`  
必要：否

 ** ImpactLevel **   <a name="Snowball-Type-JobMetadata-ImpactLevel"></a>
將在裝置上儲存或處理的最高影響層級資料，在建立任務時提供。  
類型：字串  
有效值:`IL2 | IL4 | IL5 | IL6 | IL99`   
必要：否

 ** JobId **   <a name="Snowball-Type-JobMetadata-JobId"></a>
自動產生的任務 ID，例如 `JID123e4567-e89b-12d3-a456-426655440000`。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`.*`  
必要：否

 ** JobLogInfo **   <a name="Snowball-Type-JobMetadata-JobLogInfo"></a>
工作報告和日誌的 Amazon S3 URLs 連結。對於匯入任務，PDF 任務報告會在匯入程序結束時提供。對於匯出任務，您的任務報告通常會在交付任務組件的 Snow 裝置給您時變成可用。  
類型：[JobLogs](API_JobLogs.md) 物件  
必要：否

 ** JobState **   <a name="Snowball-Type-JobMetadata-JobState"></a>
任務的目前狀態。  
類型：字串  
有效值:`New | PreparingAppliance | PreparingShipment | InTransitToCustomer | WithCustomer | InTransitToAWS | WithAWSSortingFacility | WithAWS | InProgress | Complete | Cancelled | Listing | Pending`   
必要：否

 ** JobType **   <a name="Snowball-Type-JobMetadata-JobType"></a>
任務的類型。  
類型：字串  
有效值:`IMPORT | EXPORT | LOCAL_USE`   
必要：否

 ** KmsKeyARN **   <a name="Snowball-Type-JobMetadata-KmsKeyARN"></a>
與此任務相關聯的 AWS Key Management Service () 金鑰的 Amazon Resource Name (ARN AWS KMS)。此 ARN 是使用 中的 [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html) API 動作建立 AWS KMS。  
類型：字串  
長度限制：長度上限為 255。  
模式：`arn:aws.*:kms:.*:[0-9]{12}:key/.*`  
必要：否

 ** LongTermPricingId **   <a name="Snowball-Type-JobMetadata-LongTermPricingId"></a>
裝置長期定價類型的 ID。  
類型：字串  
長度限制：固定長度為 41。  
模式：`LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}`  
必要：否

 ** Notification **   <a name="Snowball-Type-JobMetadata-Notification"></a>
與特定任務相關聯的 Amazon Simple Notification Service (Amazon SNS) 通知設定。`Notification` 物件會傳回為 `JobMetadata`資料類型中 `DescribeJob`動作回應語法的一部分。  
類型：[Notification](API_Notification.md) 物件  
必要：否

 ** OnDeviceServiceConfiguration **   <a name="Snowball-Type-JobMetadata-OnDeviceServiceConfiguration"></a>
代表 AWS Snowball Edge 裝置上的 服務的中繼資料和組態設定。  
類型：[OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) 物件  
必要：否

 ** PickupDetails **   <a name="Snowball-Type-JobMetadata-PickupDetails"></a>
識別收取裝置之人員的資訊。  
類型：[PickupDetails](API_PickupDetails.md) 物件  
必要：否

 ** RemoteManagement **   <a name="Snowball-Type-JobMetadata-RemoteManagement"></a>
可讓您從內部網路外部安全地從遠端操作和管理 Snowcone 裝置。設定為 時`INSTALLED_AUTOSTART`，當裝置到達您的位置時，遠端管理將自動可用。否則，您需要使用 Snowball 用戶端來管理裝置。  
類型：字串  
有效值:`INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED`   
必要：否

 ** Resources **   <a name="Snowball-Type-JobMetadata-Resources"></a>
`S3Resource` 物件的陣列。每個`S3Resource`物件代表 Amazon S3 儲存貯體，您傳輸的資料將從中匯出或匯入。  
類型：[JobResource](API_JobResource.md) 物件  
必要：否

 ** RoleARN **   <a name="Snowball-Type-JobMetadata-RoleARN"></a>
與此任務相關聯的角色 ARN。此 ARN 是使用其中的 [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) API 動作建立 AWS Identity and Access Management。  
類型：字串  
長度限制：長度上限為 255。  
模式：`arn:aws.*:iam::[0-9]{12}:role/.*`  
必要：否

 ** ShippingDetails **   <a name="Snowball-Type-JobMetadata-ShippingDetails"></a>
任務的運送資訊，包括傳入和傳出追蹤號碼和運送速度選項。  
類型：[ShippingDetails](API_ShippingDetails.md) 物件  
必要：否

 ** SnowballCapacityPreference **   <a name="Snowball-Type-JobMetadata-SnowballCapacityPreference"></a>
此任務的 Snow 裝置容量偏好設定，在任務建立時指定。在美國區域中，您可以選擇 50 TB 到 80 TB 的 Snowball。所有其他區域都使用 80 TB 容量的 Snowball。  
如需 Snowball Edge 裝置類型的資訊，請參閱《Snowball Edge 開發人員指南》中的[裝置硬體差異](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html)。  
類型：字串  
有效值:`T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13`   
必要：否

 ** SnowballId **   <a name="Snowball-Type-JobMetadata-SnowballId"></a>
與裝置相關聯的唯一 ID。  
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
模式：`.*`  
必要：否

 ** SnowballType **   <a name="Snowball-Type-JobMetadata-SnowballType"></a>
與此任務搭配使用的裝置類型。  
類型：字串  
有效值:`STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C`   
必要：否

 ** TaxDocuments **   <a name="Snowball-Type-JobMetadata-TaxDocuments"></a>
與 中所需稅務文件相關聯的中繼資料 AWS 區域。  
類型：[TaxDocuments](API_TaxDocuments.md) 物件  
必要：否

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

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