本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
DestinationToCreate
描述复制配置的新或现有的目标文件系统。
-
如果要复制到新的文件系统,请不要为目标文件系统指定文件系统 ID。Amazon EFS 创建了一个新的空文件系统。对于单区域存储,请指定要在其中创建文件系统的可用区。要使用默认 KMS AWS Key Management Service 密钥以外的密钥,请指定该密钥。有关更多信息,请参阅 Amazon EFS 用户指南中的配置向新 Amazon EFS 文件系统的复制。
注意
创建文件系统后,您无法更改 KMS 密钥或性能模式。
-
如果您要复制到与源文件系统同一个账户的现有文件系统,则需要提供要复制到的文件系统的 ID 或 Amazon 资源名称 (ARN)。必须禁用文件系统的复制覆盖保护。有关更多信息,请参阅 Amazon EFS 用户指南中的复制到现有文件系统。
-
如果您要将文件系统复制到与源文件系统不同的账户中的文件系统(跨账户复制),则需要提供文件系统的 ARN 和允许 Amazon EFS 对目标账户执行复制的 IAM 角色。必须禁用文件系统的复制覆盖保护。有关更多信息,请参阅 Amazon EFS 用户指南 AWS 账户中的跨复制。
内容
- AvailabilityZoneName
-
要创建使用单区存储的文件系统,请指定要在其中创建目标文件系统的可用区的名称。
类型:字符串
长度限制:长度下限为 1。长度上限为 64。
模式:
.+
必需:否
- FileSystemId
-
要用于目标的文件系统的 ID 或 ARN。对于跨账户复制,这必须是 ARN。必须禁用文件系统的复制覆盖复制功能。如果未指定 ID 或 ARN,则会创建一个新的文件系统。
类型:字符串
长度限制:最大长度为 128。
模式:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$
必需:否
- KmsKeyId
-
指定要用于加密目标文件系统的 AWS Key Management Service (AWS KMS) 密钥。如果您不指定 KMS 密钥,Amazon EFS 将使用 Amazon EFS 的默认 KMS 密钥
/aws/elasticfilesystem
。此 ID 可以是下列格式之一:-
键 ID - 键的唯一标识符,例如
1234abcd-12ab-34cd-56ef-1234567890ab
。 -
ARN-例如,密钥的 ARN。
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
-
键别名 - 之前为键创建的显示名称,例如
alias/projectKey1
。 -
键别名 ARN - 键别名的 ARN,例如
arn:aws:kms:us-west-2:444455556666:alias/projectKey1
。
类型:字符串
长度约束:最大长度为 2048。
模式:
^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$
必需:否
-
- Region
-
要创建使用区域存储的文件系统,请指定要 AWS 区域 在其中创建目标文件系统。必须为拥有源文件系统的启用区域。 AWS 账户 有关更多信息,请参阅《 AWS 通用参考参考指南》 AWS 区域中的 “管理”。
类型:字符串
长度限制:长度下限为 1。长度上限为 64。
模式:
^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$
必需:否
- RoleArn
-
源账户中 IAM 角色的亚马逊资源名称 (ARN),该角色允许 Amazon EFS 代表其执行复制。对于同账户复制,这是可选的,对于跨账户复制,则是必需的。
类型:字符串
长度约束:最大长度为 2048。
模式:
arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+
必需:否
另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs,请参阅以下内容: