本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateReplicationConfiguration
创建复制配置,将现有 EFS 文件系统复制到新的只读文件系统。有关更多信息,请参阅《Amazon EFS 用户指南》中的 Amazon EFS 复制。此复制配置指定以下内容:
-
源文件系统 - 要复制的 EFS 文件系统。在现有复制配置中,源文件系统不能是目标文件系统。
-
Amazon Web Services 区域 — 目标文件系统 Amazon Web Services 区域 是在其中创建的。Amazon EFS 复制功能适用于所有 Amazon Web Services 区域 可用 EFS 的地方。必须启用区域。有关更多信息,请参阅《 Amazon 通用参考参考指南》 Amazon Web Services 区域中的 “管理”。
-
目标文件系统配置 - 要将源文件系统复制到的目标文件系统的配置。复制配置中只能有一个目标文件系统。
复制配置的参数包括:
-
文件系统 ID - 用于复制的目标文件系统的 ID。如果未提供 ID,EFS 会使用默认设置创建一个新的文件系统。对于现有文件系统,必须禁用文件系统的复制覆盖保护功能。有关更多信息,请参阅复制到现有文件系统。
-
可用区 - 如果希望目标文件系统使用单区存储,必须指定要在其中创建文件系统的可用区。有关更多信息,请参阅《Amazon EFS 用户指南》中的 EFS 文件系统类型。
-
加密 – 所有目标文件系统都是在启用静态加密的情况下创建的。您可以指定用于加密目标文件系统的 Amazon Key Management Service (Amazon KMS) 密钥。如果不指定 KMS 密钥,则使用您的 Amazon EFS 的服务托管式 KMS 密钥。
注意
创建文件系统后,无法更改 KMS 密钥。
-
对于新的目标文件系统,默认情况下会设置以下属性:
-
性能模式 – 目标文件系统的性能模式与源文件系统的性能模式相匹配,除非目标文件系统使用 EFS 单区存储。在这种情况下,将使用通用性能模式。无法更改性能模式。
-
吞吐量模式 – 目标文件系统的吞吐量模式与源文件系统的吞吐量模式相匹配。创建文件系统后,可以修改吞吐量模式。
-
生命周期管理-未在目标文件系统上启用生命周期管理。创建目标文件系统后,可以启用生命周期管理。
-
自动备份 - 在目标文件系统上启用每日自动备份。创建文件系统后,可以更改此设置。
有关更多信息,请参阅《Amazon EFS 用户指南》中的 Amazon EFS 复制。
请求语法
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
"
}
]
}
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
-
复制配置中原始源 EFS 文件系统的 Amazon 资源名称 (ARN)。
类型:字符串
- SourceFileSystemArn
-
复制配置中当前源文件系统的 Amazon 资源名称(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
-
源 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
- ConflictException
-
如果复制中的源文件系统已加密,但目标文件系统未加密,则返回此内容。
HTTP 状态代码:409
- 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 SDK 中使用此 API 的更多信息,请参阅以下内容: