CreateReplicationConfiguration
既存の EFS ファイルシステムを新しい読み取り専用ファイルシステムにレプリケートするレプリケーション設定を作成します。詳細については、「Amazon EFS ユーザーガイド」の「Amazon EFS レプリケーション」を参照してください。レプリケーション設定では、以下を指定します。
-
ソースファイルシステム - レプリケートしたい EFS ファイルシステム。ソースファイルシステムを既存のレプリケーション設定のデスティネーションファイルシステムにすることはできません。
-
AWS リージョン - デスティネーションファイルシステムが作成される AWS リージョン。Amazon EFS レプリケーションは、EFS を利用できるすべての AWS リージョン で利用できます。リージョンを有効にする必要があります。詳細については、「AWS 全般のリファレンスガイド」の「AWS リージョンの管理」を参照してください。
-
デスティネーションファイルシステムの設定 - ソースファイルシステムのレプリケーション先となるデスティネーションファイルシステムの設定。1 つのレプリケーション設定にはデスティネーションファイルシステムは 1 つしか存在できません。
レプリケーション設定のパラメータには以下が含まれます。
-
ファイルシステム ID — レプリケーションのデスティネーションファイルシステムの ID。ID を指定しない場合、EFS はデフォルト設定で新しいファイルシステムを作成します。既存のファイルシステムの場合、ファイルシステムのレプリケーション上書き保護を無効にする必要があります。詳細については、「既存のファイルシステムへのレプリケーション」を参照してください。
-
アベイラビリティーゾーン - デスティネーションファイルシステムで 1 ゾーンストレージを使用する場合は、ファイルシステムを作成するアベイラビリティーゾーンを指定する必要があります。詳細については、「Amazon EFS ユーザーガイド」の「ファイルシステムのタイプ」を参照してください。
-
暗号化 — すべてのデスティネーションファイルシステムは、保存時の暗号化を有効にして作成されます。デスティネーションファイルシステムを暗号化するために使用する AWS Key Management Service (AWS KMS) キーを指定できます。KMS キーを指定しない場合、Amazon EFS のサービスマネージド KMS キーが使用されます。
注記
ファイルシステムが作成された後は、KMS キーを変更することはできません。
-
新しいデスティネーションファイルシステムの場合、以下のプロパティがデフォルトで設定されます。
-
パフォーマンスモード - デスティネーションファイルシステムのパフォーマンスモードは、デスティネーションファイルシステムが EFS 1 ゾーンストレージを使用している場合を除き、ソースファイルシステムのパフォーマンスモードと一致します。その場合は、汎用パフォーマンスモードが使用されます。パフォーマンスモードは変更できません。
-
スループットモード - デスティネーションファイルシステムのスループットモードがソースファイルシステムのスループットモードと一致します。ファイルシステムの作成後、スループットモードを変更できます。
-
ライフサイクル管理 - ライフサイクル管理は、デスティネーションファイルシステムでは有効にされません。デスティネーションファイルシステムの作成後、ライフサイクル管理を有効にできます。
-
自動バックアップ - 毎日の自動バックアップがデスティネーションファイルシステムで有効になっています。ファイルシステムの作成後、この設定を変更できます。
詳細については、「Amazon EFS ユーザーガイド」の「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"
}
]
}URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- SourceFileSystemId
-
レプリケートする Amazon EFS ファイルシステムを指定します。このファイルシステムは、別のレプリケーション設定で既にソースまたはデスティネーションファイルシステムになっていることはできません。
長さの制限：最大長は 128 です。
Pattern:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$必須: はい
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- Destinations
-
送信先設定オブジェクトの配列です。サポートされるデスティネーション設定オブジェクトは 1 つだけです。
型: DestinationToCreate オブジェクトの配列
必須: はい
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"Region": "string",
"Status": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemRegion": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- CreationTime
-
レプリケーション設定の作成日を記述します。
型: タイムスタンプ
- Destinations
-
送信先オブジェクトの配列。サポートされているデスティネーションオブジェクトは 1 つだけです。
型: Destination オブジェクトの配列
- OriginalSourceFileSystemArn
-
レプリケーション設定の元のソース EFS ファイルシステムの Amazon リソースネーム (ARN)。
型: 文字列
- SourceFileSystemArn
-
レプリケーション設定内の現在のソースファイルシステムの Amazon リソースネーム (ARN)。
型: 文字列
- SourceFileSystemId
-
レプリケートされたソースの Amazon EFS ファイルシステムの ID。
型: 文字列
長さの制限：最大長は 128 です。
Pattern:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$ - SourceFileSystemRegion
-
ソースの EFS ファイルシステムがある AWS リージョン。
型: 文字列
長さの制限：最小長は 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
-
AWS アカウント がアカウントごとに許可されるファイルシステムの最大数をすでに作成している場合に返されます。
HTTP ステータスコード: 403
- FileSystemNotFound
-
指定された
FileSystemIdの値がリクエスタの AWS アカウント に存在しない場合に返されます。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
-
AWS Backup のサービスがリクエストされた AWS リージョン で利用できない場合に返されます。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
