本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 動作 支援以下動作： + [CreateAccessPoint](API_CreateAccessPoint.md) + [CreateFileSystem](API_CreateFileSystem.md) + [CreateMountTarget](API_CreateMountTarget.md) + [CreateReplicationConfiguration](API_CreateReplicationConfiguration.md) + [CreateTags](API_CreateTags.md) + [DeleteAccessPoint](API_DeleteAccessPoint.md) + [DeleteFileSystem](API_DeleteFileSystem.md) + [DeleteFileSystemPolicy](API_DeleteFileSystemPolicy.md) + [DeleteMountTarget](API_DeleteMountTarget.md) + [DeleteReplicationConfiguration](API_DeleteReplicationConfiguration.md) + [DeleteTags](API_DeleteTags.md) + [DescribeAccessPoints](API_DescribeAccessPoints.md) + [DescribeAccountPreferences](API_DescribeAccountPreferences.md) + [DescribeBackupPolicy](API_DescribeBackupPolicy.md) + [DescribeFileSystemPolicy](API_DescribeFileSystemPolicy.md) + [DescribeFileSystems](API_DescribeFileSystems.md) + [DescribeLifecycleConfiguration](API_DescribeLifecycleConfiguration.md) + [DescribeMountTargets](API_DescribeMountTargets.md) + [DescribeMountTargetSecurityGroups](API_DescribeMountTargetSecurityGroups.md) + [DescribeReplicationConfigurations](API_DescribeReplicationConfigurations.md) + [DescribeTags](API_DescribeTags.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ModifyMountTargetSecurityGroups](API_ModifyMountTargetSecurityGroups.md) + [PutAccountPreferences](API_PutAccountPreferences.md) + [PutBackupPolicy](API_PutBackupPolicy.md) + [PutFileSystemPolicy](API_PutFileSystemPolicy.md) + [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateFileSystem](API_UpdateFileSystem.md) + [UpdateFileSystemProtection](API_UpdateFileSystemProtection.md) # CreateAccessPoint 建立 EFS 存取點。存取點是 EFS 檔案系統的應用程式特定檢視，會將作業系統使用者和群組，以及檔案系統路徑套用至透過存取點提出的任何檔案系統請求。該作業系統使用者和群組會覆寫 NFS 用戶端提供的任何身分資訊。檔案系統路徑會公開以作為存取點的根目錄。使用存取點的應用程式只能在其專屬目錄及子目錄中存取資料。除非您請求增加，否則檔案系統最多可以有 10，000 個存取點。若要進一步了解，請參閱[使用 EFS 存取點掛載檔案系統](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html)。 **注意** 如果在同一個檔案系統上傳送多個建立存取點的請求，且檔案系統接近存取點的限制，您可能會遇到這些請求的限流回應。這是為了確保檔案系統不會超過指定的存取點限制。 這項操作需要 `elasticfilesystem:CreateAccessPoint` 動作的許可。 將存取點標記在建立上。若標籤於建立動作中指定，IAM 會針對 `elasticfilesystem:TagResource` 動作執行其他授權，以確認使用者具備建立標籤的許可。因此，您必須授予使用 `elasticfilesystem:TagResource` 動作的明確許可。如需詳細資訊，請參閱[在建立期間授予標記資源的許可](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html)。 ## 請求語法 ``` POST /2015-02-01/access-points HTTP/1.1 Content-type: application/json { "ClientToken": "string", "FileSystemId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## URI 請求參數 請求不會使用任何 URI 參數。 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_CreateAccessPoint_RequestSyntax) ** Amazon EFS 用來確保等冪建立的字串 (最多 64 個 ASCII 字元)。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` 必要：是 ** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) ** 存取點提供存取的 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})$` 必要：是 ** [PosixUser](#API_CreateAccessPoint_RequestSyntax) ** 適用於所有檔案系統請求的操作系統使用者和群組，其中請求使用存取點提出。 類型：[PosixUser](API_PosixUser.md) 物件 必要：否 ** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) ** 存取點在 EFS 檔案系統上公開的目錄，即爲 NFS 用戶端透過該存取點存取 EFS 檔案系統的根目錄。使用存取點的用戶端只能存取根目錄及子目錄。如果 `RootDirectory` > `Path` 指定不存在，Amazon EFS 會在用戶端連線到存取點時建立目錄並應用 `CreationInfo` 設定。指定 `RootDirectory` 時，您必須提供 `Path` 和 `CreationInfo`。 只有在您提供目錄的 CreationInfo：OwnUid、OwnGID 和許可時，Amazon EFS 才會建立根目錄。如果您未提供此資訊，則 Amazon EFS 不會建立根目錄。如果根目錄不存在，嘗試使用存取點掛載將會失敗。 類型：[RootDirectory](API_RootDirectory.md) 物件 必要：否 ** [Tags](#API_CreateAccessPoint_RequestSyntax) ** 建立與存取點關聯的標籤。每一個標記都是金鑰對數值，每一個金鑰必須唯一。如需詳細資訊，請參閱《 * AWS 一般參考指南*》中的[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。 類型：[Tag](API_Tag.md) 物件陣列 必要：否 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "AccessPointArn": "string", "AccessPointId": "string", "ClientToken": "string", "FileSystemId": "string", "LifeCycleState": "string", "Name": "string", "OwnerId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) ** 與存取點關聯的唯一 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度上限為 128。 模式：`^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$` ** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) ** 由 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](#API_CreateAccessPoint_ResponseSyntax) ** 請求中指定的不透明字串，以確保等冪建立。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` ** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) ** 存取點套用至 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](#API_CreateAccessPoint_ResponseSyntax) ** 識別存取點的生命周期階段。 類型：字串 有效值:`creating | available | updating | deleting | deleted | error` ** [Name](#API_CreateAccessPoint_ResponseSyntax) ** 存取點的名稱。這是 `Name` 標籤的值。 類型：字串 ** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) ** 識別 AWS 帳戶 擁有存取點資源的 。 類型：字串 長度限制：長度上限為 14。 模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) ** 完整的 POSIX 身分識別，包括存取點上的使用者 ID、群組 ID 和次要群組 ID，這些 ID 適用於 NFS 用戶端使用存取點的所有檔案作業。 類型：[PosixUser](API_PosixUser.md) 物件 ** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) ** 存取點在 EFS 檔案系統上公開的目錄，即爲 NFS 用戶端透過該存取點存取 EFS 檔案系統的根目錄。 類型：[RootDirectory](API_RootDirectory.md) 物件 ** [Tags](#API_CreateAccessPoint_ResponseSyntax) ** 與存取點相關聯的標籤，顯示為「標籤」物件的陣列。 類型：[Tag](API_Tag.md) 物件陣列 ## 錯誤 ** AccessPointAlreadyExists ** 如果您嘗試創建的存取點已經存在，並使用您在請求中提供的創建權杖，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** AccessPointLimitExceeded ** 如果 AWS 帳戶 已建立每個檔案系統允許的存取點數量上限，則傳回。如需詳細資訊，請參閱 [https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region)。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：403 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ThrottlingException ** 當 `CreateAccessPoint` API 動作呼叫太快且檔案系統上的存取點數目接近 [120 的限制](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region)，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：429 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint) # CreateFileSystem 建立新且空白的文件系統。操作需要從請求中取得建立字符，讓 Amazon EFS 用來確保等冪建立 (使用相同建立字符呼叫操作不會有任何效果)。如果目前不存在具有 AWS 帳戶 指定建立字符的發起人擁有的檔案系統，此操作會執行下列動作： + 建立新且空白的文件系統。檔案系統將會擁有 Amazon EFS 指派的 ID，並且其初期的生命週期狀態將會是 `creating`。 + 傳回所建立檔案系統的描述。 否則，此操作會傳回 `FileSystemAlreadyExists` 錯誤，其中包含現有檔案系統的 ID。 **注意** 針對基本使用案例，您可以針對建立字符使用隨機產生的 UUID。 等冪操作可讓您重試 `CreateFileSystem` 呼叫，而無須承擔建立額外檔案系統的風險。在初始呼叫失敗，導致不確定檔案系統實際上是否已建立時，便可能會發生此狀況。其中一個範例便是發生傳輸層逾時，或是您的連線重設時。只要您使用相同的建立字符，若初始呼叫成功建立檔案系統，用戶端便會從 `FileSystemAlreadyExists` 錯誤中得知該檔案系統已存在。 如需詳細資訊，請參閱《Amazon EFS 使用者指南》**中的[建立檔案系統](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1)。 **注意** `CreateFileSystem` 呼叫會在檔案系統的生命週期狀態仍處於 `creating` 時傳回。您可以透過呼叫 [DescribeFileSystems](API_DescribeFileSystems.md) 操作來檢查檔案系統的建立狀態，該操作與其他項目會一起傳回檔案系統狀態。 此操作會接受一個為檔案系統選擇的選用 `PerformanceMode` 參數。我們建議所有檔案系統`generalPurpose``PerformanceMode`使用 。`maxIO` 模式是上一代效能類型，專為可容忍高於 `generalPurpose` 模式延遲的高度平行工作負載而設計。使用彈性輸送量的單區域檔案系統或檔案系統不支援 `MaxIO` 模式。 檔案系統建立後就`PerformanceMode`無法變更 。如需詳細資訊，請參閱 [Amazon EFS 效能模式](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html)。 您可以使用 `ThroughputMode` 參數設定檔案系統的輸送量模式。 在檔案系統完全建立後，Amazon EFS 會將其生命週期狀態設為 `available`，此時您可以為 VPC 中的檔案系統建立一或多個掛載目標。如需詳細資訊，請參閱[CreateMountTarget](API_CreateMountTarget.md)。您可以使用掛載目標，在您 VPC 中的 EC2 執行個體上掛載您的 Amazon EFS 檔案系統。如需詳細資訊，請參閱 [Amazon EFS：運作方式](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html)。 這項操作需要 `elasticfilesystem:CreateFileSystem` 動作的許可。 檔案系統可在建立時加上標籤。若標籤於建立動作中指定，IAM 會針對 `elasticfilesystem:TagResource` 動作執行其他授權，以確認使用者具備建立標籤的許可。因此，您必須授予使用 `elasticfilesystem:TagResource` 動作的明確許可。如需詳細資訊，請參閱[在建立期間授予標記資源的許可](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html)。 ## 請求語法 ``` POST /2015-02-01/file-systems HTTP/1.1 Content-type: application/json { "AvailabilityZoneName": "string", "Backup": boolean, "CreationToken": "string", "Encrypted": boolean, "KmsKeyId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "Tags": [ { "Key": "string", "Value": "string" } ], "ThroughputMode": "string" } ``` ## URI 請求參數 請求不會使用任何 URI 參數。 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) ** 對於單區域檔案系統，指定 AWS 要在其中建立檔案系統的可用區域。使用格式 `us-east-1a` 來指定可用區域。如需單區域檔案系統的詳細資訊，請參閱《Amazon [EFS 使用者指南》中的 EFS 檔案系統類型](https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type)。 * EFS * 使用 Amazon EFS AWS 區域 的所有可用區域都無法使用單區域檔案系統。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` 必要：否 ** [Backup](#API_CreateFileSystem_RequestSyntax) ** 指定是否在您正在建立的檔案系統上啟用自動備份。將值設定為 `true` 以啟用自動備份。如果您要建立單區域檔案系統，預設會啟用自動備份。如需詳細資訊，請參閱《Amazon EFS 使用者指南》**中的[啟用自動備份](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups)。 預設值為 `false`。但是，如果您指定 `AvailabilityZoneName`，預設值為 `true`。 AWS Backup 不適用於 Amazon EFS 提供的所有 AWS 區域 。 類型：布林值 必要：否 ** [CreationToken](#API_CreateFileSystem_RequestSyntax) ** 字串最多為 64 個 ASCII 字元。Amazon EFS 使用這項功能來確保等冪建立。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` 必要：是 ** [Encrypted](#API_CreateFileSystem_RequestSyntax) ** 布林值，若為 True 便會建立加密檔案系統。建立加密的檔案系統時，您可以選擇指定現有的 AWS Key Management Service 金鑰 (KMS 金鑰）。若您沒有指定 KMS 金鑰，則會使用 Amazon EFS 的預設 KMS 金鑰 `/aws/elasticfilesystem` 來保護加密檔案系統。 類型：布林值 必要：否 ** [KmsKeyId](#API_CreateFileSystem_RequestSyntax) ** 您要使用 KMS 金鑰 ID 來保護加密檔案系統。此參數只有在您希望使用非預設 KMS 金鑰時才是必要參數。若沒有指定此參數，則會使用 Amazon EFS 的預設 KMS 金鑰。您可以使用以下格式指定此 KMS 金鑰 ID。 + 金鑰 ID - 金鑰的唯一識別碼，例如 `1234abcd-12ab-34cd-56ef-1234567890ab`。 + ARN - 金鑰的 Amazon Resource Name (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`。 如果您使用 `KmsKeyId`，則必須將 [CreateFileSystem:Encrypted](#efs-CreateFileSystem-request-Encrypted) 參數設定為是。 EFS 只接受對稱 KMS 金鑰。Amazon EFS 檔案系統不能使用非對稱 KMS 金鑰。 類型：字串 長度限制：長度上限為 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/_-]+))))$` 必要：否 ** [PerformanceMode](#API_CreateFileSystem_RequestSyntax) ** 檔案系統的效能模式。我們建議針對所有的檔案系統使用 `generalPurpose` 效能模式。使用 `maxIO` 效能模式的檔案系統可擴展到更高層級的彙整輸送量及每秒操作數，其代價是針對大多數的檔案操作，會有稍高的延遲。效能模式在檔案系統建立之後便無法變更。單區域檔案系統不支援 `maxIO` 模式。 由於最大 I/O 的每個操作延遲較高，我們建議所有檔案系統使用「一般用途」效能模式。 預設值為 `generalPurpose`。 類型：字串 有效值:`generalPurpose | maxIO` 必要：否 ** [ProvisionedThroughputInMibps](#API_CreateFileSystem_RequestSyntax) ** 您要為所建立檔案系統佈建的輸送量 (以 MiB/s 為單位)。若將 `ThroughputMode` 設為 `provisioned`，則為必要項目。有效值為 1 - 3414 MiBps，上限視「地區」而定。若要提高此限制，請聯絡 支援。如需詳細資訊，請參閱《Amazon EFS 使用者指南》中的[您可以增加的 Amazon EFS 配額](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)。 類型：Double 有效範圍：最小值為 1.0。 必要：否 ** [Tags](#API_CreateFileSystem_RequestSyntax) ** 用於建立一或多個與檔案系統相關聯的標籤。每個標籤都是使用者定義的鍵/值對。透過包含 `"Key":"Name","Value":"{value}"` 鍵/值對來在建立時為您的檔案系統命名。每個鍵都必須是唯一的。如需詳細資訊，請參閱《 * AWS 一般參考指南*》中的[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。 類型：[Tag](API_Tag.md) 物件陣列 必要：否 ** [ThroughputMode](#API_CreateFileSystem_RequestSyntax) ** 指定檔案系統的輸送量模式。模式可以是 `bursting`、`provisioned` 或 `elastic`。若您將 `ThroughputMode` 設為 `provisioned`，您也必須為 `ProvisionedThroughputInMibps` 設定值。建立檔案系統後，在有限時間内，您可以減少佈建輸送量或變更輸送量模式。如需詳細資訊，請參閱《Amazon EFS 使用者指南》中的[使用佈建模式指定輸送量](https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput)。 預設值為 `bursting`。 類型：字串 有效值:`bursting | provisioned | elastic` 必要：否 ## 回應語法 ``` HTTP/1.1 201 Content-type: application/json { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "CreationTime": number, "CreationToken": "string", "Encrypted": boolean, "FileSystemArn": "string", "FileSystemId": "string", "FileSystemProtection": { "ReplicationOverwriteProtection": "string" }, "KmsKeyId": "string", "LifeCycleState": "string", "Name": "string", "NumberOfMountTargets": number, "OwnerId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "SizeInBytes": { "Timestamp": number, "Value": number, "ValueInArchive": number, "ValueInIA": number, "ValueInStandard": number }, "Tags": [ { "Key": "string", "Value": "string" } ], "ThroughputMode": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 201 回應。 服務會傳回下列 JSON 格式的資料。 ** [AvailabilityZoneId](#API_CreateFileSystem_ResponseSyntax) ** 檔案系統所在可用區域的唯一且一致的識別碼僅對單區域有效。例如， `use1-az1` 是 us-east-1 的可用區域 ID AWS 區域，且每個 都有相同的位置 AWS 帳戶。 類型：字串 ** [AvailabilityZoneName](#API_CreateFileSystem_ResponseSyntax) ** 描述檔案系統所在的 AWS 可用區域，且僅適用於單區域檔案系統。如需詳細資訊，請參閱《Amazon EFS 使用者指南》**中的[使用 EFS 儲存類別](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html)。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` ** [CreationTime](#API_CreateFileSystem_ResponseSyntax) ** 建立檔案系統的時間，以秒為單位 (自 1970-01-01T00:00:00Z 以來)。 類型：Timestamp ** [CreationToken](#API_CreateFileSystem_ResponseSyntax) ** 請求中指定的不透明字串。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` ** [Encrypted](#API_CreateFileSystem_ResponseSyntax) ** 布林值，若為 true，指出加密檔案系統。 類型：布林值 ** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) ** 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` 類型：字串 ** [FileSystemId](#API_CreateFileSystem_ResponseSyntax) ** 由 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})$` ** [FileSystemProtection](#API_CreateFileSystem_ResponseSyntax) ** 說明檔案系統的防護。 類型：[FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) 物件 ** [KmsKeyId](#API_CreateFileSystem_ResponseSyntax) ** 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/_-]+))))$` ** [LifeCycleState](#API_CreateFileSystem_ResponseSyntax) ** 檔案系統的生命周期階段。 類型：字串 有效值:`creating | available | updating | deleting | deleted | error` ** [Name](#API_CreateFileSystem_ResponseSyntax) ** 您可以將標籤 (包括 `Name` 標籤) 新增至檔案系統。如需詳細資訊，請參閱[CreateFileSystem](#API_CreateFileSystem)。如果檔案系統有 `Name` 標籤，Amazon EFS 會傳回此欄位中的值。 類型：字串 長度限制：長度上限為 256。 模式：`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` ** [NumberOfMountTargets](#API_CreateFileSystem_ResponseSyntax) ** 檔案系統目前擁有的掛載目標數。如需詳細資訊，請參閱[CreateMountTarget](API_CreateMountTarget.md)。 類型：整數 有效範圍：最小值為 0。 ** [OwnerId](#API_CreateFileSystem_ResponseSyntax) ** AWS 帳戶 建立檔案系統的 。 類型：字串 長度限制：長度上限為 14。 模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [PerformanceMode](#API_CreateFileSystem_ResponseSyntax) ** 檔案系統的效能模式。 類型：字串 有效值:`generalPurpose | maxIO` ** [ProvisionedThroughputInMibps](#API_CreateFileSystem_ResponseSyntax) ** 檔案系統的佈建輸送量總量 (以 MiBps 為單位)。對使用 `ThroughputMode` 設定為 `provisioned` 的檔案系統有效。 類型：Double 有效範圍：最小值為 1.0。 ** [SizeInBytes](#API_CreateFileSystem_ResponseSyntax) ** 儲存在檔案系統、`Value` 欄位中的資料最新已知計量大小 (以位元組為單位)，以及在 `Timestamp` 欄位中決定該大小的時間。`Timestamp` 值是自 1970-01-01T00:00:00Z 以來的整數秒數。`SizeInBytes` 值不代表檔案系統的一致快照集大小，但是在沒有寫入檔案系統時，它最終會保持一致。也就是說，只有超過幾個小時未修改檔案系統，`SizeInBytes` 才能表示實際大小。否則，該值并不能代表檔案系統在任何時間點的確切大小。 類型：[FileSystemSize](API_FileSystemSize.md) 物件 ** [Tags](#API_CreateFileSystem_ResponseSyntax) ** 與檔案系統相關聯的標籤以 `Tag` 物件陣列形式呈現出來。 類型：[Tag](API_Tag.md) 物件陣列 ** [ThroughputMode](#API_CreateFileSystem_ResponseSyntax) ** 顯示檔案系統的輸送量模式。如需詳細資訊，請參閱《Amazon EFS 使用者指南》**中的[輸送量模式](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes)。 類型：字串 有效值:`bursting | provisioned | elastic` ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemAlreadyExists ** 如果您嘗試建立的檔案系統已經存在，並使用了您提供的建立權杖，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** FileSystemLimitExceeded ** 如果 AWS 帳戶 已建立每個帳戶允許的檔案系統數目上限，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：403 ** InsufficientThroughputCapacity ** 如果沒有足夠容量佈建其他輸送量，則傳回。當您嘗試以佈建輸送量模式建立檔案系統、嘗試增加現有檔案系統的佈建輸送量，或嘗試將現有檔案系統從「爆增輸送量」變更為「佈建輸送量」模式時，系統可能會傳回此值。請稍後再試。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：503 ** InternalServerError ** 如果在伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ThroughputLimitExceeded ** 如果因為已達到 1024 MB 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** UnsupportedAvailabilityZone ** 如果請求的 Amazon EFS 功能在指定的可用區域中不可用，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ## 範例 ### 建立加密檔案系統 下列範例會傳送 POST 要求，以在啟用自動備份的 `us-west-2` 區域中建立檔案系統。該請求指定 `myFileSystem1` 為等冪性的建立權杖。 #### 請求範例 ``` POST /2015-02-01/file-systems HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T215117Z Authorization: <...> Content-Type: application/json Content-Length: 42 { "CreationToken" : "myFileSystem1", "PerformanceMode" : "generalPurpose", "Backup": true, "Encrypted": true, "Tags":[ { "Key": "Name", "Value": "Test Group1" } ] } ``` #### 回應範例 ``` HTTP/1.1 201 Created x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 319 { "ownerId":"251839141158", "CreationToken":"myFileSystem1", "Encrypted": true, "PerformanceMode" : "generalPurpose", "fileSystemId":"fs-01234567", "CreationTime":"1403301078", "LifeCycleState":"creating", "numberOfMountTargets":0, "SizeInBytes":{ "Timestamp": 1403301078, "Value": 29313618372, "ValueInArchive": 201156, "ValueInIA": 675432, "ValueInStandard": 29312741784 }, "Tags":[ { "Key": "Name", "Value": "Test Group1" } ], "ThroughputMode": "elastic" } ``` ### 建立單區域可用的加密 EFS 檔案系統 下列範例會傳送 POST 要求，以在啟用自動備份的 `us-west-2` 區域中建立檔案系統。檔案系統在 `us-west-2b`可用區域中有單區域儲存。 #### 請求範例 ``` POST /2015-02-01/file-systems HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T215117Z Authorization: <...> Content-Type: application/json Content-Length: 42 { "CreationToken" : "myFileSystem2", "PerformanceMode" : "generalPurpose", "Backup": true, "AvailabilityZoneName": "us-west-2b", "Encrypted": true, "ThroughputMode": "elastic", "Tags":[ { "Key": "Name", "Value": "Test Group1" } ] } ``` #### 回應範例 ``` HTTP/1.1 201 Created x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 319 { "ownerId":"251839141158", "CreationToken":"myFileSystem1", "Encrypted": true, "AvailabilityZoneId": "usew2-az2", "AvailabilityZoneName": "us-west-2b", "PerformanceMode" : "generalPurpose", "fileSystemId":"fs-01234567", "CreationTime":"1403301078", "LifeCycleState":"creating", "numberOfMountTargets":0, "SizeInBytes":{ "Timestamp": 1403301078, "Value": 29313618372, "ValueInArchive": 201156, "ValueInIA": 675432, "ValueInStandard": 29312741784 }, "Tags":[ { "Key": "Name", "Value": "Test Group1" } ], "ThroughputMode": "elastic" } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateFileSystem) # CreateMountTarget 建立文件系統的掛載目標。您接著可以使用掛載目標，在 EC2 執行個體上掛載檔案系統。如需掛載目標的詳細資訊，請參閱[管理掛載目標](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)。 若要建立 EFS 檔案系統的掛載目標，檔案系統的生命週期狀態必須為 `available`。如需詳細資訊，請參閱[DescribeFileSystems](API_DescribeFileSystems.md)。 建立掛載目標後，Amazon EFS 會傳回包含 `MountTargetId`和 IP 地址 (`IpAddress` 或 ) 的回應`Ipv6Address`。您會在 EC2 執行個體中掛載檔案系統時使用此 IP 地址。您也會在掛載檔案系統時使用掛載目標的 DNS 名稱。您使用掛載目標於其上掛載檔案系統的 EC2 執行個體，可將掛載目標的 DNS 名稱解析為其 IP 地址。如需詳細資訊，請參閱 [Amazon EFS 的運作方式](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html)。 請注意，您只能在一個 VPC 內為檔案系統建立掛載目標，並且每個可用區域中只能有一個掛載目標。如需詳細資訊，請參閱[建立掛載目標](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-access-create-delete-mount-targets.html)。 若請求滿足需求，Amazon EFS 會執行下列作業： + 在指定子網路中建立新的掛載目標。 + 使用以下內容在子網路中建立新的網路介面： + `Mount target fsmt-id for file system fs-id ` 其中 ` fsmt-id `是掛載目標 ID 的描述，而 ` fs-id `是 `FileSystemId`。 + 網路界面的 `requesterManaged` 屬性設定為 `true`，而`requesterId`值設定為 `EFS`。 每個掛載目標都有一個對應的申請者受管 EC2 網路界面。建立網路介面後，Amazon EFS 會將掛載目標描述中的 `NetworkInterfaceId` 欄位設定為網路介面 ID，並將 IP 地址設定為其地址。若網路介面建立失敗，整個 `CreateMountTarget` 操作都會失敗。 **注意** `CreateMountTarget` 呼叫只會在建立網路介面後傳回，但當掛載目標狀態仍為 `creating` 時，您可以透過呼叫操作檢查掛載目標的建立狀態，[DescribeMountTargets](API_DescribeMountTargets.md) 操作和其他項目會一起傳回掛載目標的狀態。 此操作需要在檔案系統上具備以下動作的許可： + `elasticfilesystem:CreateMountTarget` 此操作也需要以下 Amazon EC2 動作的許可： + `ec2:DescribeSubnets` + `ec2:DescribeNetworkInterfaces` + `ec2:CreateNetworkInterface` ## 請求語法 ``` POST /2015-02-01/mount-targets HTTP/1.1 Content-type: application/json { "FileSystemId": "string", "IpAddress": "string", "IpAddressType": "string", "Ipv6Address": "string", "SecurityGroups": [ "string" ], "SubnetId": "string" } ``` ## URI 請求參數 請求不會使用任何 URI 參數。 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [FileSystemId](#API_CreateMountTarget_RequestSyntax) ** 要建立掛載目標的檔案系統 ID。 類型：字串 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ** [IpAddress](#API_CreateMountTarget_RequestSyntax) ** 如果掛載目標`IpAddressType`的 是 IPv4 ( `IPV4_ONLY`或 `DUAL_STACK`)，則指定要使用的 IPv4 地址。如果您未指定 `IpAddress`，Amazon EFS 會從為 指定的子網路中選取未使用的 IP 地址`SubnetId`。 類型：字串 長度限制：長度下限為 7。長度上限為 15。 模式：`^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$` 必要：否 ** [IpAddressType](#API_CreateMountTarget_RequestSyntax) ** 掛載目標的 IP 地址類型。可能的值為 `IPV4_ONLY`（僅限 IPv4 地址）、 `IPV6_ONLY` （僅限 IPv6 地址） 和 `DUAL_STACK`(IPv4 和 IPv6 地址的雙堆疊）。如果您未指定 `IpAddressType`，`IPV4_ONLY`則會使用 。 `IPAddressType` 必須符合子網路的 IP 類型。此外， `IPAddressType` 參數會覆寫設定為 VPC 中子網路預設 IP 地址的值。例如，如果 `IPAddressType` 是 `IPV4_ONLY`且 `AssignIpv6AddressOnCreation`是 `true`，則掛載目標會使用 IPv4。如需詳細資訊，請參閱[修改子網路的公有 IP 定址屬性](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html)。 類型：字串 有效值:`IPV4_ONLY | IPV6_ONLY | DUAL_STACK` 必要：否 ** [Ipv6Address](#API_CreateMountTarget_RequestSyntax) ** 如果掛載目標`IPAddressType`的 是 IPv6 (`IPV6_ONLY` 或 `DUAL_STACK`)，則指定要使用的 IPv6 地址。如果您未指定 `Ipv6Address`，則 Amazon EFS 會從為 指定的子網路中選取未使用的 IP 地址`SubnetId`。 類型：字串 長度限制：長度下限為 3。長度上限為 39。 必要：否 ** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) ** VPC 安全群組 IDs，格式為 `sg-xxxxxxxx`。這些必須適用於與指定的子網路相同的 VPC。安全群組的數量上限取決於帳戶配額。如需詳細資訊，請參閱《[Amazon VPC 使用者指南》中的 Amazon VPC Quotas](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) （請參閱**安全群組**資料表）。 **如果您未指定安全群組，則 Amazon EFS 會使用子網路 VPC 的預設安全群組。 類型：字串陣列 陣列成員：最多 100 個項目。 長度限制：長度下限為 11。長度上限為 43。 模式：`^sg-[0-9a-f]{8,40}` 必要：否 ** [SubnetId](#API_CreateMountTarget_RequestSyntax) ** 要在其中新增掛載目標的子網路 ID。對於單區域檔案系統，請使用與檔案系統的可用區域相關聯的子網路。子網路類型必須與 的類型相同`IpAddressType`。 類型：字串 長度限制：長度下限為 15。長度上限為 47。 模式：`^subnet-[0-9a-f]{8,40}$` 必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "FileSystemId": "string", "IpAddress": "string", "Ipv6Address": "string", "LifeCycleState": "string", "MountTargetId": "string", "NetworkInterfaceId": "string", "OwnerId": "string", "SubnetId": "string", "VpcId": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [AvailabilityZoneId](#API_CreateMountTarget_ResponseSyntax) ** 掛載目標所在可用區域的唯一且一致的識別碼。例如， `use1-az1` 是 us-east-1 區域的 AZ ID，每個區域都有相同的位置 AWS 帳戶。 類型：字串 ** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) ** 掛載目標所在可用區域名稱。可用區域會獨立對應至每個可用區域的名稱 AWS 帳戶。例如， `us-east-1a`的可用區域 AWS 帳戶 可能與其他 的可用區域不同`us-east-1a` AWS 帳戶。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` ** [FileSystemId](#API_CreateMountTarget_ResponseSyntax) ** 指定掛載目標所屬的檔案系統 ID。 類型：字串 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [IpAddress](#API_CreateMountTarget_ResponseSyntax) ** 掛載目標的 IPv4 地址。 類型：字串 長度限制：長度下限為 7。長度上限為 15。 模式：`^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$` ** [Ipv6Address](#API_CreateMountTarget_ResponseSyntax) ** 掛載目標的 IPv6 地址。 類型：字串 長度限制：長度下限為 3。長度上限為 39。 ** [LifeCycleState](#API_CreateMountTarget_ResponseSyntax) ** 掛載目標的生命週期狀態。 類型：字串 有效值:`creating | available | updating | deleting | deleted | error` ** [MountTargetId](#API_CreateMountTarget_ResponseSyntax) ** 系統指定的掛載目標 ID。 類型：字串 長度限制：長度下限為 13。長度上限為 45。 模式：`^fsmt-[0-9a-f]{8,40}$` ** [NetworkInterfaceId](#API_CreateMountTarget_ResponseSyntax) ** Amazon EFS 建立掛載目標時建立的網路介面 ID。 類型：字串 ** [OwnerId](#API_CreateMountTarget_ResponseSyntax) ** AWS 帳戶 擁有資源的 ID。 類型：字串 長度限制：長度上限為 14。 模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [SubnetId](#API_CreateMountTarget_ResponseSyntax) ** 掛載目標子網路的 ID。 類型：字串 長度限制：長度下限為 15。長度上限為 47。 模式：`^subnet-[0-9a-f]{8,40}$` ** [VpcId](#API_CreateMountTarget_ResponseSyntax) ** 掛載目標所在的虛擬私有雲端 (VPC)。 類型：字串 ## 錯誤 ** AvailabilityZonesMismatch ** 如果為掛載目標指定的可用區域與檔案系統的可用區域不同，則傳回。如需詳細資訊，請參閱[區域和單區域儲存冗餘](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs)。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** IpAddressInUse ** 如果請求指定已在子網路中使用的 IP 地址 (`IpAddress` 或 `Ipv6Address`)，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** MountTargetConflict ** 如果掛載目標違反以檔案系統現有的掛載目標為基礎的其中一個指定限制，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** NetworkInterfaceLimitExceeded ** 呼叫帳戶已達到指定 AWS 區域區域彈性網絡介面的限制。刪除某些網路介面，或請求提高帳戶配額。如需詳細資訊，請參閱《Amazon VPC 使用者指南》**中的 [Amazon VPC 配額](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) (請參閱**網路介面**資料表中的**每個區域的網路介面**項目)。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** NoFreeAddressesInSubnet ** 未傳回請求中`Ipv6Address`提供的 `IpAddress`或 ，且指定的子網路中沒有可用的 IP 地址。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** SecurityGroupLimitExceeded ** 如果請求中`SecurityGroups`指定的 數目大於限制，則根據帳戶配額傳回。請刪除一些安全群組或請求提高帳戶配額。如需詳細資訊，請參閱《[Amazon VPC 使用者指南》中的 Amazon VPC Quotas](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) （請參閱**安全群組**資料表）。 ** ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** SecurityGroupNotFound ** 如果子網路的虛擬私有雲端 (VPC) 中沒有其中一個指定的安全群組，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** SubnetNotFound ** 如果在請求中沒有提供 ID `SubnetId` 的子網路，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** UnsupportedAvailabilityZone ** 如果請求的 Amazon EFS 功能在指定的可用區域中不可用，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ## 範例 ### 在子網路上的可用 IPv4 地址建立掛載目標 下列請求只會指定掛載目標的檔案系統和子網路。目標是在指定子網路上的可用 IPv4 地址建立，預設安全群組與 VPC 相關聯。 #### 請求範例 ``` POST /2015-02-01/mount-targets HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T221118Z Authorization: <...> Content-Type: application/json Content-Length: 160 {"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"} ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 252 { "OwnerId": "231243201240", "MountTargetId": "fsmt-55a4413c", "FileSystemId": "fs-01234567", "SubnetId": "subnet-01234567", "LifeCycleState": "available", "IpAddress": "172.31.22.183" "NetworkInterfaceId":"eni-1bcb7772" "AvailabilityZoneId": "eus1-az2", "AvailabilityZoneName": "eu-south-1b", "VpcId": "vpc-08d45b31fa009a15e" } ``` ### 在特定 IPv4 地址建立掛載目標 下列請求指定要用於掛載目標的檔案系統、子網路、安全群組和 IPv4 地址。 #### 請求範例 ``` POST /2015-02-01/mount-targets HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T221118Z Authorization: <...> Content-Type: application/json Content-Length: 160 { "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "IpAddress":"10.0.2.42", "SecurityGroups":[ "sg-01234567" ] } ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 252 { "OwnerId":"251839141158", "MountTargetId":"fsmt-9a13661e", "FileSystemId":"fs-01234567", "SubnetId":"subnet-fd04ff94", "LifeCycleState":"available", "IpAddress":"10.0.2.42", "NetworkInterfaceId":"eni-1bcb7772" "AvailabilityZoneId": "eus1-az2", "AvailabilityZoneName": "eu-south-1b", "VpcId": "vpc-08d45b31fa009a15e" } ``` ### 在特定 IPv6 地址建立掛載目標 下列請求指定要用於掛載目標的檔案系統、子網路、安全群組和 IPv6 地址。 #### 請求範例 ``` POST /2015-02-01/mount-targets HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T221118Z Authorization: <...> Content-Type: application/json Content-Length: 160 { "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334", "IpAddressType": "IPV6_ONLY", "SecurityGroups":[ "sg-01234567" ] } ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 252 { "OwnerId":"251839141158", "MountTargetId":"fsmt-9a13661e", "FileSystemId":"fs-01234567", "SubnetId":"subnet-fd04ff94", "LifeCycleState":"available", "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334", "NetworkInterfaceId":"eni-1bcb7772" "AvailabilityZoneId": "eus1-az2", "AvailabilityZoneName": "eu-south-1b", "VpcId": "vpc-08d45b31fa009a15e" } ``` ### 在雙堆疊子網路上的可用 IPv4 地址建立掛載目標 下列請求指定掛載目標的檔案系統、子網路和地址類型。目標是在指定的雙堆疊子網路上的可用 IPv4 地址建立，其預設安全群組與 VPC 相關聯。 #### 請求範例 ``` POST /2015-02-01/mount-targets HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T221118Z Authorization: <...> Content-Type: application/json Content-Length: 160 {"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"} ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 252 { "OwnerId": "251839141158", "MountTargetId": "fsmt-55a4413c", "FileSystemId": "fs-01234567", "SubnetId":"subnet-fd04ff94", "LifeCycleState": "available", "IpAddress": "172.31.22.183" "Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238", "NetworkInterfaceId": "eni-01234567", "AvailabilityZoneId": "eus1-az2", "AvailabilityZoneName": "eu-south-1b", "VpcId": "vpc-08d45b31fa009a15e" } ``` ### 在雙堆疊子網路上的特定 Ipv4 和 IPv6 地址建立掛載目標 下列請求指定掛載目標的檔案系統、子網路、安全群組、IPv4 地址、IPv6 地址。目標是在雙堆疊子網路上指定的 IPv4 和 IPv6 地址建立。 #### 請求範例 ``` POST /2015-02-01/mount-targets HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T221118Z Authorization: <...> Content-Type: application/json Content-Length: 160 { "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "IpAddressType": "DUAL_STACK", "IpAddress": "10.0.1.25", "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334", "SecurityGroups":[ "sg-01234567" ] } ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 252 { "OwnerId": "231243201240", "MountTargetId": "fsmt-55a4413c", "FileSystemId": "fs-01234567", "SubnetId": "subnet-01234567", "LifeCycleState": "available", "IpAddress": "10.0.1.25", "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334", "NetworkInterfaceId": "eni-01234567", "AvailabilityZoneId": "eus1-az2", "AvailabilityZoneName": "eu-south-1b", "VpcId": "vpc-08d45b31fa009a15e" } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateMountTarget) # CreateReplicationConfiguration 建立複寫組態至新的或現有的 EFS 檔案系統。如需詳細資訊，請參閱《Amazon EFS 使用者指南》**中的 [Amazon EFS 複寫](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html)。複寫組態指定以下内容： + **來源檔案系統** – 您要複寫的 EFS 檔案系統。 + **目的地檔案系統** – 來源檔案系統複寫的目標檔案系統。在複寫組態中只能作爲目的地檔案系統。 **注意** 檔案系統只是複寫組態的一部分。 複寫組態的目的地參數取決於您是複寫到新的檔案系統還是現有的檔案系統，以及是否複寫 AWS 帳戶。如需詳細資訊，請參閱[DestinationToCreate](API_DestinationToCreate.md)。 這項操作需要 `elasticfilesystem:CreateReplicationConfiguration` 動作的許可。此外，根據您複寫檔案系統的方式，還需要其他許可。如需詳細資訊，請參閱《*Amazon EFS 使用者指南*》中的[複寫的必要許可](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions)。 ## 請求語法 ``` POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1 Content-type: application/json { "Destinations": [ { "AvailabilityZoneName": "string", "FileSystemId": "string", "KmsKeyId": "string", "Region": "string", "RoleArn": "string" } ] } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) ** 指定您要複寫的 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})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) ** 目的地組態物件陣列。僅支援一個目的地組態物件。 類型：[DestinationToCreate](API_DestinationToCreate.md) 物件陣列 必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "Destinations": [ { "FileSystemId": "string", "LastReplicatedTimestamp": number, "OwnerId": "string", "Region": "string", "RoleArn": "string", "Status": "string", "StatusMessage": "string" } ], "OriginalSourceFileSystemArn": "string", "SourceFileSystemArn": "string", "SourceFileSystemId": "string", "SourceFileSystemOwnerId": "string", "SourceFileSystemRegion": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_CreateReplicationConfiguration_ResponseSyntax) ** 說明建立複寫組態的時間。 類型：Timestamp ** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) ** 目的地物件陣列。僅支援一個目的地物件。 類型：[Destination](API_Destination.md) 物件陣列 ** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) ** 複寫組態中原始來源 EFS 檔案系統的 Amazon Resource Name (ARN)。 類型：字串 ** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) ** 複寫組態中當前來源檔案系統的 Amazon Resource Name (ARN)。 類型：字串 ** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) ** 要複寫的來源 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})$` ** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) ** 來源檔案系統所在的 AWS 帳戶 的 ID。 類型：字串 長度限制：長度上限為 14。 模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) ** AWS 區域 來源 EFS 檔案系統所在的 。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$` ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** ConflictException ** 如果複寫中的來源檔案系統已加密，但目的地檔案系統未加密，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** FileSystemLimitExceeded ** 如果 AWS 帳戶 已建立每個帳戶允許的檔案系統數目上限，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：403 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InsufficientThroughputCapacity ** 如果沒有足夠容量佈建其他輸送量，則傳回。當您嘗試以佈建輸送量模式建立檔案系統、嘗試增加現有檔案系統的佈建輸送量，或嘗試將現有檔案系統從「爆增輸送量」變更為「佈建輸送量」模式時，系統可能會傳回此值。請稍後再試。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：503 ** InternalServerError ** 如果在伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ReplicationNotFound ** 如果指定的檔案系統沒有複寫組態，則傳回。 ** ErrorCode ** ReplicationNotFound ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** ThroughputLimitExceeded ** 如果因為已達到 1024 MiB/s 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** UnsupportedAvailabilityZone ** 如果請求的 Amazon EFS 功能在指定的可用區域中不可用，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** ValidationException ** 如果在提出請求 AWS 區域 的 中無法使用 AWS Backup 服務，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) # CreateTags **注意** 棄用：`CreateTags` 已棄用且未維護。若要從 EFS 資源建立標籤，請使用 [TagResource](API_TagResource.md) API 動作。 建立或覆寫與檔案系統相關聯的標籤。每個標籤都是金鑰值對。如果要求中指定的標籤鍵已存在於檔案系統上，此操作會以要求中提供的值覆寫其值。如果您將 `Name` 標籤新增至檔案系統，Amazon EFS 會在 [DescribeFileSystems](API_DescribeFileSystems.md) 回應操作時傳回該標籤。 這項操作需要 `elasticfilesystem:CreateTags` 動作的許可。 ## 請求語法 ``` POST /2015-02-01/create-tags/FileSystemId HTTP/1.1 Content-type: application/json { "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_CreateTags_RequestSyntax) ** 您要修改其標籤的 ID (字串)。此操作只會修改標籤，而不會修改檔案系統。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [Tags](#API_CreateTags_RequestSyntax) ** 新增的 `Tag` 物件陣列。每個 `Tag` 物件都是一個鍵值對。 類型：[Tag](API_Tag.md) 物件陣列 必要：是 ## 回應語法 ``` HTTP/1.1 204 ``` ## 回應元素 如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateTags) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateTags) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateTags) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateTags) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateTags) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateTags) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateTags) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateTags) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateTags) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateTags) # DeleteAccessPoint 刪除指定的存取點。刪除完成後，新用戶端將無法再連線至存取點。刪除時連線至存取點的用戶端將繼續運作，直到終止連線為止。 這項操作需要 `elasticfilesystem:DeleteAccessPoint` 動作的許可。 ## 請求語法 ``` DELETE /2015-02-01/access-points/AccessPointId HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [AccessPointId](#API_DeleteAccessPoint_RequestSyntax) ** 您要刪除的存取點 ID。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 204 ``` ## 回應元素 如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。 ## 錯誤 ** AccessPointNotFound ** 如果指定的`AccessPointId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteAccessPoint) # DeleteFileSystem 刪除檔案系統，永久伺服其內容的存取。傳回時，文件系統不再存在，您無法存取已刪除文件系統的任何內容。 您必須先手動刪除附加至檔案系統的掛載目標，才能刪除 EFS 檔案系統。當您使用 AWS 主控台刪除檔案系統時，會為您執行此步驟。 **注意** 您無法刪除屬於 EFS 複寫組態的檔案系統。您需要先刪除複寫組態。 您無法刪除正在使用的檔案系統。也就是說，如果檔案系統有任何掛載目標，您必須先刪除它們。如需詳細資訊，請參閱[DescribeMountTargets](API_DescribeMountTargets.md)及[DeleteMountTarget](API_DeleteMountTarget.md)。 **注意** `DeleteFileSystem` 呼叫會在檔案系統狀態仍處於 `deleting` 時傳回。因 [DescribeFileSystems](API_DescribeFileSystems.md) 操作會傳回您帳戶中的檔案系統清單，所以您可以通過呼叫該操作來檢查檔案系統刪除狀態。如果您傳遞檔案系統 ID 或已刪除檔案系統的建立權杖，則 [DescribeFileSystems](API_DescribeFileSystems.md) 會傳回 `404 FileSystemNotFound` 錯誤。 這項操作需要 `elasticfilesystem:DeleteFileSystem` 動作的許可。 ## 請求語法 ``` DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) ** 您要刪除的檔案系統 ID。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 204 ``` ## 回應元素 如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemInUse ** 如果檔案系統有掛載目標，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 範例 ### 刪除檔案系統 下列範例將 DELETE 請求傳送至 `file-systems` 端點 (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`)，以刪除 ID 為 `fs-01234567` 的檔案系統。 #### 請求範例 ``` DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T233021Z Authorization: <...> ``` #### 回應範例 ``` HTTP/1.1 204 No Content x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33 Content-Length: 0 ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem) # DeleteFileSystemPolicy 為指定檔案系統刪除 `FileSystemPolicy`。刪除現有策略後，預設 `FileSystemPolicy` 便會生效。如需關於預設檔案系統政策的詳細資訊，請參閱[在 EFS 中使用以資源為基礎的政策](https://docs.aws.amazon.com/efs/latest/ug/res-based-policies-efs.html)。 這項操作需要 `elasticfilesystem:DeleteFileSystemPolicy` 動作的許可。 ## 請求語法 ``` DELETE /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_DeleteFileSystemPolicy_RequestSyntax) ** 指定要刪除的 `FileSystemPolicy` 的 EFS 檔案系統。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) # DeleteMountTarget 刪除指定的掛載目標。 如果您刪除了掛載目標，該操作會強制中斷任何掛載的檔案系統掛載，此舉可能會中斷使用該掛載的執行個體或應用程式。為避免應用程式突然切斷，如果可行，您可以考慮卸載掛載目標的任何掛載。此操作也會刪除相關聯的網路介面。寫入未遞交時可能會遺失，但是借此操作中斷掛載目標並不會損毀檔案系統本身。您建立的檔案系統仍存在。您可以使用另一個掛載目標在 VPC 中掛載 EC2 執行個體。 此操作需要在檔案系統上具備以下動作的許可： + `elasticfilesystem:DeleteMountTarget` **注意** `DeleteMountTarget` 呼叫會在掛載目標狀態仍處於 `deleting` 時傳回。因 [DescribeMountTargets](API_DescribeMountTargets.md) 操作會傳回給定文件系統的掛載目標描述列表，所以您可以呼叫該操作來檢查掛載目標刪除情況。 此操作還需要在掛載目標網路介面上獲得下列 Amazon EC2 動作的許可： + `ec2:DeleteNetworkInterface` ## 請求語法 ``` DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) ** 要刪除的掛載目標 ID (字串)。 長度限制：長度下限為 13。長度上限為 45。 模式：`^fsmt-[0-9a-f]{8,40}$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 204 ``` ## 回應元素 如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** DependencyTimeout ** 嘗試處理請求時服務逾時，那麽用戶端應該再次嘗試呼叫。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：504 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** MountTargetNotFound ** 如果在發起人的 AWS 帳戶帳戶中找不到指定 ID 的掛載目標，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ## 範例 ### 移除檔案系統的掛載目標 下列範例會傳送 DELETE 請求以刪除特定掛載目標。 #### 請求範例 ``` DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T232908Z Authorization: <...> ``` #### 回應範例 ``` HTTP/1.1 204 No Content x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteMountTarget) # DeleteReplicationConfiguration 刪除複寫組態。刪除複寫組態，結束複寫程序。刪除複寫組態之後，目的地檔案系統變成 `Writeable`，同時系統重新啟用其複寫保護。如需詳細資訊，請參閱[刪除複寫組態](https://docs.aws.amazon.com/efs/latest/ug/delete-replications.html)。 這項操作需要 `elasticfilesystem:DeleteReplicationConfiguration` 動作的許可。 ## 請求語法 ``` DELETE /2015-02-01/file-systems/SourceFileSystemId/replication-configuration?deletionMode=DeletionMode HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [DeletionMode](#API_DeleteReplicationConfiguration_RequestSyntax) ** 跨 AWS 帳戶 或跨 複寫時 AWS 區域，Amazon EFS 預設會從來源和目的地帳戶或區域 (`ALL_CONFIGURATIONS`) 刪除複寫組態。如果發生組態或許可問題，阻止 Amazon EFS 從兩側刪除複寫組態，您可以使用 `LOCAL_CONFIGURATION_ONLY` 模式，僅從本機端 （執行刪除的帳戶或區域） 刪除複寫組態。 只有在 Amazon EFS 無法刪除來源和目的地帳戶或區域中的複寫組態時，才使用 `LOCAL_CONFIGURATION_ONLY` 模式。刪除本機組態會使其他帳戶或區域中的組態無法復原。 此外，請勿將此模式用於相同帳戶、相同區域的複寫，否則會導致 BadRequest 例外狀況錯誤。 有效值:`ALL_CONFIGURATIONS | LOCAL_CONFIGURATION_ONLY` ** [SourceFileSystemId](#API_DeleteReplicationConfiguration_RequestSyntax) ** 複寫組態中的來源檔案系統 ID。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 204 ``` ## 回應元素 如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ReplicationNotFound ** 如果指定的檔案系統沒有複寫組態，則傳回。 ** ErrorCode ** ReplicationNotFound ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) # DeleteTags **注意** 已作廢：`DeleteTags` 已棄用且不受維護。若要從 EFS 資源移除標籤，請使用 [UntagResource](API_UntagResource.md) API 動作。 從檔案系統刪除指定的標籤。如果 `DeleteTags` 請求包含不存在的標籤金鑰，那麽 Amazon EFS 會忽略該金鑰，避免造成錯誤。如需標籤和相關限制的詳細資訊，請參閱* AWS 帳單與成本管理 《 使用者指南*》中的[標籤限制](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。 這項操作需要 `elasticfilesystem:DeleteTags` 動作的許可。 ## 請求語法 ``` POST /2015-02-01/delete-tags/FileSystemId HTTP/1.1 Content-type: application/json { "TagKeys": [ "string" ] } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_DeleteTags_RequestSyntax) ** 您要刪除標籤的檔案系統 ID (字串)。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [TagKeys](#API_DeleteTags_RequestSyntax) ** 要刪除的標籤索引鍵清單。 類型：字串陣列 陣列成員：項目數下限為 1。項目數上限為 50。 長度限制：長度下限為 1。長度上限為 128。 模式：`^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$` 必要：是 ## 回應語法 ``` HTTP/1.1 204 ``` ## 回應元素 如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteTags) # DescribeAccessPoints 傳回特定 Amazon EFS 存取點的說明 (如果 `AccessPointId` 已提供)。如果您提供 EFS `FileSystemId`，則會傳回該檔案系統所有存取點的說明。您可以在請求中提供 `AccessPointId` 或 `FileSystemId`，但不能同時提供兩者。 這項操作需要 `elasticfilesystem:DescribeAccessPoints` 動作的許可。 ## 請求語法 ``` GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [AccessPointId](#API_DescribeAccessPoints_RequestSyntax) ** (選用) 指定要在回應中描述的 EFS 存取點；與 `FileSystemId` 互斥。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` ** [FileSystemId](#API_DescribeAccessPoints_RequestSyntax) ** (選用) 如果您提供 `FileSystemId`，EFS 會傳回該檔案系統的所有存取點；與 `AccessPointId` 互斥。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [MaxResults](#API_DescribeAccessPoints_RequestSyntax) ** (選用) 擷取檔案系統的所有存取點時，您可以選擇性地指定 `MaxItems` 參數，以限制回應中傳回的物件數目。預設值為 100. 有效範圍：最小值為 1。 ** [NextToken](#API_DescribeAccessPoints_RequestSyntax) ** 如果是分頁回應，那麽將會出現 `NextToken`。您可以在後續請求中使用 `NextMarker` 來擷取下一頁的存取點描述。 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "AccessPoints": [ { "AccessPointArn": "string", "AccessPointId": "string", "ClientToken": "string", "FileSystemId": "string", "LifeCycleState": "string", "Name": "string", "OwnerId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ], "NextToken": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [AccessPoints](#API_DescribeAccessPoints_ResponseSyntax) ** 存取點描述的陣列。 類型：[AccessPointDescription](API_AccessPointDescription.md) 物件陣列 ** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) ** 如果存取點超過回應中傳回的存取點，則顯示此陣列。您可以在後續請求中使用 NextMarker 來擷取下一頁的存取點描述。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ## 錯誤 ** AccessPointNotFound ** 如果指定的`AccessPointId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccessPoints) # DescribeAccountPreferences 在目前的 中，傳回與提出請求的使用者 AWS 帳戶 相關聯的 的帳戶偏好設定 AWS 區域。 ## 請求語法 ``` GET /2015-02-01/account-preferences HTTP/1.1 Content-type: application/json { "MaxResults": number, "NextToken": "string" } ``` ## URI 請求參數 請求不會使用任何 URI 參數。 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_DescribeAccountPreferences_RequestSyntax) ** (選用) 擷取帳戶偏好設定時，您可以選擇性地指定 `MaxItems` 參數，以限制回應中傳回的物件數目。預設值為 100. 類型：整數 有效範圍：最小值為 1。 必要：否 ** [NextToken](#API_DescribeAccountPreferences_RequestSyntax) ** (選用) 如果回應裝載已分頁，您可以 `NextToken` 在後續要求中使用來擷取 AWS 帳戶 偏好設定的下一頁。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` 必要：否 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "ResourceIdPreference": { "ResourceIdType": "string", "Resources": [ "string" ] } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_DescribeAccountPreferences_ResponseSyntax) ** 如果記錄多於回應中傳回的記錄，則會顯示此選項。您可以在後續請求中使用 `NextToken` 來擷取其他描述。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [ResourceIdPreference](#API_DescribeAccountPreferences_ResponseSyntax) ** 描述目前與發出請求的使用者 AWS 帳戶 相關聯的 的資源 ID 偏好設定 AWS 區域。 類型：[ResourceIdPreference](API_ResourceIdPreference.md) 物件 ## 錯誤 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences) # DescribeBackupPolicy 傳回指定 EFS 檔案系統的備份政策。 ## 請求語法 ``` GET /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_DescribeBackupPolicy_RequestSyntax) ** 指定要擷取 `BackupPolicy` 的 EFS 檔案系統。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "BackupPolicy": { "Status": "string" } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [BackupPolicy](#API_DescribeBackupPolicy_ResponseSyntax) ** 描述檔案系統的備份政策，指出自動備份是開啟還是關閉。 類型：[BackupPolicy](API_BackupPolicy.md) 物件 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** PolicyNotFound ** 如果找不到或無法存取指定的 IAM 政策或資源政策，則傳回。根據正在執行的動作，如果 EFS 檔案系統的預設檔案系統政策生效或未指定備份政策，也可能會傳回錯誤。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** ValidationException ** 如果在提出請求 AWS 區域 的 中無法使用 AWS Backup 服務，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy) # DescribeFileSystemPolicy 傳回指定 EFS 檔案系統的 `FileSystemPolicy`。 這項操作需要 `elasticfilesystem:DescribeFileSystemPolicy` 動作的許可。 ## 請求語法 ``` GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_DescribeFileSystemPolicy_RequestSyntax) ** 指定要擷取 `FileSystemPolicy` 的 EFS 檔案系統。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "FileSystemId": "string", "Policy": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [FileSystemId](#API_DescribeFileSystemPolicy_ResponseSyntax) ** 指定 `FileSystemPolicy` 套用的 EFS 檔案系統。 類型：字串 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [Policy](#API_DescribeFileSystemPolicy_ResponseSyntax) ** 適用於 EFS 檔案系統的 JSON 格式化 `FileSystemPolicy`。 類型：字串 長度限制：長度下限為 1。長度上限為 20,000。 模式：`[\s\S]+` ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** PolicyNotFound ** 如果找不到或無法存取指定的 IAM 政策或資源政策，則傳回。根據正在執行的動作，如果 EFS 檔案系統的預設檔案系統政策生效或未指定備份政策，也可能會傳回錯誤。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ## 範例 ### 範例 此範例說明了 DescribeFileSystemPolicy 的一種用法。 #### 請求範例 ``` GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1 ``` #### 回應範例 ``` { "FileSystemId": "fs-01234567", "Policy": "{ "Version": "2012-10-17", "Id": "efs-policy-wizard-cdef0123-aaaa-6666-5555-444455556666", "Statement": [ { "Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444", "Effect" : "Deny", "Principal": { "AWS": "*" }, "Action": "*", "Resource": "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567", "Condition": { "Bool": { "aws:SecureTransport": "false" } } }, { "Sid": "efs-statement-01234567-aaaa-3333-4444-111122223333", "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": [ "elasticfilesystem:ClientMount", "elasticfilesystem:ClientWrite" ], "Resource" : "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567" } ] } } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) # DescribeFileSystems 如果提供了檔案系統 `CreationToken` 或 `FileSystemId`，則傳回特定 Amazon EFS 檔案系統的說明。否則，它會在您呼叫的 AWS 區域 端點的 AWS 帳戶 中，傳回呼叫者 擁有的所有檔案系統的描述。 擷取所有檔案系統描述時，您可以選擇性地指定 `MaxItems` 參數，以限制回應中的描述數目。此數字會自動設定為 100。如果要保留更多檔案系統描述，Amazon EFS 會在回應中傳回 `NextMarker` (不透明權杖)。在這種情況下，您應該使用 `Marker` 請求參數 (設定為 `NextMarker` 的值) 傳送後續請求。 若要擷取檔案系統描述清單，則要在反覆程序中使用如下操作，即先呼叫 `DescribeFileSystems` 而不包含 `Marker`，然後使用 `Marker` 參數繼續呼叫，直至沒有 `NextMarker` 回應爲止。其中，參數設定為先前回應的 `NextMarker` 值。 未指定一次 `DescribeFileSystems` 呼叫回應中傳回的檔案系統順序，也未指定跨多路呼叫重複回應傳回的檔案系統順序。 這項操作需要 `elasticfilesystem:DescribeFileSystems` 動作的許可。 ## 請求語法 ``` GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [CreationToken](#API_DescribeFileSystems_RequestSyntax) ** (可選) 使用此建立權杖 (字串) 將列表限制為檔案系統。建立 Amazon EFS 檔案系統時，您要指定建立權杖。 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` ** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) ** (選用) 您要擷取其說明的檔案系統 ID (字串)。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [Marker](#API_DescribeFileSystems_RequestSyntax) ** (選用) 從先前的 `DescribeFileSystems` 操作中傳回不透明分頁權杖 (字串)。如果存在，則指定從傳回呼叫中斷的地方繼續列表。 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [MaxItems](#API_DescribeFileSystems_RequestSyntax) ** (選用) 指定回應中傳回的檔案系統數量上限。此數字會自動設定為 100。如果您有 100 多個檔案系統，那麽回應會以每頁 100 進行分頁。 有效範圍：最小值為 1。 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "FileSystems": [ { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "CreationTime": number, "CreationToken": "string", "Encrypted": boolean, "FileSystemArn": "string", "FileSystemId": "string", "FileSystemProtection": { "ReplicationOverwriteProtection": "string" }, "KmsKeyId": "string", "LifeCycleState": "string", "Name": "string", "NumberOfMountTargets": number, "OwnerId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "SizeInBytes": { "Timestamp": number, "Value": number, "ValueInArchive": number, "ValueInIA": number, "ValueInStandard": number }, "Tags": [ { "Key": "string", "Value": "string" } ], "ThroughputMode": "string" } ], "Marker": "string", "NextMarker": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) ** 檔案系統描述陣列。 類型：[FileSystemDescription](API_FileSystemDescription.md) 物件陣列 ** [Marker](#API_DescribeFileSystems_ResponseSyntax) ** 如果在請求中由發起人提供了相應的信息 (字串)，那麼這個信息就會在響應中呈現。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) ** 如果在回應中傳回的文件系統數量少於所有存在的文件系統，那麼相應的信息 (字串)就會在響應中呈現。您可以在後續請求中使用 `NextMarker` 來擷取下一頁描述。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 範例 ### 擷取 10 個檔案系統清單 下列範例會將 GET 請求傳送至 `file-systems` 端點 (`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`)。請求會指定 `MaxItems` 查詢參數，以便將檔案系統描述的數目限制為 10。 #### 請求範例 ``` GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191208Z Authorization: <...> ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 499 { "FileSystems":[ { "OwnerId":"251839141158", "CreationToken":"MyFileSystem1", "FileSystemId":"fs-01234567", "PerformanceMode" : "generalPurpose", "CreationTime":"1403301078", "LifeCycleState":"created", "Name":"my first file system", "NumberOfMountTargets":1, "SizeInBytes":{ "Timestamp": 1403301078, "Value": 29313618372, "ValueInArchive": 201156, "ValueInIA": 675432, "ValueInStandard": 29312741784 } } ] } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems) # DescribeLifecycleConfiguration 傳回指定 EFS 檔案系統的目前`LifecycleConfiguration`物件。生命週期管理使用 `LifecycleConfiguration` 物件來識別在儲存類別之間移動檔案的時間。對於沒有 `LifecycleConfiguration` 物件的檔案系統，呼叫會在回應中傳回空陣列。 這項操作需要 `elasticfilesystem:DescribeLifecycleConfiguration` 動作許可。 ## 請求語法 ``` GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) ** 您要擷取其 `LifecycleConfiguration` 物件的檔案系統 ID (字串)。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [LifecyclePolicies](#API_DescribeLifecycleConfiguration_ResponseSyntax) ** 生命週期管理政策陣列。EFS 最多為每個檔案系統支援一個政策。 類型：[LifecyclePolicy](API_LifecyclePolicy.md) 物件陣列 陣列成員：最多 3 個項目。 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 範例 ### 擷取檔案系統的生命週期組態 下列請求會擷取指定檔案系統的 `LifecycleConfiguration` 物件。 #### 請求範例 ``` GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20181120T221118Z Authorization: <...> ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 86 { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_270_DAYS" }, { "TransitionToIA": "AFTER_14_DAYS" }, { "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS" } ] } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) # DescribeMountTargets 傳回所有目前掛載目標的說明，或檔案系統的特定掛載目標。當請求所有目前的掛載目標時，未指定回應中傳回的掛載目標順序。 在 `FileSystemId` 中指定的檔案系統 ID 上或在 `MountTargetId` 中指定的掛載目標檔案系統上，此操作需要獲得 `elasticfilesystem:DescribeMountTargets` 動作的許可。 對應的 CLI 命令為 `describe-mount-targets`。 ## 請求語法 ``` GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) ** (選用) 您要列出其掛載目標的存取點 ID。如果您的請求中不包含 `FileSystemId` 或 `MountTargetId`，則其必須包含在您的請求中。接受作為輸入的存取點 ID 或 ARN。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` ** [FileSystemId](#API_DescribeMountTargets_RequestSyntax) ** (選用) 您要列出其掛載目標的檔案系統 ID (字串)。如果您的請求中不包含 `AccessPointId` 或 `MountTargetId`，則其必須包含在您的請求中。接受作為輸入的檔案系統 ID 或 ARN。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [Marker](#API_DescribeMountTargets_RequestSyntax) ** (選用) 從先前的 `DescribeMountTargets` 操作中傳回不透明分頁權杖 (字串)。如果存在，則指定從先前傳回呼叫中斷的地方繼續列表。 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [MaxItems](#API_DescribeMountTargets_RequestSyntax) ** (選用) 在回應中傳回的掛載目標數量上限。目前，此數字會自動設定為 10，而忽略其他值。如果您有 100 多個掛載目標，那麽回應會以每頁 100 進行分頁。 有效範圍：最小值為 1。 ** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) ** (選用) 您要描述的掛載目標 ID (字串)。如果您的請求中不包含 `FileSystemId`，則其必須包含在您的請求中。接受作為輸入的掛載目標 ID 或 ARN。 長度限制：長度下限為 13。長度上限為 45。 模式：`^fsmt-[0-9a-f]{8,40}$` ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "Marker": "string", "MountTargets": [ { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "FileSystemId": "string", "IpAddress": "string", "Ipv6Address": "string", "LifeCycleState": "string", "MountTargetId": "string", "NetworkInterfaceId": "string", "OwnerId": "string", "SubnetId": "string", "VpcId": "string" } ], "NextMarker": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [Marker](#API_DescribeMountTargets_ResponseSyntax) ** 如果請求包含 `Marker`，則回應會在此欄位中傳回該值。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) ** 將文件系統的掛載目標作為 `MountTargetDescription` 對象陣列傳回。 類型：[MountTargetDescription](API_MountTargetDescription.md) 物件陣列 ** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) ** 如果值存在，則會有更多要傳回的掛載目標。在後續請求中，您可以在請求中使用此值來提供 `Marker`，以擷取下一組掛載目標。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ## 錯誤 ** AccessPointNotFound ** 如果指定的`AccessPointId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** MountTargetNotFound ** 如果在發起人的 AWS 帳戶帳戶中找不到指定 ID 的掛載目標，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ## 範例 ### 擷取為檔案系統建立的掛載目標說明 下列請求會擷取針對指定檔案系統建立的掛載目標說明。 #### 請求範例 ``` GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191252Z Authorization: <...> ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 357 { "MountTargets":[ { "OwnerId":"251839141158", "MountTargetId":"fsmt-01234567", "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "LifeCycleState":"added", "IpAddress":"10.0.2.42", "NetworkInterfaceId":"eni-1bcb7772" } ] } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets) # DescribeMountTargetSecurityGroups 傳回掛載目標目前作用中的安全群組。此操作要求已建立掛載目標的網路介面，且掛載目標的生命週期狀態不是「已刪除 (`deleted`)」 。 此操作需要以下動作的許可： + 掛載目標檔案系統上的 `elasticfilesystem:DescribeMountTargetSecurityGroups` 動作。 + `ec2:DescribeNetworkInterfaceAttribute` 掛載目標網路介面上的動作。 ## 請求語法 ``` GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [MountTargetId](#API_DescribeMountTargetSecurityGroups_RequestSyntax) ** 您要擷取其安全群組的掛載目標 ID。 長度限制：長度下限為 13。長度上限為 45。 模式：`^fsmt-[0-9a-f]{8,40}$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "SecurityGroups": [ "string" ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [SecurityGroups](#API_DescribeMountTargetSecurityGroups_ResponseSyntax) ** 安全群組陣列。 類型：字串陣列 陣列成員：最多 100 個項目。 長度限制：長度下限為 11。長度上限為 43。 模式：`^sg-[0-9a-f]{8,40}` ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** IncorrectMountTargetState ** 如果掛載目標並未處於操作的正確狀態，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** MountTargetNotFound ** 如果在發起人的 AWS 帳戶帳戶中找不到指定 ID 的掛載目標，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ## 範例 ### 擷取對檔案系統有效的安全群組 下列範例會擷取安全群組，這些安全群組對與掛載目標相關聯的網路介面有效。 #### 請求範例 ``` GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T223513Z Authorization: <...> ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Length: 57 { "SecurityGroups" : [ "sg-188d9f74" ] } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) # DescribeReplicationConfigurations 擷取特定檔案系統的複寫組態。如果未指定檔案系統， AWS 區域 則會擷取 AWS 帳戶 中 的所有複寫組態。 ## 請求語法 ``` GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_DescribeReplicationConfigurations_RequestSyntax) ** 您可以提供特定檔案系統的 ID，來擷取特定檔案系統的複寫組態。對於跨帳戶、跨區域複寫，帳戶只能描述自己區域中檔案系統的複寫組態。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [MaxResults](#API_DescribeReplicationConfigurations_RequestSyntax) ** (選用) 若要限制傳回在回應中的物件數目，您可以指定 `MaxItems` 參數。預設值為 100. 有效範圍：最小值為 1。 ** [NextToken](#API_DescribeReplicationConfigurations_RequestSyntax) ** 如果是分頁回應，那麽將會出現 `NextToken`。您可以在後續請求中使用 `NextToken` 來擷取下一頁輸出。 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Replications": [ { "CreationTime": number, "Destinations": [ { "FileSystemId": "string", "LastReplicatedTimestamp": number, "OwnerId": "string", "Region": "string", "RoleArn": "string", "Status": "string", "StatusMessage": "string" } ], "OriginalSourceFileSystemArn": "string", "SourceFileSystemArn": "string", "SourceFileSystemId": "string", "SourceFileSystemOwnerId": "string", "SourceFileSystemRegion": "string" } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_DescribeReplicationConfigurations_ResponseSyntax) ** 您可以在後續請求中使用先前回應裏的 `NextToken` 來擷取下一頁的存取點描述。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [Replications](#API_DescribeReplicationConfigurations_ResponseSyntax) ** 傳回的複寫組態集合。 類型：[ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md) 物件陣列 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ReplicationNotFound ** 如果指定的檔案系統沒有複寫組態，則傳回。 ** ErrorCode ** ReplicationNotFound ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** ValidationException ** 如果在提出請求 AWS 區域 的 中無法使用 AWS Backup 服務，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) # DescribeTags **注意** 已作廢：`DescribeTags` 動作已作廢且不受維護。若要檢視與 EFS 資源相關聯的標籤，請使用 `ListTagsForResource` API 動作。 傳回與檔案系統相關聯的所有標籤。未指定一次 `DescribeTags` 呼叫回應中傳回的標籤順序，也未指定跨多路呼叫 (使用分頁時) 重複回應傳回的標籤順序。 這項操作需要 `elasticfilesystem:DescribeTags` 動作的許可。 ## 請求語法 ``` GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_DescribeTags_RequestSyntax) ** 您要擷取其標籤的檔案系統 ID。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ** [Marker](#API_DescribeTags_RequestSyntax) ** (選用) 從先前的 `DescribeTags` 操作中傳回不透明分頁權杖 (字串)。如果存在，則指定從先前呼叫中斷的地方繼續列表。 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [MaxItems](#API_DescribeTags_RequestSyntax) ** (選用) 在回應中傳回的檔案系統數量上限。目前，此數字會自動設定為 100，而忽略其他值。如果您有 100 多個標籤，那麽回應會以每頁 100 進行分頁。 有效範圍：最小值為 1。 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "Marker": "string", "NextMarker": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [Marker](#API_DescribeTags_ResponseSyntax) ** 如果請求包含 `Marker`，則回應會在此欄位中傳回該值。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [NextMarker](#API_DescribeTags_ResponseSyntax) ** 如果值存在，則會有更多要傳回的標籤。在後續請求中，您可以在下一個請求中提供 `NextMarker` 的值作為 `Marker` 參數值的值，以擷取下一組標籤。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [Tags](#API_DescribeTags_ResponseSyntax) ** 傳回與檔案系統相關聯的標籤做為 `Tag` 物件陣列的檔案系統。 類型：[Tag](API_Tag.md) 物件陣列 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 範例 ### 擷取與檔案系統相關聯的所有標籤 下列請求會擷取與指定檔案系統相關聯的標籤 (鍵值對)。 #### 請求範例 ``` GET /2015-02-01/tags/fs-01234567/ HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T215404Z Authorization: <...> ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 288 { "Tags":[ { "Key":"Name", "Value":"my first file system" }, { "Key":"Fleet", "Value":"Development" }, { "Key":"Developer", "Value":"Alice" } ] } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeTags) # ListTagsForResource 列出頂層 EFS 資源的所有標籤。您必須提供要擷取標籤的資源 ID。 這項操作需要 `elasticfilesystem:DescribeAccessPoints` 動作的許可。 ## 請求語法 ``` GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [MaxResults](#API_ListTagsForResource_RequestSyntax) ** (選用) 指定回應中傳回的檔案系統數量上限。預設值為 100. 有效範圍：最小值為 1。 ** [NextToken](#API_ListTagsForResource_RequestSyntax) ** (選用) 如果回應承載已分頁，您可以在後續請求中使用 `NextToken` 來擷取下一頁存取點描述。 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [ResourceId](#API_ListTagsForResource_RequestSyntax) ** 指定您要擷取標籤的 EFS 資源。您可以使用此 API 端點擷取 EFS 檔案系統和存取點的標籤。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_ListTagsForResource_ResponseSyntax) ** 如果對回應承載進行分頁，那麽將會出現 `NextToken`。您可以在後續請求中使用 `NextToken` 來擷取下一頁的存取點描述。 類型：字串 長度限制：長度下限為 1。長度上限為 128。 模式：`.+` ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** 指定 EFS 資源的標籤陣列。 類型：[Tag](API_Tag.md) 物件陣列 ## 錯誤 ** AccessPointNotFound ** 如果指定的`AccessPointId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ListTagsForResource) # ModifyMountTargetSecurityGroups 修改掛載目標的作用中的安全群組。 當您建立掛載目標時，Amazon EFS 也會建立新的網路介面。如需詳細資訊，請參閱[CreateMountTarget](API_CreateMountTarget.md)。此作業會以要求中提供的，取代與掛載目標相關聯之網路介面的 `SecurityGroups` 有效安全群組。此操作要求已建立掛載目標的網路介面，且掛載目標的生命週期狀態不是「已刪除 (`deleted`)」 。 此操作需要下列 動作的許可： + 掛載目標檔案系統上的 `elasticfilesystem:ModifyMountTargetSecurityGroups` 動作。 + `ec2:ModifyNetworkInterfaceAttribute` 掛載目標網路介面上的動作。 ## 請求語法 ``` PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1 Content-type: application/json { "SecurityGroups": [ "string" ] } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) ** 您要修改其安全群組的掛載目標 ID。 長度限制：長度下限為 13。長度上限為 45。 模式：`^fsmt-[0-9a-f]{8,40}$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) ** VPC 安全群組 IDs的陣列。 類型：字串陣列 陣列成員：最多 100 個項目。 長度限制：長度下限為 11。長度上限為 43。 模式：`^sg-[0-9a-f]{8,40}` 必要：否 ## 回應語法 ``` HTTP/1.1 204 ``` ## 回應元素 如果動作成功，則服務會送回具有空 HTTP 主體的 HTTP 204 回應。 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** IncorrectMountTargetState ** 如果掛載目標並未處於操作的正確狀態，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** MountTargetNotFound ** 如果在發起人的 AWS 帳戶帳戶中找不到指定 ID 的掛載目標，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** SecurityGroupLimitExceeded ** 如果請求中`SecurityGroups`指定的 數目大於限制，則根據帳戶配額傳回。請刪除一些安全群組或請求提高帳戶配額。如需詳細資訊，請參閱《[Amazon VPC 使用者指南》中的 Amazon VPC Quotas](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html) （請參閱**安全群組**資料表）。 ** ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** SecurityGroupNotFound ** 如果子網路的虛擬私有雲端 (VPC) 中沒有其中一個指定的安全群組，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ## 範例 ### 取代裝載目標的安全群組 下列範例會取代與掛載目標相關聯之網路介面的有效安全群組。 #### 請求範例 ``` PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T223446Z Authorization: <...> Content-Type: application/json Content-Length: 57 { "SecurityGroups" : [ "sg-188d9f74" ] } ``` #### 回應範例 ``` HTTP/1.1 204 No Content x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) # PutAccountPreferences 使用此操作可設定目前 AWS 區域 區域中的帳戶偏好，以便為新 EFS 檔案系統使用長至 17 個字元 (63 位元) 或短至 8 個字元 (32 位元) 的資源 ID，並掛載目標資源。您所做的任何變更都不會影響所有現有資源 ID。當 EFS 轉移至長資源 ID 時，您可以在加入期間設定 ID 偏好。如需詳細資訊，請參閱[管理 Amazon EFS 資源 ID](https://docs.aws.amazon.com/efs/latest/ug/manage-efs-resource-ids.html)。 **注意** 從 2021 年 10 月開始，如果您嘗試將帳戶偏好設定為使用簡短的 8 字元格式資源 ID，將會收到錯誤訊息。如果您收到錯誤，且必須為檔案系統和掛載目標資源使用簡短 IDs請聯絡 AWS 支援。 ## 請求語法 ``` PUT /2015-02-01/account-preferences HTTP/1.1 Content-type: application/json { "ResourceIdType": "string" } ``` ## URI 請求參數 請求不會使用任何 URI 參數。 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [ResourceIdType](#API_PutAccountPreferences_RequestSyntax) ** 指定要為使用者的 設定的 EFS 資源 ID 偏好設定 AWS 帳戶，以目前 `LONG_ID`(17 個字元） AWS 區域或 `SHORT_ID`(8 個字元） 表示。 從 2021 年 10 月開始，將帳戶偏好設定為 `SHORT_ID` 時，您將收到錯誤信息。如果您收到錯誤，且必須為檔案系統和掛載目標資源使用簡短 IDs請聯絡 AWS 支援。 類型：字串 有效值:`LONG_ID | SHORT_ID` 必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "ResourceIdPreference": { "ResourceIdType": "string", "Resources": [ "string" ] } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [ResourceIdPreference](#API_PutAccountPreferences_ResponseSyntax) ** 描述目前 AWS 帳戶中使用者 的資源類型及其 ID 偏好設定 AWS 區域。 類型：[ResourceIdPreference](API_ResourceIdPreference.md) 物件 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutAccountPreferences) # PutBackupPolicy 更新檔案系統備份政策。使用此動作可啟動或停止檔案系統的自動備份。 ## 請求語法 ``` PUT /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1 Content-type: application/json { "BackupPolicy": { "Status": "string" } } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_PutBackupPolicy_RequestSyntax) ** 指定要更新備份政策的 EFS 檔案系統。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [BackupPolicy](#API_PutBackupPolicy_RequestSyntax) ** 包含在 `PutBackupPolicy` 請求中的備份政策。 類型：[BackupPolicy](API_BackupPolicy.md) 物件 必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "BackupPolicy": { "Status": "string" } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [BackupPolicy](#API_PutBackupPolicy_ResponseSyntax) ** 描述檔案系統的備份政策，指出自動備份是開啟還是關閉。 類型：[BackupPolicy](API_BackupPolicy.md) 物件 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ValidationException ** 如果在提出請求 AWS 區域 的 中無法使用 AWS Backup 服務，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutBackupPolicy) # PutFileSystemPolicy 將 Amazon EFS `FileSystemPolicy` 套用至 Amazon EFS 檔案系統。檔案系統政策是以 IAM 資源為基礎的政策，可包含多個政策聲明。檔案系統一律只有一個檔案系統政策，這些政策可以是預設原則或顯式政策集，或使用此 API 操作更新的政策。EFS 檔案系統政策字元限制為 20,000 以内。設定顯式政策時，該政策會覆寫預設政策。如需預設檔案系統政策的詳細資訊，請參閱[預設 EFS 檔案系統政策](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy)。 **注意** EFS 檔案系統政策字元限制為 20,000 以内。 這項操作需要 `elasticfilesystem:PutFileSystemPolicy` 動作的許可。 ## 請求語法 ``` PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1 Content-type: application/json { "BypassPolicyLockoutSafetyCheck": boolean, "Policy": "string" } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) ** 您要建立或更新 `FileSystemPolicy` 的 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})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) ** (選用) 用於指定是否繞過 `FileSystemPolicy` 政策鎖定安全檢查的布林值。鎖定安全檢查會決定請求中的政策是否鎖定 (阻止) 提出請求的 IAM 主體在此檔案系統上提出未來的 `PutFileSystemPolicy` 請求。僅當您打算阻止提出請求的 IAM 主體在此檔案系統上提出後續的 `PutFileSystemPolicy` 請求時，才將 `BypassPolicyLockoutSafetyCheck` 設定為 `True`。預設值為 `False`。 類型：布林值 必要：否 ** [Policy](#API_PutFileSystemPolicy_RequestSyntax) ** 您正在建立 `FileSystemPolicy`。接受 JSON 格式化政策定義。EFS 檔案系統政策字元限制為 20,000 以内。若要進一步了解構成檔案系統政策的元素，請參閱 [Amazon EFS 中的資源型政策](https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies)。 類型：字串 長度限制：長度下限為 1。長度上限為 20,000。 模式：`[\s\S]+` 必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "FileSystemId": "string", "Policy": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [FileSystemId](#API_PutFileSystemPolicy_ResponseSyntax) ** 指定 `FileSystemPolicy` 套用的 EFS 檔案系統。 類型：字串 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [Policy](#API_PutFileSystemPolicy_ResponseSyntax) ** 適用於 EFS 檔案系統的 JSON 格式化 `FileSystemPolicy`。 類型：字串 長度限制：長度下限為 1。長度上限為 20,000。 模式：`[\s\S]+` ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** InvalidPolicyException ** 如果 `FileSystemPolicy` 格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。如果出現政策鎖定安全檢查錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ## 範例 ### 建立 EFS FileSystemPolicy。 下列請求會建立 `FileSystemPolicy`，允許所有 AWS 主體掛載具有讀取和寫入許可的指定 EFS 檔案系統。 #### 請求範例 ``` PUT /2015-02-01/file-systems/fs-01234567/file-system-policy HTTP/1.1 { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "elasticfilesystem:ClientMount", "elasticfilesystem:ClientWrite" ], "Principal": { "AWS": ["*"] }, } ] } ``` #### 回應範例 ``` { "Version": "2012-10-17", "Id": "1", "Statement": [ { "Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444", "Effect": "Allow", "Action": [ "elasticfilesystem:ClientMount", "elasticfilesystem:ClientWrite" ], "Principal": { "AWS": ["*"] }, "Resource":"arn:aws:elasticfilesystem:us-east-1:1111222233334444:file-system/fs-01234567" } ] } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) # PutLifecycleConfiguration 使用此動作可管理檔案系統的儲存空間。`LifecycleConfiguration` 由定義下列項目的一或多個 `LifecyclePolicy` 物件組成： + **`TransitionToIA`**：何時將檔案系統中的檔案從主要儲存 (標準儲存類別) 移至 Infrequent Access (IA) 儲存類別。 + **`TransitionToArchive`**：何時將檔案系統中的檔案從目前主要儲存類別 (IA 或標準儲存) 移至「封存」儲存。 檔案系統在轉移至 IA 儲存之前，無法轉移至「封存」儲存。因此，禁止設定 TransitionToArchive，或必須晚於 TransitionToIA 轉移。 **注意** 封存儲存類別僅適用於使用彈性輸送量模式和一般用途效能模式的檔案系統。 + **`TransitionToPrimaryStorageClass`**：在檔案系統中的檔案存取到 IA 或「封存」儲存后，是否將其移回主要存儲 (標準存儲類別)。 如需詳細資訊，請參閱[管理檔案系統儲存](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html)。 每個 Amazon EFS 檔案系統都支援一個生命週期組態，該組態適用於檔案系統中的所有檔案。如果指定的檔案系統已存在 `LifecycleConfiguration` 物件，則 `PutLifecycleConfiguration` 呼叫會修改現有組態。請求主體中含有空 `LifecyclePolicies` 陣列的 `PutLifecycleConfiguration` 呼叫會刪除任何現有的 `LifecycleConfiguration`。在請求中，指定下列項目： + 您要啟用、停用或修改生命週期管理的檔案系統 ID。 + `LifecyclePolicy` 物件的 `LifecyclePolicies` 陣列用於定義將檔案移至 IA 儲存、「封存」儲存，以及移回主要儲存的時間。 **注意** Amazon EFS 要求每個 `LifecyclePolicy` 物件只能轉移一次，因此 `LifecyclePolicies` 陣列需要使用不同的 `LifecyclePolicy` 物件進行結構化。如需詳細資訊，請參閱下文中的請求範例。 這項操作需要 `elasticfilesystem:PutLifecycleConfiguration` 操作許可。 若要將`LifecycleConfiguration`物件套用至加密的檔案系統，您需要與建立加密檔案系統時相同的 AWS Key Management Service 許可。 ## 請求語法 ``` PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) ** 正在建立 `LifecycleConfiguration` 物件的檔案系統 ID (字串)。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) ** 用於定義檔案系統 `LifecycleConfiguration` 物件的 `LifecyclePolicy` 物件陣列。`LifecycleConfiguration` 物件會通知生命週期管理下列項目： + **`TransitionToIA`**：何時將檔案系統中的檔案從主要儲存 (標準儲存類別) 移至 Infrequent Access (IA) 儲存類別。 + **`TransitionToArchive`**：何時將檔案系統中的檔案從目前主要儲存類別 (IA 或標準儲存) 移至「封存」儲存。 檔案系統在轉移至 IA 儲存之前，無法轉移至「封存」儲存。因此，禁止設定 TransitionToArchive，或必須晚於 TransitionToIA 轉移。 **注意** 封存儲存類別僅適用於使用彈性輸送量模式和一般用途效能模式的檔案系統。 + **`TransitionToPrimaryStorageClass`**：在檔案系統中的檔案存取到 IA 或「封存」儲存后，是否將其移回主要存儲 (標準存儲類別)。 使用 `put-lifecycle-configuration` CLI 命令或 `PutLifecycleConfiguration` API 動作時，Amazon EFS 要求每個 `LifecyclePolicy` 物件只能有一次轉移。這意味著在請求內文中，`LifecyclePolicies` 必須結構化為 `LifecyclePolicy` 物件陣列，每次儲存轉移對應一個物件。如需詳細資訊，請參閱下文中的請求範例。 類型：[LifecyclePolicy](API_LifecyclePolicy.md) 物件陣列 陣列成員：最多 3 個項目。 必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) ** 生命週期管理政策陣列。EFS 最多為每個檔案系統支援一個政策。 類型：[LifecyclePolicy](API_LifecyclePolicy.md) 物件陣列 陣列成員：最多 3 個項目。 ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 範例 ### 建立生命週期組態 下列範例會使用 `PutLifecycleConfiguration` 動作建立 `LifecyclePolicy` 物件。此範例建立生命週期政策，以便指示 EFS 執行以下操作： + 將過去 30 天內未在標準儲存中存取過的檔案系統中的所有檔案移至封存儲存。 + 將過去 90 天內未在標準儲存中存取過的檔案系統中的所有檔案移至封存儲存。 + 檔案儲存到 IA 或「封存」儲存中后，再移回標準存儲。封存儲存類別僅適用於使用彈性輸送量模式和一般用途效能模式的檔案系統。 如需詳細資訊，請參閱 [EFS 儲存類別](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html)和[管理檔案系統儲存](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html)。 #### 請求範例 ``` PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20181122T232908Z Authorization: <...> Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorage": "AFTER_1_ACCESS" } ] } ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorage": "AFTER_1_ACCESS" } ] } ``` ### put-lifecycle-configuration CLI 請求範例 此範例說明了 PutLifecycleConfiguration 的一種用法。 #### 請求範例 ``` aws efs put-lifecycle-configuration \ --file-system-id fs-0123456789abcdefb \ --lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"}, {"TransitionToIA":"AFTER_30_DAYS"}, {"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}] --region us-west-2 \ --profile adminuser ``` #### 回應範例 ``` { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS" } ] } ``` ### 停用生命週期管理 下列範例會停用指定檔案系統的生命週期管理。 #### 請求範例 ``` PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20181122T232908Z Authorization: <...> Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] } ``` #### 回應範例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) # TagResource 建立 EFS 資源標籤。您可以使用此 API 操作建立 EFS 檔案系統標籤和存取點。 這項操作需要 `elasticfilesystem:TagResource` 動作的許可。 ## 請求語法 ``` POST /2015-02-01/resource-tags/ResourceId HTTP/1.1 Content-type: application/json { "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [ResourceId](#API_TagResource_RequestSyntax) ** 指定您要為其建立標籤的 EFS 資源的 ID。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [Tags](#API_TagResource_RequestSyntax) ** 新增的 `Tag` 物件陣列。每個 `Tag` 物件都是一個鍵值對。 類型：[Tag](API_Tag.md) 物件陣列 必要：是 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** AccessPointNotFound ** 如果指定的`AccessPointId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 範例 ### 建立檔案系統標籤 下列請求會在指定的檔案系統上建立三個標籤 (`"key1"`、`"key2"`、和 `"key3"`)。 #### 請求範例 ``` POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T221118Z Authorization: <...> Content-Type: application/json Content-Length: 160 { "Tags": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "value2" }, { "Key": "key3", "Value": "value3" } ] } ``` #### 回應範例 ``` HTTP/1.1 204 no content x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/TagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource) # UntagResource 從 EFS 資源移除標籤。您可以使用此 API 操作移除 EFS 檔案系統標籤和存取點。 這項操作需要 `elasticfilesystem:UntagResource` 動作的許可。 ## 請求語法 ``` DELETE /2015-02-01/resource-tags/ResourceId?tagKeys=TagKeys HTTP/1.1 ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [ResourceId](#API_UntagResource_RequestSyntax) ** 指定要移除其中標籤的 EFS 資源。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$` 必要：是 ** [TagKeys](#API_UntagResource_RequestSyntax) ** 要從指定 EFS 資源中移除的鍵值標籤對的索引鍵。 陣列成員：項目數下限為 1。項目數上限為 50。 長度限制：長度下限為 1。長度上限為 128。 模式：`^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$` 必要：是 ## 請求主體 請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** AccessPointNotFound ** 如果指定的`AccessPointId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UntagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UntagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UntagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UntagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UntagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UntagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UntagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UntagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UntagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UntagResource) # UpdateFileSystem 更新輸送量模式或現有檔案系統的佈建輸送量。 ## 請求語法 ``` PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1 Content-type: application/json { "ProvisionedThroughputInMibps": number, "ThroughputMode": "string" } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_UpdateFileSystem_RequestSyntax) ** 您要更新的檔案系統 ID。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_RequestSyntax) ** (選用) 您要為所建立檔案系統佈建的輸送量 (以 MiB/s 為單位)。若將 `ThroughputMode` 設為 `provisioned`，則為必要項目。有效值為 1 - 3414 MiBps，上限視「地區」而定。若要提高此限制，請聯絡 支援。如需詳細資訊，請參閱《Amazon EFS 使用者指南》中的[您可以增加的 Amazon EFS 配額](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)。 類型：Double 有效範圍：最小值為 1.0。 必要：否 ** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) ** (選用) 更新檔案系統的輸送量模式。如果您不更新輸送量模式，則不需要在請求中提供此值。若您正在將 `ThroughputMode` 設為 `provisioned`，您也必須為 `ProvisionedThroughputInMibps` 設定值。 類型：字串 有效值:`bursting | provisioned | elastic` 必要：否 ## 回應語法 ``` HTTP/1.1 202 Content-type: application/json { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "CreationTime": number, "CreationToken": "string", "Encrypted": boolean, "FileSystemArn": "string", "FileSystemId": "string", "FileSystemProtection": { "ReplicationOverwriteProtection": "string" }, "KmsKeyId": "string", "LifeCycleState": "string", "Name": "string", "NumberOfMountTargets": number, "OwnerId": "string", "PerformanceMode": "string", "ProvisionedThroughputInMibps": number, "SizeInBytes": { "Timestamp": number, "Value": number, "ValueInArchive": number, "ValueInIA": number, "ValueInStandard": number }, "Tags": [ { "Key": "string", "Value": "string" } ], "ThroughputMode": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 202 回應。 服務會傳回下列 JSON 格式的資料。 ** [AvailabilityZoneId](#API_UpdateFileSystem_ResponseSyntax) ** 檔案系統所在可用區域的唯一且一致的識別碼僅對單區域有效。例如， `use1-az1` 是 us-east-1 的可用區域 ID AWS 區域，且每個 都有相同的位置 AWS 帳戶。 類型：字串 ** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) ** 描述檔案系統所在的 AWS 可用區域，且僅適用於單區域檔案系統。如需詳細資訊，請參閱《Amazon EFS 使用者指南》**中的[使用 EFS 儲存類別](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html)。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` ** [CreationTime](#API_UpdateFileSystem_ResponseSyntax) ** 建立檔案系統的時間，以秒為單位 (自 1970-01-01T00:00:00Z 以來)。 類型：Timestamp ** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) ** 請求中指定的不透明字串。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` ** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) ** 布林值，若為 true，指出加密檔案系統。 類型：布林值 ** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) ** 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` 類型：字串 ** [FileSystemId](#API_UpdateFileSystem_ResponseSyntax) ** 由 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})$` ** [FileSystemProtection](#API_UpdateFileSystem_ResponseSyntax) ** 說明檔案系統的防護。 類型：[FileSystemProtectionDescription](API_FileSystemProtectionDescription.md) 物件 ** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) ** 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/_-]+))))$` ** [LifeCycleState](#API_UpdateFileSystem_ResponseSyntax) ** 檔案系統的生命周期階段。 類型：字串 有效值:`creating | available | updating | deleting | deleted | error` ** [Name](#API_UpdateFileSystem_ResponseSyntax) ** 您可以將標籤 (包括 `Name` 標籤) 新增至檔案系統。如需詳細資訊，請參閱[CreateFileSystem](API_CreateFileSystem.md)。如果檔案系統有 `Name` 標籤，Amazon EFS 會傳回此欄位中的值。 類型：字串 長度限制：長度上限為 256。 模式：`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` ** [NumberOfMountTargets](#API_UpdateFileSystem_ResponseSyntax) ** 檔案系統目前擁有的掛載目標數。如需詳細資訊，請參閱[CreateMountTarget](API_CreateMountTarget.md)。 類型：整數 有效範圍：最小值為 0。 ** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) ** AWS 帳戶 建立檔案系統的 。 類型：字串 長度限制：長度上限為 14。 模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [PerformanceMode](#API_UpdateFileSystem_ResponseSyntax) ** 檔案系統的效能模式。 類型：字串 有效值:`generalPurpose | maxIO` ** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) ** 檔案系統的佈建輸送量總量 (以 MiBps 為單位)。對使用 `ThroughputMode` 設定為 `provisioned` 的檔案系統有效。 類型：Double 有效範圍：最小值為 1.0。 ** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) ** 儲存在檔案系統、`Value` 欄位中的資料最新已知計量大小 (以位元組為單位)，以及在 `Timestamp` 欄位中決定該大小的時間。`Timestamp` 值是自 1970-01-01T00:00:00Z 以來的整數秒數。`SizeInBytes` 值不代表檔案系統的一致快照集大小，但是在沒有寫入檔案系統時，它最終會保持一致。也就是說，只有超過幾個小時未修改檔案系統，`SizeInBytes` 才能表示實際大小。否則，該值并不能代表檔案系統在任何時間點的確切大小。 類型：[FileSystemSize](API_FileSystemSize.md) 物件 ** [Tags](#API_UpdateFileSystem_ResponseSyntax) ** 與檔案系統相關聯的標籤以 `Tag` 物件陣列形式呈現出來。 類型：[Tag](API_Tag.md) 物件陣列 ** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) ** 顯示檔案系統的輸送量模式。如需詳細資訊，請參閱《Amazon EFS 使用者指南》**中的[輸送量模式](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes)。 類型：字串 有效值:`bursting | provisioned | elastic` ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InsufficientThroughputCapacity ** 如果沒有足夠容量佈建其他輸送量，則傳回。當您嘗試以佈建輸送量模式建立檔案系統、嘗試增加現有檔案系統的佈建輸送量，或嘗試將現有檔案系統從「爆增輸送量」變更為「佈建輸送量」模式時，系統可能會傳回此值。請稍後再試。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：503 ** InternalServerError ** 如果在伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ThroughputLimitExceeded ** 如果因為已達到 1024 MB 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** TooManyRequests ** 如果您在變更輸送量模式或降低佈建輸送量值之前未等待至少 24 小時，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：429 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem) # UpdateFileSystemProtection 更新檔案系統保護。 這項操作需要 `elasticfilesystem:UpdateFileSystemProtection` 動作的許可。 ## 請求語法 ``` PUT /2015-02-01/file-systems/FileSystemId/protection HTTP/1.1 Content-type: application/json { "ReplicationOverwriteProtection": "string" } ``` ## URI 請求參數 請求會使用下列 URI 參數。 ** [FileSystemId](#API_UpdateFileSystemProtection_RequestSyntax) ** 要更新的檔案系統 ID。 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必要：是 ## 請求主體 請求接受採用 JSON 格式的下列資料。 ** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_RequestSyntax) ** 檔案系統複寫覆寫保護的狀態。 + `ENABLED`：檔案系統不能在複寫組態中作爲目的地檔案系統。檔案系統可寫入。複寫覆寫保護預設為 `ENABLED`。 + `DISABLED`：檔案系統能在複寫組態中作爲目的地檔案系統。檔案系統為只讀，只可由 EFS 複寫修改。 + `REPLICATING`：檔案系統正在複寫組態中用作目的地檔案系統。檔案系統為只讀，只可由 EFS 複寫修改。 如果刪除複寫組態，則會重新啟用檔案系統的複寫覆寫保護，且檔案系統可寫入。 類型：字串 有效值:`ENABLED | DISABLED | REPLICATING` 必要：否 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "ReplicationOverwriteProtection": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_ResponseSyntax) ** 檔案系統複寫覆寫保護的狀態。 + `ENABLED`：檔案系統不能在複寫組態中作爲目的地檔案系統。檔案系統可寫入。複寫覆寫保護預設為 `ENABLED`。 + `DISABLED`：檔案系統能在複寫組態中作爲目的地檔案系統。檔案系統為只讀，只可由 EFS 複寫修改。 + `REPLICATING`：檔案系統正在複寫組態中用作目的地檔案系統。檔案系統為唯讀，且只能透過 EFS 複寫進行修改。 如果刪除複寫組態，那麽檔案系統的複寫覆寫保護會重新啓動，且檔案系統變為可寫入。 類型：字串 有效值:`ENABLED | DISABLED | REPLICATING` ## 錯誤 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InsufficientThroughputCapacity ** 如果沒有足夠容量佈建其他輸送量，則傳回。當您嘗試以佈建輸送量模式建立檔案系統、嘗試增加現有檔案系統的佈建輸送量，或嘗試將現有檔案系統從「爆增輸送量」變更為「佈建輸送量」模式時，系統可能會傳回此值。請稍後再試。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：503 ** InternalServerError ** 如果在伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ReplicationAlreadyExists ** 如果檔案系統已包含在複製組態中，則傳回。> ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** ThroughputLimitExceeded ** 如果因為已達到 1024 MB 的輸送量限制而無法變更輸送量模式或佈建輸送量縂量，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** TooManyRequests ** 如果您在變更輸送量模式或降低佈建輸送量值之前未等待至少 24 小時，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：429 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)