

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

# 資料類型
<a name="API_Types"></a>

目前支援下列資料類型：
+  [AccessPointDescription](API_AccessPointDescription.md) 
+  [BackupPolicy](API_BackupPolicy.md) 
+  [CreationInfo](API_CreationInfo.md) 
+  [Destination](API_Destination.md) 
+  [DestinationToCreate](API_DestinationToCreate.md) 
+  [FileSystemDescription](API_FileSystemDescription.md) 
+  [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) 
+  [FileSystemSize](API_FileSystemSize.md) 
+  [LifecyclePolicy](API_LifecyclePolicy.md) 
+  [MountTargetDescription](API_MountTargetDescription.md) 
+  [PosixUser](API_PosixUser.md) 
+  [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md) 
+  [ResourceIdPreference](API_ResourceIdPreference.md) 
+  [RootDirectory](API_RootDirectory.md) 
+  [Tag](API_Tag.md) 

# AccessPointDescription
<a name="API_AccessPointDescription"></a>

提供 EFS 檔案系統存取點說明。

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

 ** AccessPointArn **   <a name="efs-Type-AccessPointDescription-AccessPointArn"></a>
與存取點關聯的唯一 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 128。  
模式：`^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$`  
必要：否

 ** AccessPointId **   <a name="efs-Type-AccessPointDescription-AccessPointId"></a>
由 Amazon EFS 指派的存取點 ID。  
類型：字串  
長度限制：長度上限為 128。  
模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`  
必要：否

 ** ClientToken **   <a name="efs-Type-AccessPointDescription-ClientToken"></a>
請求中指定的不透明字串，以確保等冪建立。  
類型：字串  
長度限制：長度下限為 1。長度上限為 64。  
模式：`.+`  
必要：否

 ** FileSystemId **   <a name="efs-Type-AccessPointDescription-FileSystemId"></a>
存取點套用至 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-AccessPointDescription-LifeCycleState"></a>
識別存取點的生命周期階段。  
類型：字串  
有效值:`creating | available | updating | deleting | deleted | error`   
必要：否

 ** Name **   <a name="efs-Type-AccessPointDescription-Name"></a>
存取點的名稱。這是 `Name` 標籤的值。  
類型：字串  
必要：否

 ** OwnerId **   <a name="efs-Type-AccessPointDescription-OwnerId"></a>
識別 AWS 帳戶 擁有存取點資源的 。  
類型：字串  
長度限制：長度上限為 14。  
模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$`  
必要：否

 ** PosixUser **   <a name="efs-Type-AccessPointDescription-PosixUser"></a>
完整的 POSIX 身分識別，包括存取點上的使用者 ID、群組 ID 和次要群組 ID，這些 ID 適用於 NFS 用戶端使用存取點的所有檔案作業。  
類型：[PosixUser](API_PosixUser.md) 物件  
必要：否

 ** RootDirectory **   <a name="efs-Type-AccessPointDescription-RootDirectory"></a>
存取點在 EFS 檔案系統上公開的目錄，作爲 NFS 用戶端通過該存取點訪問 EFS 檔案系統的根目錄。  
類型：[RootDirectory](API_RootDirectory.md) 物件  
必要：否

 ** Tags **   <a name="efs-Type-AccessPointDescription-Tags"></a>
與存取點相關聯的標籤，顯示為「標籤」物件的陣列。  
類型：[Tag](API_Tag.md) 物件陣列  
必要：否

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

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

# BackupPolicy
<a name="API_BackupPolicy"></a>

用於建立每日自動備份的檔案系統的備份政策。如果狀態值為 `ENABLED`，表示正在自動備份檔案系統。如需詳細資訊，請參閱[自動備份](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups)。

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

 ** Status **   <a name="efs-Type-BackupPolicy-Status"></a>
描述檔案系統備份政策狀態。  
+  **`ENABLED`**：EFS 正在自動備份檔案系統。
+  **`ENABLING`**：EFS 正在開啟檔案系統自動備份。
+  **`DISABLED`**：關閉檔案系統自動備份。
+  **`DISABLING`**：EFS 正在關閉檔案系統自動備份。
類型：字串  
有效值:`ENABLED | ENABLING | DISABLED | DISABLING`   
必要：是

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

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

# CreationInfo
<a name="API_CreationInfo"></a>

如果指定的 `RootDirectory` > `Path` 不存在，則需要此選項。指定要套用至存取點的 `RootDirectory` > `Path` 的 POSIX ID 和許可。如果存取點根目錄不存在，當用戶端連線到存取點時，EFS 會使用這些設定來建立它。指定 `CreationInfo` 時，您必須包含所有屬性的值。

只有在您提供目錄的 CreationInfo：OwnUid、OwnGID 和許可時，Amazon EFS 才會建立根目錄。如果您未提供此資訊，則 Amazon EFS 不會建立根目錄。如果根目錄不存在，嘗試使用存取點掛載將會失敗。

**重要**  
如果您不提供 `CreationInfo` 且指定的 `RootDirectory` 不存在，則嘗試使用存取點掛載檔案系統將會失敗。

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

 ** OwnerGid **   <a name="efs-Type-CreationInfo-OwnerGid"></a>
指定要套用至 `RootDirectory` 的 POSIX 群組 ID。接受從 0 到 2^32 的值 (4294967295)。  
類型：Long  
有效範圍：最小值為 0。最大值為 4294967295。  
必要：是

 ** OwnerUid **   <a name="efs-Type-CreationInfo-OwnerUid"></a>
指定要套用至 `RootDirectory` 的 POSIX 使用者 ID。接受從 0 到 2^32 的值 (4294967295)。  
類型：Long  
有效範圍：最小值為 0。最大值為 4294967295。  
必要：是

 ** Permissions **   <a name="efs-Type-CreationInfo-Permissions"></a>
以表示檔案模式位元的八進位數字格式，指定要套用至 `RootDirectory` 的 POSIX 許可。  
類型：字串  
長度限制：長度下限為 3。長度上限為 4。  
模式：`^[0-7]{3,4}$`  
必要：是

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

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

# Destination
<a name="API_Destination"></a>

描述複寫組態中的目的地檔案系統。

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

 ** FileSystemId **   <a name="efs-Type-Destination-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})$`  
必要：是

 ** Region **   <a name="efs-Type-Destination-Region"></a>
 AWS 區域 目的地檔案系統所在的 。  
類型：字串  
長度限制：長度下限為 1。長度上限為 64。  
模式：`^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`  
必要：是

 ** Status **   <a name="efs-Type-Destination-Status"></a>
描述複寫組態的狀態。如需複寫狀態的詳細資訊，請參閱《*Amazon EFS 使用者指南*》中的[檢視複寫詳細資訊](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#restoring-backup-efsmonitoring-replication-status.html)。  
類型：字串  
有效值:`ENABLED | ENABLING | DELETING | ERROR | PAUSED | PAUSING`   
必要：是

 ** LastReplicatedTimestamp **   <a name="efs-Type-Destination-LastReplicatedTimestamp"></a>
在目的地檔案系統上順利完成最近一次同步的時間。在此之前，對來源檔案系統上的資料所做的任何變更都已經成功複寫到目的檔案系統中。在此之後，系統可能無法完全複寫發生的任何變更。  
類型：Timestamp  
必要：否

 ** OwnerId **   <a name="efs-Type-Destination-OwnerId"></a>
目的地檔案系統所在的 AWS 帳戶 的 ID。  
類型：字串  
長度限制：長度上限為 14。  
模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$`  
必要：否

 ** RoleArn **   <a name="efs-Type-Destination-RoleArn"></a>
來源帳戶中 IAM 角色的 Amazon Resource Name (ARN)，允許 Amazon EFS 代其執行複寫。這是相同帳戶複寫的選用項目，跨帳戶複寫則為必要項目。  
類型：字串  
長度限制：長度上限為 2048。  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：否

 ** StatusMessage **   <a name="efs-Type-Destination-StatusMessage"></a>
提供複寫目的地組態之 `PAUSED`或 `ERRROR` 狀態詳細資訊的訊息。如需複寫狀態訊息的詳細資訊，請參閱《*Amazon EFS 使用者指南*》中的[檢視複寫詳細資訊](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#restoring-backup-efsmonitoring-replication-status.html)。  
類型：字串  
必要：否

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

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

# DestinationToCreate
<a name="API_DestinationToCreate"></a>

描述複寫組態中的新或現有目的地檔案系統。
+ 如果您想要複寫到新的檔案系統，請勿指定目的地檔案系統的檔案系統 ID。Amazon EFS 會建立新的空白檔案系統。對於單區域儲存，指定要在其中建立檔案系統的可用區域。若要使用預設 KMS AWS Key Management Service 金鑰以外的 金鑰，請加以指定。如需詳細資訊，請參閱《[Amazon EFS 使用者指南》中的設定複寫至新的 Amazon EFS 檔案系統](https://docs.aws.amazon.com/efs/latest/ug/create-replication.html)。 * EFS *
**注意**  
建立檔案系統後，您無法變更 KMS 金鑰或效能模式。
+ 如果您想要複寫到與來源檔案系統位於相同帳戶中的現有檔案系統，則需要提供要複寫的檔案系統的 ID 或 Amazon Resource Name (ARN)。必須停用檔案系統的複寫覆寫保護。如需詳細資訊，請參閱《*Amazon EFS 使用者指南*》中的[複寫至現有的檔案系統](https://docs.aws.amazon.com/efs/latest/ug/efs-replication#replicate-existing-destination)。
+ 如果您要將檔案系統複寫到與來源檔案系統 （跨帳戶複寫） 不同的帳戶中的檔案系統，您需要提供檔案系統的 ARN 和允許 Amazon EFS 在目的地帳戶上執行複寫的 IAM 角色。必須停用檔案系統的複寫覆寫保護。如需詳細資訊，請參閱《*Amazon EFS 使用者指南*》中的[跨 複寫 AWS 帳戶](https://docs.aws.amazon.com/efs/latest/ug/cross-account-replication.html)。

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

 ** AvailabilityZoneName **   <a name="efs-Type-DestinationToCreate-AvailabilityZoneName"></a>
若要建立使用單區域儲存的檔案系統，請指定要在其中建立目的地檔案系統的可用區域名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 64。  
模式：`.+`  
必要：否

 ** FileSystemId **   <a name="efs-Type-DestinationToCreate-FileSystemId"></a>
要用於目的地之檔案系統的 ID 或 ARN。對於跨帳戶複寫，這必須是 ARN。檔案系統的複寫機制要求必須禁用複寫覆寫。如果未指定 ID 或 ARN，則會建立新的檔案系統。  
當您最初設定複寫至現有檔案系統時，Amazon EFS 會將資料寫入目的地檔案系統或從中移除現有資料，以符合來源檔案系統中的資料。如果您不想變更目的地檔案系統中的資料，則應改為複寫到新的檔案系統。如需詳細資訊，請參閱[https://docs.aws.amazon.com/efs/latest/ug/create-replication.html](https://docs.aws.amazon.com/efs/latest/ug/create-replication.html)。
類型：字串  
長度限制：長度上限為 128。  
模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`  
必要：否

 ** KmsKeyId **   <a name="efs-Type-DestinationToCreate-KmsKeyId"></a>
指定您要用來加密目的地檔案系統的 AWS Key Management Service (AWS KMS) 金鑰。如果您並未指定 KMS 金鑰，那麽 Amazon EFS 會使用預設 KMS 金鑰 `/aws/elasticfilesystem` 為 Amazon EFS 的提供服務。此 ID 可以是下列其中一個格式：  
+ 金鑰 ID：金鑰的唯一識別碼，例如 `1234abcd-12ab-34cd-56ef-1234567890ab`。
+ ARN - 金鑰的 ARN，例如 `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`。
+ 金鑰別名 - 先前為金鑰建立的顯示名稱，例如 `alias/projectKey1`。
+ 金鑰別名 ARN：金鑰別名的 ARN，例如 `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`。
類型：字串  
長度限制：長度上限為 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/_-]+))))$`  
必要：否

 ** Region **   <a name="efs-Type-DestinationToCreate-Region"></a>
若要建立使用區域性儲存的檔案系統，請指定要在 AWS 區域 其中建立目的地檔案系統的 。必須為 AWS 帳戶 擁有來源檔案系統的 啟用 區域。如需詳細資訊，請參閱《 * AWS 一般參考參考指南*》中的[管理 AWS 區域](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)。  
類型：字串  
長度限制：長度下限為 1。長度上限為 64。  
模式：`^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`  
必要：否

 ** RoleArn **   <a name="efs-Type-DestinationToCreate-RoleArn"></a>
來源帳戶中 IAM 角色的 Amazon Resource Name (ARN)，允許 Amazon EFS 代其執行複寫。這是相同帳戶複寫的選用項目，跨帳戶複寫則為必要項目。  
類型：字串  
長度限制：長度上限為 2048。  
模式：`arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：否

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

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

# 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) 

# FileSystemProtectionDescription
<a name="API_FileSystemProtectionDescription"></a>

說明檔案系統的防護。

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

 ** ReplicationOverwriteProtection **   <a name="efs-Type-FileSystemProtectionDescription-ReplicationOverwriteProtection"></a>
檔案系統複寫覆寫保護的狀態。  
+  `ENABLED`：檔案系統不能在複寫組態中作爲目的地檔案系統。檔案系統可寫入。複寫覆寫保護預設為 `ENABLED`。
+  `DISABLED`：檔案系統能在複寫組態中作爲目的地檔案系統。檔案系統為只讀，只可由 EFS 複寫修改。
+  `REPLICATING`：檔案系統正在複寫組態中用作目的地檔案系統。檔案系統是唯讀的，並且只能透過 EFS 複寫進行修改。
如果刪除複寫組態，那麽檔案系統的複寫覆寫保護會重新啓動，且檔案系統變為可寫入。  
類型：字串  
有效值:`ENABLED | DISABLED | REPLICATING`   
必要：否

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

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

# FileSystemSize
<a name="API_FileSystemSize"></a>

儲存在檔案系統、`Value` 欄位中的資料最新已知計量大小 (以位元組為單位)，以及在 `Timestamp` 欄位中決定該大小的時間。該值不代表檔案系統的一致快照集大小，但是在沒有寫入檔案系統時，它最終會保持一致。也就是說，只有超過幾個小時未修改檔案系統，該值才能表示實際大小。否則，并不需要用該值來代表檔案系統在任何時間點的確切大小。

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

 ** Value **   <a name="efs-Type-FileSystemSize-Value"></a>
儲存在檔案系統中的資料的最新已知計量大小 (以位元組為單位)。  
類型：Long  
有效範圍：最小值為 0。  
必要：是

 ** Timestamp **   <a name="efs-Type-FileSystemSize-Timestamp"></a>
在 `Value` 欄位中傳回的資料大小是在某個時間點確定的。 值是自 1970-01-01T00:00:00Z 以來的整數秒數。  
類型：Timestamp  
必要：否

 ** ValueInArchive **   <a name="efs-Type-FileSystemSize-ValueInArchive"></a>
儲存在「封存」儲存類別中的資料的最新已知計量大小 (以位元組為單位)。  
類型：Long  
有效範圍：最小值為 0。  
必要：否

 ** ValueInIA **   <a name="efs-Type-FileSystemSize-ValueInIA"></a>
儲存在 Infrequent Access 儲存類別中的資料的最新已知計量大小 (以位元組為單位)。  
類型：Long  
有效範圍：最小值為 0。  
必要：否

 ** ValueInStandard **   <a name="efs-Type-FileSystemSize-ValueInStandard"></a>
儲存在「標準」儲存類別中的資料的最新已知計量大小 (以位元組為單位)。  
類型：Long  
有效範圍：最小值為 0。  
必要：否

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

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

# LifecyclePolicy
<a name="API_LifecyclePolicy"></a>

描述生命週期管理所使用的政策，指定何時將檔案移入和移出儲存類別。如需詳細資訊，請參閱[管理檔案系統儲存](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html)。

**注意**  
使用 `put-lifecycle-configuration` CLI 命令或 `PutLifecycleConfiguration` API 動作時，Amazon EFS 要求每個 `LifecyclePolicy` 物件只能有一次轉移。這意味著在請求內文中，`LifecyclePolicies` 必須結構化為 `LifecyclePolicy` 物件陣列，每次轉換對應一個物件。如需詳細資訊，請參閱 [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md) 中的請求範例。

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

 ** TransitionToArchive **   <a name="efs-Type-LifecyclePolicy-TransitionToArchive"></a>
在主要儲存體 （標準儲存體方案） 中上次存取檔案後，將檔案移至封存儲存體的天數。中繼資料操作 (例如列出目錄內容) 不計入為檔案存取事件。  
類型：字串  
有效值:`AFTER_1_DAY | AFTER_7_DAYS | AFTER_14_DAYS | AFTER_30_DAYS | AFTER_60_DAYS | AFTER_90_DAYS | AFTER_180_DAYS | AFTER_270_DAYS | AFTER_365_DAYS`   
必要：否

 ** TransitionToIA **   <a name="efs-Type-LifecyclePolicy-TransitionToIA"></a>
檔案在最後一次存取后的一定天數内，如果位於主儲存(標準儲存類別)，則將其移動到 Infrequent Access (IA) 儲存中。中繼資料操作 (例如列出目錄內容) 不計入為檔案存取事件。  
類型：字串  
有效值:`AFTER_7_DAYS | AFTER_14_DAYS | AFTER_30_DAYS | AFTER_60_DAYS | AFTER_90_DAYS | AFTER_1_DAY | AFTER_180_DAYS | AFTER_270_DAYS | AFTER_365_DAYS`   
必要：否

 ** TransitionToPrimaryStorageClass **   <a name="efs-Type-LifecyclePolicy-TransitionToPrimaryStorageClass"></a>
檔案儲存到 IA 或「封存」儲存中后，是否再移回主 (標準) 存儲。中繼資料操作 (例如列出目錄內容) 不計入為檔案存取事件。  
類型：字串  
有效值:`AFTER_1_ACCESS`   
必要：否

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

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

# MountTargetDescription
<a name="API_MountTargetDescription"></a>

提供掛載目標說明。

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

 ** FileSystemId **   <a name="efs-Type-MountTargetDescription-FileSystemId"></a>
指定掛載目標所屬的檔案系統 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-MountTargetDescription-LifeCycleState"></a>
掛載目標的生命週期狀態。  
類型：字串  
有效值:`creating | available | updating | deleting | deleted | error`   
必要：是

 ** MountTargetId **   <a name="efs-Type-MountTargetDescription-MountTargetId"></a>
系統指定的掛載目標 ID。  
類型：字串  
長度限制：長度下限為 13。長度上限為 45。  
模式：`^fsmt-[0-9a-f]{8,40}$`  
必要：是

 ** SubnetId **   <a name="efs-Type-MountTargetDescription-SubnetId"></a>
掛載目標子網路的 ID。  
類型：字串  
長度限制：長度下限為 15。長度上限為 47。  
模式：`^subnet-[0-9a-f]{8,40}$`  
必要：是

 ** AvailabilityZoneId **   <a name="efs-Type-MountTargetDescription-AvailabilityZoneId"></a>
掛載目標所在可用區域的唯一且一致的識別碼。例如， `use1-az1` 是 us-east-1 區域的 AZ ID，每個區域都有相同的位置 AWS 帳戶。  
類型：字串  
必要：否

 ** AvailabilityZoneName **   <a name="efs-Type-MountTargetDescription-AvailabilityZoneName"></a>
掛載目標所在可用區域名稱。可用區域會獨立對應至每個可用區域的名稱 AWS 帳戶。例如，您 `us-east-1a`的可用區域 AWS 帳戶 可能與其他 的可用區域不同`us-east-1a` AWS 帳戶。  
類型：字串  
長度限制：長度下限為 1。長度上限為 64。  
模式：`.+`  
必要：否

 ** IpAddress **   <a name="efs-Type-MountTargetDescription-IpAddress"></a>
掛載目標的 IPv4 地址。  
類型：字串  
長度限制：長度下限為 7。長度上限為 15。  
模式：`^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`  
必要：否

 ** Ipv6Address **   <a name="efs-Type-MountTargetDescription-Ipv6Address"></a>
掛載目標的 IPv6 地址。  
類型：字串  
長度限制：長度下限為 3。長度上限為 39。  
必要：否

 ** NetworkInterfaceId **   <a name="efs-Type-MountTargetDescription-NetworkInterfaceId"></a>
Amazon EFS 建立掛載目標時建立的網路介面 ID。  
類型：字串  
必要：否

 ** OwnerId **   <a name="efs-Type-MountTargetDescription-OwnerId"></a>
 AWS 帳戶 擁有資源的 ID。  
類型：字串  
長度限制：長度上限為 14。  
模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$`  
必要：否

 ** VpcId **   <a name="efs-Type-MountTargetDescription-VpcId"></a>
掛載目標所在的虛擬私有雲端 (VPC)。  
類型：字串  
必要：否

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

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

# PosixUser
<a name="API_PosixUser"></a>

存取點上的完整 POSIX 身分識別，包括使用者 ID 、群組 ID 和任何次要群組 ID，該存取點用於 NFS 用戶端，系統會使用該存取點執行的所有檔案系統作業。

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

 ** Gid **   <a name="efs-Type-PosixUser-Gid"></a>
POSIX 群組 ID 會用於所有使用此存取點的檔案系統操作。  
類型：Long  
有效範圍：最小值為 0。最大值為 4294967295。  
必要：是

 ** Uid **   <a name="efs-Type-PosixUser-Uid"></a>
使用此存取點的所有檔案系統作業所使用的 POSIX 使用者 ID。  
類型：Long  
有效範圍：最小值為 0。最大值為 4294967295。  
必要：是

 ** SecondaryGids **   <a name="efs-Type-PosixUser-SecondaryGids"></a>
次要 POSIX 群組 ID 會用於所有使用此存取點的檔案系統操作。  
類型：長整數陣列  
陣列成員：項目數下限為 0。項目數上限為 16。  
有效範圍：最小值為 0。最大值為 4294967295。  
必要：否

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

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

# ReplicationConfigurationDescription
<a name="API_ReplicationConfigurationDescription"></a>

描述特定檔案系統的複寫組態。

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

 ** CreationTime **   <a name="efs-Type-ReplicationConfigurationDescription-CreationTime"></a>
說明建立複寫組態的時間。  
類型：Timestamp  
必要：是

 ** Destinations **   <a name="efs-Type-ReplicationConfigurationDescription-Destinations"></a>
目的地物件陣列。僅支援一個目的地物件。  
類型：[Destination](API_Destination.md) 物件陣列  
必要：是

 ** OriginalSourceFileSystemArn **   <a name="efs-Type-ReplicationConfigurationDescription-OriginalSourceFileSystemArn"></a>
複寫組態中原始來源 EFS 檔案系統的 Amazon Resource Name (ARN)。  
類型：字串  
必要：是

 ** SourceFileSystemArn **   <a name="efs-Type-ReplicationConfigurationDescription-SourceFileSystemArn"></a>
複寫組態中當前來源檔案系統的 Amazon Resource Name (ARN)。  
類型：字串  
必要：是

 ** SourceFileSystemId **   <a name="efs-Type-ReplicationConfigurationDescription-SourceFileSystemId"></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})$`  
必要：是

 ** SourceFileSystemRegion **   <a name="efs-Type-ReplicationConfigurationDescription-SourceFileSystemRegion"></a>
 AWS 區域 來源 EFS 檔案系統所在的 。  
類型：字串  
長度限制：長度下限為 1。長度上限為 64。  
模式：`^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`  
必要：是

 ** SourceFileSystemOwnerId **   <a name="efs-Type-ReplicationConfigurationDescription-SourceFileSystemOwnerId"></a>
來源檔案系統所在的 AWS 帳戶 的 ID。  
類型：字串  
長度限制：長度上限為 14。  
模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$`  
必要：否

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

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

# ResourceIdPreference
<a name="API_ResourceIdPreference"></a>

描述目前 AWS 帳戶中使用者 的資源類型及其 ID 偏好設定 AWS 區域。

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

 ** ResourceIdType **   <a name="efs-Type-ResourceIdPreference-ResourceIdType"></a>
識別 EFS 資源 ID 偏好設定，可以是 `LONG_ID` (17 個字元) 或 `SHORT_ID` (8 個字元) 類型的 ID。  
類型：字串  
有效值:`LONG_ID | SHORT_ID`   
必要：否

 ** Resources **   <a name="efs-Type-ResourceIdPreference-Resources"></a>
ID 偏好設定将套用於同时具有 `FILE_SYSTEM` 和 `MOUNT_TARGET` 標識符的 Amazon EFS 资源。  
類型：字串陣列  
有效值:`FILE_SYSTEM | MOUNT_TARGET`   
必要：否

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

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

# RootDirectory
<a name="API_RootDirectory"></a>

指定存取點提供存取權的 Amazon EFS 檔案系統上的目錄。存取點會將指定的檔案系統路徑作為檔案系統的根目錄，以公開給使用存取點的應用程式。使用存取點的 NFS 用戶端只能存取存取點 `RootDirectory`及其子目錄中的資料。

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

 ** CreationInfo **   <a name="efs-Type-RootDirectory-CreationInfo"></a>
(選用) 指定要套用至存取點的 `RootDirectory` 的 POSIX 識別碼和權限。如果 `RootDirectory` > `Path` 指定不存在，EFS 會在用戶端連線到存取點時使用 `CreationInfo` 設定建立根目錄。指定時 `CreationInfo`，您必須提供所有屬性的值。  
如果您未提供 `CreationInfo` 且指定的 `RootDirectory` > `Path` 不存在，則嘗試使用存取點掛載檔案系統將會失敗。
類型：[CreationInfo](API_CreationInfo.md) 物件  
必要：否

 ** Path **   <a name="efs-Type-RootDirectory-Path"></a>
指定 EFS 檔案系統上的路徑，要公開為 NFS 用戶端使用存取點存取 EFS 檔案系統的根目錄。一個路徑最多可以有四個子目錄。如果指定的路徑不存在，您必須提供 `CreationInfo`.  
類型：字串  
長度限制：長度下限為 1。長度上限為 100。  
模式：`^(\/|(\/(?!\.)+[^$#<>;`|&?{}^*/\n]+){1,4})$`  
必要：否

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

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

# Tag
<a name="API_Tag"></a>

標籤是索引鍵值組。系統允許的字元包括字母、空格和可以用 UTF-8 表示的數字，以及下列字元：` + - = . _ : /`。

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

 ** Key **   <a name="efs-Type-Tag-Key"></a>
標籤鍵 (字串)。索引鍵無法以 `aws:` 開頭。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`  
必要：是

 ** Value **   <a name="efs-Type-Tag-Value"></a>
標籤金鑰的值。  
類型：字串  
長度限制：長度上限為 256。  
模式：`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`  
必要：是

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

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