

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

# DestinationToCreate
<a name="API_DestinationToCreate"></a>

レプリケーション設定の新規または既存のデスティネーションファイルシステムについて説明します。
+ 新しいファイルシステムにレプリケートする場合は、送信先ファイルシステムのファイルシステム ID を指定しないでください。Amazon EFS は、新しい空のファイルシステムを作成します。1 ゾーンストレージの場合は、ファイルシステムを作成するアベイラビリティーゾーンを指定します。デフォルトの KMS キー以外の AWS Key Management Service キーを使用するには、使用するキーを指定します。詳細については、「[Amazon EFS ユーザーガイド](https://docs.aws.amazon.com/efs/latest/ug/create-replication.html)」の「*新しい Amazon EFS ファイルシステムへのレプリケーションの設定*」を参照してください。
**注記**  
ファイルシステムが作成された後は、KMS キーを変更したり、パフォーマンスモードを変更したりすることはできません。
+ ソースファイルシステムと同じアカウントにある既存のファイルシステムにレプリケートする場合は、送信先ファイルシステムの ID または Amazon リソースネーム (ARN) を指定する必要があります。送信先ファイルシステムのレプリケーション上書き保護を無効にする必要があります。詳細については、「*Amazon EFS ユーザーガイド*」の「[既存のファイルシステムへのレプリケーション](https://docs.aws.amazon.com/efs/latest/ug/efs-replication#replicate-existing-destination)」を参照してください。
+ ファイルシステムをソースファイルシステムとは異なるアカウントにあるファイルシステムにレプリケートする場合 (クロスアカウントレプリケーション）、ファイルシステムの ARN と、Amazon EFS が送信先アカウントでレプリケーションを実行できるようにする IAM ロールを指定する必要があります。送信先ファイルシステムのレプリケーション上書き保護を無効にする必要があります。詳細については、「*Amazon EFS ユーザーガイド*」の「[AWS アカウント 間のレプリケーション](https://docs.aws.amazon.com/efs/latest/ug/cross-account-replication.html)」を参照してください。

## 内容
<a name="API_DestinationToCreate_Contents"></a>

 ** AvailabilityZoneName **   <a name="efs-Type-DestinationToCreate-AvailabilityZoneName"></a>
1 ゾーンストレージを使用するファイルシステムを作成するには、デスティネーションファイルシステムを作成するアベイラビリティーゾーンの名前を指定します。  
型: 文字列  
長さの制限: 最小長は 1 です。最大長 64  
パターン: `.+`   
必須: いいえ

 ** FileSystemId **   <a name="efs-Type-DestinationToCreate-FileSystemId"></a>
送信先に使用するファイルシステムの ID または ARN。クロスアカウントレプリケーションの場合、これは ARN である必要があります。ファイルシステムのレプリケーション上書きレプリケーションを無効にする必要があります。ID または ARN が指定されていない場合は、新しいファイルシステムが作成されます。  
既存のファイルシステムへのレプリケーションを最初に設定すると、Amazon EFS はソースファイルシステムのデータと一致するように、送信先ファイルシステムにデータを書き込むか、送信先ファイルシステムから既存のデータを削除します。送信先ファイルシステムのデータを変更しない場合は、代わりに新しいファイルシステムにレプリケートする必要があります。詳細については、「[https://docs.aws.amazon.com/efs/latest/ug/create-replication.html](https://docs.aws.amazon.com/efs/latest/ug/create-replication.html)」を参照してください。
型: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`   
必須: いいえ

 ** KmsKeyId **   <a name="efs-Type-DestinationToCreate-KmsKeyId"></a>
デスティネーションファイルシステムの暗号化に使用する 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 **   <a name="efs-Type-DestinationToCreate-Region"></a>
リージョンストレージを使用するファイルシステムを作成するには、デスティネーションファイルシステムを作成する AWS リージョン を指定します。リージョンは、ソースファイルシステムを所有する AWS アカウント に対して有効にする必要があります。詳細については、「**AWS 全般のリファレンスガイド」の「[AWS リージョンの管理](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)」を参照してください。  
型: 文字列  
長さの制限: 最小長は 1 です。最大長 64  
パターン: `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`   
必須: いいえ

 ** RoleArn **   <a name="efs-Type-DestinationToCreate-RoleArn"></a>
Amazon EFS が代わりにレプリケーションを実行できるようにするソースアカウントの IAM ロールの Amazon リソースネーム (ARN)。これは、同じアカウントレプリケーションの場合はオプションで、クロスアカウントレプリケーションの場合は必須です。  
型: 文字列  
長さの制約: 最大長は 2,048 です。  
パターン: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
必須: いいえ

## 以下の資料も参照してください。
<a name="API_DestinationToCreate_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DestinationToCreate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DestinationToCreate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DestinationToCreate) 