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