DestinationToCreate - Amazon Elastic File System

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

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,请参阅以下内容: