

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

# FileSystemDescription
<a name="API_FileSystemDescription"></a>

操作系统的描述。

## 目录
<a name="API_FileSystemDescription_Contents"></a>

 ** CreationTime **   <a name="efs-Type-FileSystemDescription-CreationTime"></a>
文件系统的创建时间，以秒为单位（自 1970-01-01T00:00:00Z 起）。  
类型：时间戳  
必需：是

 ** CreationToken **   <a name="efs-Type-FileSystemDescription-CreationToken"></a>
请求中指定的不透明字符串。  
类型：字符串  
长度限制：长度下限为 1。长度上限为 64。  
模式：`.+`  
必需：是

 ** FileSystemId **   <a name="efs-Type-FileSystemDescription-FileSystemId"></a>
文件系统 ID，由 Amazon EFS 分配。  
类型：字符串  
长度限制：最大长度为 128。  
模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`  
必需：是

 ** LifeCycleState **   <a name="efs-Type-FileSystemDescription-LifeCycleState"></a>
文件系统的生命周期阶段。  
类型：字符串  
有效值：`creating | available | updating | deleting | deleted | error`  
必需：是

 ** NumberOfMountTargets **   <a name="efs-Type-FileSystemDescription-NumberOfMountTargets"></a>
文件系统当前的挂载目标数。有关更多信息，请参阅 [CreateMountTarget](API_CreateMountTarget.md)。  
类型：整数  
有效范围：最小值为 0。  
必需：是

 ** OwnerId **   <a name="efs-Type-FileSystemDescription-OwnerId"></a>
创建文件系统的 AWS 账户。  
类型：字符串  
长度限制：最大长度为 14。  
模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$`  
必需：是

 ** PerformanceMode **   <a name="efs-Type-FileSystemDescription-PerformanceMode"></a>
文件系统的性能模式。  
类型：字符串  
有效值：`generalPurpose | maxIO`  
必需：是

 ** SizeInBytes **   <a name="efs-Type-FileSystemDescription-SizeInBytes"></a>
文件系统中存储的数据的最新已知计量大小（以字节为单位）（在其 `Value` 字段中），以及确定该大小的时间（在其 `Timestamp` 字段中）。`Timestamp` 值是自 1970-01-01T00:00:00Z 以来的整数秒数。`SizeInBytes` 值并不代表文件系统一致快照的大小，但是当没有写入文件系统时，该值最终会保持一致。也就是说，只有在超过几个小时的时间内未修改文件系统时，`SizeInBytes` 才表示实际大小。否则，该值不是文件系统在任何时间点的确切大小。  
类型：[FileSystemSize](API_FileSystemSize.md) 对象  
必需：是

 ** Tags **   <a name="efs-Type-FileSystemDescription-Tags"></a>
与文件系统关联的标签，以 `Tag` 对象数组形式呈现。  
类型：[Tag](API_Tag.md) 对象数组  
必需：是

 ** AvailabilityZoneId **   <a name="efs-Type-FileSystemDescription-AvailabilityZoneId"></a>
文件系统所在可用区的唯一且一致的标识符，仅对单区域文件系统有效。例如，`use1-az1` 是 us-east-1 AWS 区域的可用区 ID，它在每个 AWS 账户中的位置均相同。  
类型：字符串  
必需：否

 ** AvailabilityZoneName **   <a name="efs-Type-FileSystemDescription-AvailabilityZoneName"></a>
描述文件系统所在的 AWS 可用区，仅对单区文件系统有效。有关更多信息，请参阅《Amazon EFS 用户指南》**中的[使用 EFS 存储类](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html)。  
类型：字符串  
长度限制：长度下限为 1。长度上限为 64。  
模式：`.+`  
必需：否

 ** Encrypted **   <a name="efs-Type-FileSystemDescription-Encrypted"></a>
一个布尔值，如果设为 true，则指示文件系统已加密。  
类型：布尔值  
必需：否

 ** FileSystemArn **   <a name="efs-Type-FileSystemDescription-FileSystemArn"></a>
EFS 文件系统的 Amazon 资源名称（ARN），采用 `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id ` 格式。使用示例数据的示例：`arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567`  
类型：字符串  
必需：否

 ** FileSystemProtection **   <a name="efs-Type-FileSystemDescription-FileSystemProtection"></a>
描述文件系统上的保护功能。  
类型：[FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) 对象  
必需：否

 ** KmsKeyId **   <a name="efs-Type-FileSystemDescription-KmsKeyId"></a>
用于保护加密文件系统的 AWS KMS key 的 ID。  
类型：字符串  
长度约束：最大长度为 2048。  
模式：`^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$`  
必需：否

 ** Name **   <a name="efs-Type-FileSystemDescription-Name"></a>
可以向文件系统添加标签，包括 `Name` 标签。有关更多信息，请参阅 [CreateFileSystem](API_CreateFileSystem.md)。如果文件系统有 `Name` 标签，Amazon EFS 会返回此字段中的值。  
类型：字符串  
长度约束：最大长度为 256。  
模式：`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`  
必需：否

 ** ProvisionedThroughputInMibps **   <a name="efs-Type-FileSystemDescription-ProvisionedThroughputInMibps"></a>
为文件系统预置的吞吐量（以 MiBps 为单位）。对使用将 `ThroughputMode` 设置为 `provisioned` 的文件系统有效。  
类型：双精度  
有效范围：最小值为 1.0。  
必需：否

 ** ThroughputMode **   <a name="efs-Type-FileSystemDescription-ThroughputMode"></a>
显示文件系统的吞吐量模式。有关更多信息，请参阅**《Amazon EFS 用户指南》中的[吞吐量模式](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes)。  
类型：字符串  
有效值：`bursting | provisioned | elastic`  
必需：否

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

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/FileSystemDescription) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/FileSystemDescription) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/FileSystemDescription) 