本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateReplicationConfiguration
创建复制配置,该配置将现有 EFS 文件系统复制到新的只读文件系统。有关更多信息,请参阅 。Amazon EFS 复制中的Amazon EFS 用户指南. 复制配置可指定以下各项内容:
-
源文件系统-要复制的现有 EFS 文件系统。在现有复制配置中,源文件系统不能是目标文件系统。
-
目标文件系统配置-将向其复制源文件系统的目标文件系统的配置。复制配置中只能有一个目标文件系统。目标文件系统配置包括以下属性:
-
Amazon Web Services 区域 -该Amazon Web Services 区域在其中创建了目标文件系统。Amazon EFS 复制功能在所有Amazon Web Services 区域Amazon EFS 可用,除非洲(开普敦)、亚太地区(香港)、亚太地区(雅加达)、欧洲(米兰)和中东(巴林)以外的区域。
-
可用区-如果您希望目标文件系统使用 EFS One Zone Zone 可用性和持久性,则必须指定可用区以在中创建文件系统。有关 EFS 存储类别的更多信息,请参阅Amazon EFS 存储类中的Amazon EFS 用户指南.
-
加密-所有目标文件系统都是在启用静态加密的情况下创建的。您可以指定Amazon Key Management Service(Amazon KMS) 用于加密目标文件系统的密钥。如果您不指定 KMS 密钥,将使用 Amazon EFS 的服务托管式 KMS 密钥。
注意 创建文件系统后,您无法更改 KMS 密钥。
-
默认情况下设置以下属性:
-
性能模式-除非目标文件系统使用 EFS One Zone Zone 存储,否则目标文件系统的性能模式与源文件系统的性能模式匹配。在这种情况下,使用通用性能模式。无法对性能模式进行更改。
-
吞吐量模式-默认情况下,目标文件系统使用突发吞吐量模式。创建文件系统后,您可以修改吞吐量模式。
默认情况下,以下属性处于关闭状态:
-
生命周期管理-目标文件系统上未启用 EFS 生命周期管理和 EFS 智能分层。创建目标文件系统后,您可以启用 EFS 生命周期管理和 EFS 智能分层。
-
自动备份-目标文件系统未启用自动每日备份。创建文件系统后,您可以更改此设置。
有关更多信息,请参阅 。Amazon EFS 复制中的Amazon 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 文件系统的 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
-
这些区域有:Amazon Web Services 区域源 Amazon EFS 文件系统所在的位置。
类型: 字符串
长度约束:最小长度为 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 的更多信息,请参阅以下内容: