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

# ClusterMetadata
<a name="API_ClusterMetadata"></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。

包含与特定集群有关的元数据。

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

 ** AddressId **   <a name="Snowball-Type-ClusterMetadata-AddressId"></a>
为特定地址自动生成的 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-ClusterMetadata-ClusterId"></a>
为集群自动生成的 ID。  
类型：字符串  
长度限制：长度下限为 1。长度上限为 1024。  
模式：`.*`  
必需：否

 ** ClusterState **   <a name="Snowball-Type-ClusterMetadata-ClusterState"></a>
集群的当前状态。  
类型：字符串  
有效值：`AwaitingQuorum | Pending | InUse | Complete | Cancelled`  
必需：否

 ** CreationDate **   <a name="Snowball-Type-ClusterMetadata-CreationDate"></a>
此集群的创建日期。  
类型：时间戳  
必需：否

 ** Description **   <a name="Snowball-Type-ClusterMetadata-Description"></a>
集群的可选描述。  
类型：字符串  
长度限制：长度下限为 1。长度上限为 1024。  
模式：`.*`  
必需：否

 ** ForwardingAddressId **   <a name="Snowball-Type-ClusterMetadata-ForwardingAddressId"></a>
您所在的地区不支持此字段。  
类型：字符串  
长度限制：固定长度为 40。  
模式：`ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}`  
必需：否

 ** JobType **   <a name="Snowball-Type-ClusterMetadata-JobType"></a>
此集群的作业类型。目前，`LOCAL_USE` 是集群唯一支持的作业类型。  
类型：字符串  
有效值：`IMPORT | EXPORT | LOCAL_USE`  
必需：否

 ** KmsKeyARN **   <a name="Snowball-Type-ClusterMetadata-KmsKeyARN"></a>
与此集群关联的 `KmsKeyARN` Amazon 资源名称（ARN）。此 ARN 是使用 (中的 [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html) AWS Key Management Service API 操作创建的。AWS KMS  
类型：字符串  
长度限制：长度上限为 255。  
模式：`arn:aws.*:kms:.*:[0-9]{12}:key/.*`  
必需：否

 ** Notification **   <a name="Snowball-Type-ClusterMetadata-Notification"></a>
此集群的 Amazon Simple Notification Service（Amazon SNS）通知设置。  
类型：[Notification](API_Notification.md) 对象  
必需：否

 ** OnDeviceServiceConfiguration **   <a name="Snowball-Type-ClusterMetadata-OnDeviceServiceConfiguration"></a>
表示 S AWS nowball Edge 设备上服务的元数据和配置设置。  
类型：[OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) 对象  
必需：否

 ** Resources **   <a name="Snowball-Type-ClusterMetadata-Resources"></a>
[JobResource](API_JobResource.md) 对象的数组，可能包含更新的 [S3Resource](API_S3Resource.md) 或 [LambdaResource](API_LambdaResource.md) 对象。  
类型：[JobResource](API_JobResource.md) 对象  
必需：否

 ** RoleARN **   <a name="Snowball-Type-ClusterMetadata-RoleARN"></a>
与此集群关联的角色 ARN。此 ARN 是使用 AWS Identity and Access Management (IAM) 中的 [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)API 操作创建的。  
类型：字符串  
长度限制：长度上限为 255。  
模式：`arn:aws.*:iam::[0-9]{12}:role/.*`  
必需：否

 ** ShippingOption **   <a name="Snowball-Type-ClusterMetadata-ShippingOption"></a>
此集群中每个节点的配送速度。这个速度并不指示您需要多长时间收到每台设备，而是表示每台设备运送到目的地的运输速度。每个区域配送速度如下所示：  
+ 在澳大利亚，您可以享受快递服务。通常，快递运输设备大约需要一天时间。
+ 在欧盟 (EU)，您可以享受快递服务。通常，快递运输 Snow 设备大约需要一天时间。此外，欧盟的大多数国家/地区还可以使用标准运输，通常单程需要的时间不超过一周。
+ 在印度，Snow 设备将在一到七天内送达。
+ 在美国，您可以享受次日达和隔日达。
类型：字符串  
有效值：`SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD`  
必需：否

 ** SnowballType **   <a name="Snowball-Type-ClusterMetadata-SnowballType"></a>
用于此集群的 Snowball Edge 设备类型。  
对于集群作业， AWS Snowball Edge 目前仅支持该`EDGE`设备类型。
类型：字符串  
有效值：`STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C`  
必需：否

 ** TaxDocuments **   <a name="Snowball-Type-ClusterMetadata-TaxDocuments"></a>
您所需要的税务文件 AWS 区域。  
类型：[TaxDocuments](API_TaxDocuments.md) 对象  
必需：否

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

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