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

# 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 以來)。  
類型：Timestamp  
必要：是

 ** CreationToken **   <a name="efs-Type-FileSystemDescription-CreationToken"></a>
請求中指定的不透明字串。  
類型：字串  
長度限制：長度下限為 1。長度上限為 64。  
模式：`.+`  
必要：是

 ** FileSystemId **   <a name="efs-Type-FileSystemDescription-FileSystemId"></a>
由 Amazon EFS 指派的檔案系統 ID。  
類型：字串  
長度限制：長度上限為 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 的可用區域 ID AWS 區域，且每個 都有相同的位置 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>
Amazon EFS 檔案系統的 Amazon Resource Name (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>
檔案系統的佈建輸送量總量 (以 MiB/s 為單位)。對使用 `ThroughputMode` 設定為 `provisioned` 的檔案系統有效。  
類型：Double  
有效範圍：最小值為 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 SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/FileSystemDescription) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/FileSystemDescription) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/FileSystemDescription)