CreateReplicationConfiguration - Amazon Elastic File System
请求语法URI 请求参数请求体响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

CreateReplicationConfiguration

为新的或现有 EFS 文件系统创建复制配置。有关更多信息，请参阅《Amazon EFS 用户指南》中的 Amazon EFS 复制。此复制配置指定以下内容：

  • 源文件系统-要复制的 EFS 文件系统。

  • 目标文件系统-源文件系统要复制到的目标文件系统。复制配置中只能有一个目标文件系统。

    注意

    一个文件系统只能属于一个复制配置。

    复制配置的目标参数取决于您是要复制到新文件系统还是复制到现有文件系统，以及是否要跨越复制。 Amazon Web Services 账户请参阅DestinationToCreate了解更多信息。

此操作需要 elasticfilesystem:CreateReplicationConfiguration 操作的权限。此外，还需要其他权限，具体取决于您复制文件系统的方式。有关更多信息，请参阅 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",
         "RoleArn": "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,
         "OwnerId": "string",
         "Region": "string",
         "RoleArn": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ],
   "OriginalSourceFileSystemArn": "string",
   "SourceFileSystemArn": "string",
   "SourceFileSystemId": "string",
   "SourceFileSystemOwnerId": "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})$

SourceFileSystemOwnerId

源文件系统所在的 ID。 Amazon Web Services 账户

类型：字符串

长度限制：最大长度为 14。

模式：^(\d{12})|(\d{4}-\d{4}-\d{4})$

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

另请参阅

有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：