

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

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

包含有关特定作业的信息，包括配送信息、作业状态和其他重要元数据。此信息作为 `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>
此作业的创建日期。  
类型：时间戳  
必需：否

 ** 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>
指向为任务报告和日志预先签名 URLs 的 Amazon S3 链接。对于导入作业，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 (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>
表示 S AWS nowball 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>

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