本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 操作 支持以下操作： + [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 客户端提供的任何身份信息。文件系统路径作为访问点的根目录公开。使用接入点的应用程序只能访问其自己的目录中以及任何子目录中的数据。一个文件系统最多可配置 10000 个接入点，除非您申请提高该上限。要了解更多信息，请参阅[使用 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) ** 一个由最多 64 个 ASCII 字符组成的字符串，Amazon EFS 使用此字符串来确保幂等性创建。 类型：字符串 长度限制：最小长度为 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 客户端公开。使用接入点的客户端只能对根目录及之下的目录进行访问。如果指定的 `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 资源名称（ARN)。 类型：字符串 长度限制：最大长度为 128。 模式：`^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$` ** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) ** 接入点 ID，由 Amazon EFS 分配。 类型：字符串 长度限制：最大长度为 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 身份，包括接入点 IDs 上的用户 ID、组 ID 和辅助组，NFS 客户端使用该接入点进行所有文件操作。 类型：[PosixUser](API_PosixUser.md) 对象 ** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) ** EFS 文件系统上的目录，接入点将其作为根目录，向使用接入点的 NFS 客户端公开。 类型：[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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS Python 软件开发工具包](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)。 **注意** 当文件系统的生命周期状态仍为 `creating` 时，`CreateFileSystem` 调用将返回。可以通过调用 [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)。您可以使用挂载目标将 Amazon EFS 文件系统挂载到您的 VPC 中的 EC2 实例上。有关更多信息，请参阅 [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)。 一个区域文件系统并非在所有可用 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 资源名称（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`，则必须将:encrypted [CreateFileSystem参数](#efs-CreateFileSystem-request-Encrypted)设置为 true。 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) ** 您要为正在创建的文件系统预配置的吞吐量，以兆字节每秒 (MiBps) 为单位。如果将 `ThroughputMode` 设置为 `provisioned`，则是必需的。有效值为 1-3414 MiBps，上限视区域而定。要提高此限制，请联系 支持。有关更多信息，请参阅《Amazon EFS 用户指南》**中的[您可以提高的 Amazon EFS 配额](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)。 类型：双精度 有效范围：最小值为 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 AWS 区域-1 的可用区 ID，它在每个可用区中的位置都相同。 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 起）。 类型：时间戳 ** [CreationToken](#API_CreateFileSystem_ResponseSyntax) ** 请求中指定的不透明字符串。 类型：字符串 长度限制：最小长度为 1。长度上限为 64。 模式：`.+` ** [Encrypted](#API_CreateFileSystem_ResponseSyntax) ** 一个布尔值，如果设为 true，则指示文件系统已加密。 类型：布尔值 ** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) ** EFS 文件系统的 Amazon 资源名称（ARN），采用 `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id ` 格式。使用示例数据的示例：`arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567` 类型：字符串 ** [FileSystemId](#API_CreateFileSystem_ResponseSyntax) ** 文件系统 ID，由 Amazon EFS 分配。 类型：字符串 长度限制：最大长度为 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [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` 的文件系统有效。 类型：双精度 有效范围：最小值为 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 的吞吐量限制而无法更改吞吐量模式或预配置吞吐量 MiB/s ，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：400 ** UnsupportedAvailabilityZone ** 如果请求的 Amazon EFS 功能在指定的可用区中不可用，则返回此值。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：400 ## 示例 ### 创建加密 EFS 文件系统 以下示例发送 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" } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem) + [AWS Python 软件开发工具包](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 会从为 `SubnetId` 指定的子网中选择未使用的 IP 地址。 类型：字符串 长度限制：最小长度为 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` is `IPV4_ONLY` 和 `AssignIpv6AddressOnCreation` is`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 会从为 `SubnetId` 指定的子网中选择未使用的 IP 地址。 类型：字符串 长度限制：最小长度为 3。最大长度为 39。 必需：否 ** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) ** VPC 安全组 IDs，形式为`sg-xxxxxxxx`。它们必须用于与指定子网相同的 VPC。安全组的最大数量取决于账户配额。有关更多信息，请参阅《Amazon VPC 用户指南》中的 [Amazon VPC 配额](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 区域的可用区 ID，并且每个区域的位置都相同。 AWS 账户 类型：字符串 ** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) ** 挂载目标所在的可用区名称。可用区独立映射到每个可用区的名称 AWS 账户。例如，您的可用区`us-east-1a` AWS 账户 可能与其他可用区不同 AWS 账户。`us-east-1a` 类型：字符串 长度限制：最小长度为 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）ID。 类型：字符串 ## 错误 ** 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 ** 如果请求中未指定 `IpAddress` 或 `Ipv6Address` 且指定的子网中没有空闲的 IP 地址，则返回此错误。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：409 ** SecurityGroupLimitExceeded ** 当请求中指定的 `SecurityGroups` 数量超过基于账户配额设定的限制时，将返回此错误。要么删除一些安全组，要么请求提高账户配额。有关更多信息，请参阅《Amazon VPC 用户指南》中的 [Amazon VPC 配额](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" } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS Python 软件开发工具包](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) ** 描述复制配置的创建时间。 类型：时间戳 ** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) ** 目标对象的数组。仅支持一个目标对象。 类型：[Destination](API_Destination.md) 对象数组 ** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) ** 复制配置中原始源 EFS 文件系统的 Amazon 资源名称 (ARN)。 类型：字符串 ** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) ** 复制配置中当前源文件系统的 Amazon 资源名称（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) ** 源文件系统所在的 ID。 AWS 账户 类型：字符串 长度限制：最大长度为 14。 模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) ** 源 EFS 文件系统所在的。 AWS 区域 类型：字符串 长度限制：最小长度为 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 Backup 服务不可用 AWS 区域 ，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：400 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration) + [AWS Python 软件开发工具包](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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateTags) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateTags) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateTags) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateTags) + [AWS Python 软件开发工具包](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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteAccessPoint) + [AWS Python 软件开发工具包](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)。 **注意** 当文件系统状态仍为 `deleting` 时，将返回 `DeleteFileSystem` 调用。可以通过调用 [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 ## 示例 ### 删除文件系统 以下示例向 `file-systems` 端点（`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`）发送 DELETE 请求，以删除 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 ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem) + [AWS Python 软件开发工具包](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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy) + [AWS Python 软件开发工具包](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` **注意** 当挂载目标状态仍为 `deleting` 时，将返回 `DeleteMountTarget` 调用。可以通过调用 [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 ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget) + [AWS Python 软件开发工具包](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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration) + [AWS Python 软件开发工具包](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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteTags) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteTags) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteTags) + [AWS Python 软件开发工具包](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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints) + [AWS Python 软件开发工具包](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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences) + [AWS Python 软件开发工具包](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 Backup 服务不可用 AWS 区域 ，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：400 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy) + [AWS Python 软件开发工具包](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。最大长度为 20000。 模式：`[\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" } ] } } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy) + [AWS Python 软件开发工具包](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 返回特定 Amazon EFS 文件系统的描述（如果提供了文件系统 `CreationToken` 或 `FileSystemId`）。否则，它将返回您正在调用的端点 AWS 账户 中调用方拥有的所有文件系统的描述。 AWS 区域 检索所有文件系统描述时，可以选择指定 `MaxItems` 参数来限制响应中的描述数量。此数字自动设置为 100。如果还有更多文件系统描述，Amazon EFS 将在响应中返回一个不透明的令牌 `NextMarker`。在这种情况下，应发送一个后续请求，并将 `Marker` 请求参数的值设置为 `NextMarker`。 要检索文件系统描述列表，可以在迭代过程中使用此操作，在此过程中，首先在没有 `Marker` 的情况下调用 `DescribeFileSystems`，然后操作继续调用此内容，并将 `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 个文件系统的列表 以下示例向 `file-systems` 端点（`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`）发送 GET 请求。该请求指定一个 `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 } } ] } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems) + [AWS Python 软件开发工具包](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" } ] } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) + [AWS Python 软件开发工具包](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" } ] } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS Python 软件开发工具包](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" ] } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS 适用于 Java 的 SDK V2](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups) + [AWS Python 软件开发工具包](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 Backup 服务不可用 AWS 区域 ，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：400 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations) + [AWS Python 软件开发工具包](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" } ] } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeTags) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeTags) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeTags) + [AWS Python 软件开发工具包](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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ListTagsForResource) + [AWS Python 软件开发工具包](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 配额](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 ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups) + [AWS Python 软件开发工具包](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 区域 帐户首选项设置为使用长 17 个字符（63 位）或短 8 个字符（32 位）的资源 IDs 来存储新 EFS 文件系统和挂载目标资源。所有现有资源 IDs 都不会受到您所做的任何更改的影响。在 EFS 过渡到长资源 IDs时，您可以在选择加入期内设置 ID 首选项。有关更多信息，请参阅[管理 Amazon EFS 资源 IDs](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 账户 AWS 区域，当前格式为`LONG_ID`（17 个字符）或`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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutAccountPreferences) + [AWS Python 软件开发工具包](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 Backup 服务不可用 AWS 区域 ，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：400 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutBackupPolicy) + [AWS Python 软件开发工具包](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 文件系统策略有 2 万个字符的限制。设置显式策略后，它会覆盖默认策略。有关默认文件系统策略的更多信息，请参阅[默认 EFS 文件系统策略](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy)。 **注意** EFS 文件系统策略有 2 万个字符的限制。 此操作需要 `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 文件系统策略有 2 万个字符的限制。要详细了解构成文件系统策略的元素，请参阅 [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。最大长度为 20000。 模式：`[\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。最大长度为 20000。 模式：`[\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" } ] } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy) + [AWS Python 软件开发工具包](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`** – 何时将文件系统中的文件从主存储（标准存储类）移到不频繁访问 (IA) 存储。 + **`TransitionToArchive`** - 何时将文件系统中的文件从其当前存储类别（IA 或标准存储）移到存档存储。 在转换为 IA 存储之前，文件系统无法转换为归档存储。因此， TransitionToArchive 要么不能设置，要么必须晚于 TransitionTo IA。 **注意** 归档存储类仅适用于使用弹性吞吐量模式和通用性能模式的文件系统。 + **`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` 对象只有一次转换，因此需要使用单独的 `LifecyclePolicy` 对象来构造 `LifecyclePolicies` 数组。有关更多信息，请参阅以下部分中的示例请求。 此操作需要 `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`** – 何时将文件系统中的文件从主存储（标准存储类）移到不频繁访问 (IA) 存储。 + **`TransitionToArchive`** - 何时将文件系统中的文件从其当前存储类别（IA 或标准存储）移到存档存储。 在转换为 IA 存储之前，文件系统无法转换为归档存储。因此， TransitionToArchive 要么不能设置，要么必须晚于 TransitionTo IA。 **注意** 归档存储类仅适用于使用弹性吞吐量模式和通用性能模式的文件系统。 + **`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 天内未在标准存储中访问过的所有文件移到 IA 存储。 + 将文件系统中过去 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-configurationCLI 请求示例 此示例说明了的一种用法 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": [ ] } ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS Python 软件开发工具包](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 ``` ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/TagResource) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource) + [AWS Python 软件开发工具包](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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UntagResource) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UntagResource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UntagResource) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UntagResource) + [AWS Python 软件开发工具包](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) ** （可选）您要为正在创建的文件系统预配置的吞吐量，以兆字节每秒 (MiBps) 为单位。如果将 `ThroughputMode` 设置为 `provisioned`，则是必需的。有效值为 1-3414 MiBps，上限视区域而定。要提高此限制，请联系 支持。有关更多信息，请参阅《Amazon EFS 用户指南》**中的[您可以提高的 Amazon EFS 配额](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)。 类型：双精度 有效范围：最小值为 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 AWS 区域-1 的可用区 ID，它在每个可用区中的位置都相同。 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 起）。 类型：时间戳 ** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) ** 请求中指定的不透明字符串。 类型：字符串 长度限制：最小长度为 1。长度上限为 64。 模式：`.+` ** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) ** 一个布尔值，如果设为 true，则指示文件系统已加密。 类型：布尔值 ** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) ** EFS 文件系统的 Amazon 资源名称（ARN），采用 `arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id ` 格式。使用示例数据的示例：`arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567` 类型：字符串 ** [FileSystemId](#API_UpdateFileSystem_ResponseSyntax) ** 文件系统 ID，由 Amazon EFS 分配。 类型：字符串 长度限制：最大长度为 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [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` 的文件系统有效。 类型：双精度 有效范围：最小值为 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 的吞吐量限制而无法更改吞吐量模式或预配置吞吐量 MiB/s ，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：400 ** TooManyRequests ** 如果在更改吞吐量模式或降低预配置吞吐量值之前没有等待至少 24 小时，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：429 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem) + [AWS Python 软件开发工具包](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 的吞吐量限制而无法更改吞吐量模式或预配置吞吐量 MiB/s ，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：400 ** TooManyRequests ** 如果在更改吞吐量模式或降低预配置吞吐量值之前没有等待至少 24 小时，则返回。 ** ErrorCode ** 错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。 ** Message ** 错误消息包含错误条件的常规描述 (英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件，简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。 HTTP 状态代码：429 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS 适用于 Java 的 SDK V2](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection) + [AWS Python 软件开发工具包](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)