本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateReplicationConfiguration
创建复制配置，将现有 EFS 文件系统复制到新的只读文件系统。有关更多信息，请参阅 Amazon EFS 用户指南中的亚马逊 EFS 复制。复制配置指定了以下内容：
-
源文件系统-要复制的现有 EFS 文件系统。在现有复制配置中，源文件系统不能成为目标文件系统。
-
目标文件系统配置-要将源文件系统复制到的目标文件系统的配置。复制配置中只能有一个目标文件系统。目标文件系统配置由以下属性组成：
-
Amazon Web Services 区域-Amazon Web Services 区域 在其中创建目标文件系统。Amazon EFS 复制功能适用于所有Amazon Web Services 区域可用 EFS 的地方。要在默认禁用的区域中使用 EFS 复制，必须先选择加入该区域。有关更多信息，请参阅《Amazon通用参考参考指南》Amazon Web Services 区域中的 “管理”
-
可用区-如果您希望目标文件系统使用 EFS One Zone 可用性和持久性，则必须指定要在其中创建文件系统的可用区。有关 EFS 存储类的更多信息，请参阅 Amazon EFS 用户指南中的 Amazon EFS 存储类别。
-
加密-所有目标文件系统都是在启用静态加密的情况下创建的。您可以指定用于加密目标文件系统的 Amazon Key Management Service (Amazon KMS) 密钥。如果您未指定 KMS 密钥，则使用您的 Amazon EFS 服务托管 KMS 密钥。
注意
创建文件系统后，您无法更改 KMS 密钥。
-
默认情况下，会设置以下属性：
-
性能模式-目标文件系统的性能模式与源文件系统的性能模式相匹配，除非目标文件系统使用 EFS One Zone 存储。在这种情况下，将使用通用性能模式。性能模式无法更改。
-
吞吐量模式-目标文件系统的吞吐量模式与源文件系统的吞吐量模式相匹配。创建文件系统后，您可以修改吞吐量模式。
默认情况下，以下属性处于关闭状态：
-
生命周期管理-目标文件系统未启用 EFS 生命周期管理和 EFS 智能分层。创建目标文件系统后，您可以启用 EFS 生命周期管理和 EFS 智能分层。
-
自动备份-在目标文件系统上启用每日自动备份。创建文件系统后，您可以更改此设置。
有关更多信息，请参阅 Amazon EFS 用户指南中的亚马逊 EFS 复制。
请求语法
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string",
"KmsKeyId": "string",
"Region": "string"
}
]
}URI 请求参数
请求使用以下 URI 参数。
- SourceFileSystemId
-
指定您要复制的 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
-
目标配置对象的数组。仅支持一个目标配置对象。
类型：DestinationToCreate 对象数组
必需：是
响应语法
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"Region": "string",
"Status": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemRegion": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- CreationTime
-
描述复制配置的创建时间。
类型：时间戳
- Destinations
-
目标对象数组。仅支持一个目标对象。
类型：Destination 对象数组
- OriginalSourceFileSystemArn
-
复制配置中原始源 Amazon EFS 文件系统的亚马逊资源名称 (ARN)。
类型：字符串
- SourceFileSystemArn
-
复制配置中当前源文件系统的亚马逊资源名称 (ARN)。
类型：字符串
- SourceFileSystemId
-
正在复制的源 Amazon EFS 文件系统的 ID。
类型：字符串
长度约束：最大长度为 128。
模式：
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$ - SourceFileSystemRegion
-
源 Amazon EFS 文件系统所在的。Amazon Web Services 区域
类型：字符串
长度限制：最小长度为 1。最大长度为 64。
模式：
^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$
错误
- BadRequest
-
如果请求格式错误或包含错误（例如参数值无效或缺少必填参数），则返回。
HTTP 状态代码：400
- FileSystemLimitExceeded
-
如果Amazon Web Services 账户已经创建了每个账户允许的最大文件系统数，则返回。
HTTP 状态代码：403
- FileSystemNotFound
-
如果请求者的指定
FileSystemId值不存在，则返回。Amazon Web Services 账户HTTP 状态代码：404
- IncorrectFileSystemLifeCycleState
-
如果文件系统的生命周期状态不是 “可用”，则返回。
HTTP 状态代码：409
- InsufficientThroughputCapacity
-
如果没有足够的容量来配置额外的吞吐量，则返回。当您尝试在预配置吞吐量模式下创建文件系统、尝试增加现有文件系统的预配置吞吐量或尝试将现有文件系统从突增吞吐量模式更改为预配置吞吐量模式时，可能会返回此值。请稍后重试。
HTTP 状态代码：503
- InternalServerError
-
如果服务器端发生错误，则返回。
HTTP 状态代码：500
- ReplicationNotFound
-
如果指定的文件系统没有复制配置，则返回。
HTTP 状态代码：404
- ThroughputLimitExceeded
-
如果由于已达到 1024 MiB/s 的吞吐量限制而无法更改吞吐量模式或预配置吞吐量，则返回。
HTTP 状态代码：400
- UnsupportedAvailabilityZone
-
如果请求的 Amazon EFS 功能在指定的可用区域中不可用，则返回。
HTTP 状态代码：400
- ValidationException
-
如果请求所在的Amazon Backup服务不可用Amazon Web Services 区域，则返回。
HTTP 状态代码：400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：