本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 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)