DestinationToCreate - Amazon Elastic File System

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

DestinationToCreate

レプリケーション設定の新規または既存のデスティネーションファイルシステムについて説明します。

  • 新しいファイルシステムにレプリケートする場合は、送信先ファイルシステムのファイルシステム ID を指定しないでください。Amazon EFS は、新しい空のファイルシステムを作成します。1 ゾーンストレージの場合は、ファイルシステムを作成するアベイラビリティーゾーンを指定します。デフォルトの KMS AWS Key Management Service キー以外の キーを使用するには、それを指定します。詳細については、「Amazon EFS ユーザーガイド」の「新しい Amazon EFS ファイルシステムへのレプリケーションの設定」を参照してください。 EFS

    注記

    ファイルシステムの作成後は、KMS キーまたはパフォーマンスモードを変更することはできません。

  • ソースファイルシステムと同じアカウントにある既存のファイルシステムにレプリケートする場合は、レプリケート先のファイルシステムの ID または Amazon リソースネーム (ARN) を指定する必要があります。ファイルシステムのレプリケーション上書き保護を無効にする必要があります。詳細については、「Amazon EFS ユーザーガイド」の「既存のファイルシステムへのレプリケーション」を参照してください。 EFS

  • ファイルシステムをソースファイルシステムとは異なるアカウントにあるファイルシステムにレプリケートする場合 (クロスアカウントレプリケーション)、ファイルシステムの ARN と、Amazon EFS がレプリケート先アカウントでレプリケーションを実行できるようにする IAM ロールを指定する必要があります。ファイルシステムのレプリケーション上書き保護を無効にする必要があります。詳細については、「Amazon EFS ユーザーガイド」の「レプリケーション AWS アカウント」を参照してください。 EFS

内容

AvailabilityZoneName

1 ゾーンストレージを使用するファイルシステムを作成するには、デスティネーションファイルシステムを作成するアベイラビリティーゾーンの名前を指定します。

タイプ: 文字列

長さの制約: 最小長は 1 です。最大長 64

パターン: .+

必須: いいえ

FileSystemId

送信先に使用するファイルシステムの ID または ARN。クロスアカウントレプリケーションの場合、これは ARN である必要があります。ファイルシステムのレプリケーション上書きレプリケーションを無効にする必要があります。ID または ARN が指定されていない場合は、新しいファイルシステムが作成されます。

タイプ: 文字列

長さの制約: 最大長は 128 です。

Pattern: ^(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)。

タイプ: 文字列

長さの制約: 最大長は 2,048 です。

パターン: ^([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

Amazon EFS が代わりにレプリケーションを実行できるようにする、ソースアカウントの IAM ロールの Amazon リソースネーム (ARN)。これは、同じアカウントのレプリケーションではオプションであり、クロスアカウントのレプリケーションでは必須です。

タイプ: 文字列

長さの制約: 最大長は 2,048 です。

パターン: arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

必須: いいえ

以下の資料も参照してください。

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。