AWS CLI を使用して AWS Backup の復旧ポイントから Amazon EFS ファイルシステムを復元する方法を教えてください。

解決策

AWS Backup の復旧ポイントからの EFS ファイルシステムのインプレース復元

1.    list-backup-jobs コマンドを実行して、復元する EFS ファイルシステムの Amazon リソースネーム (ARN) を取得します。AWS Backup の復旧ポイントから EFS ファイルシステムの復元を実行するには、復旧ポイント ARN が必要です。

$ aws backup list-backup-jobs --by-resource-type EFS --region us-east-1

**メモ:**AWS CLI コマンドの実行中にエラーが発生した場合は、AWS CLI の最新バージョンを使用していることを確認してください。

2.    コマンド出力で、[RecoveryPointARN] をメモします。

{
    "BackupJobs": [
        {
            "CompletionDate": 1583305453.7,
            "BackupVaultArn": "arn:aws:backup:us-east-1:111222333444:backup-vault:Default",
            "PercentDone": "0.0",
            "RecoveryPointArn": "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347",
            "ResourceType": "EFS",
            "BackupSizeInBytes": 73,
            "State": "COMPLETED",
            "IamRoleArn": "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole",
            "ResourceArn": "arn:aws:elasticfilesystem:us-east-1:111222333444:file-system/fs-6a1dcba2",
            "BackupJobId": "721ba96d-a656-4771-a1f4-78bcd0c930f8",
            "StartBy": 1583309035.684,
            "CreationDate": 1583305435.684,
            "BackupVaultName": "Default"
        }
    ]
}

3.    start-restore-job コマンドを実行するには、EFS インスタンスを復元するための特定のメタデータを定義する必要があります。メタデータは別の JSON ファイルで定義することも、コマンド内のパラメーターとしてメタデータを定義することもできます。

メタデータを別の JSON ファイルで定義するには、次のような JSON ファイルを作成します。

{"file-system-id": "fs-6a1dcba2", "newFileSystem": "false", "Encrypted": "false", "PerformanceMode":"generalPurpose"}

次に、以下のように start-restore-job コマンドを実行します。

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole"  --metadata file://path_to_json_file

メタデータを start-restore-job コマンド内のパラメーターとして定義するには、以下の形式でコマンドを実行します。

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole" --metadata '{"file-system-id": "fs-6a1dcba2", "newFileSystem": "false", "Encrypted": "false", "PerformanceMode":"generalPurpose"}'

AWS Backup の復旧ポイントから新しい EFS ファイルシステムを復元する

1.    list-backup-jobs コマンドを実行して、復元する EFS ファイルシステムの ARN を取得します。AWS Backup の復旧ポイントから EFS ファイルシステムの復元を実行するには、復旧ポイント ARN が必要です。

$ aws backup list-backup-jobs --by-resource-type EFS --region us-east-1

2.    コマンド出力で、[RecoveryPointARN] をメモします。

{
    "BackupJobs": [
        {
            "CompletionDate": 1583305453.7,
            "BackupVaultArn": "arn:aws:backup:us-east-1:111222333444:backup-vault:Default",
            "PercentDone": "0.0",
            "RecoveryPointArn": "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347",
            "ResourceType": "EFS",
            "BackupSizeInBytes": 73,
            "State": "COMPLETED",
            "IamRoleArn": "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole",
            "ResourceArn": "arn:aws:elasticfilesystem:us-east-1:111222333444:file-system/fs-6a1dcba2",
            "BackupJobId": "721ba96d-a656-4771-a1f4-78bcd0c930f8",
            "StartBy": 1583309035.684,
            "CreationDate": 1583305435.684,
            "BackupVaultName": "Default"
        }
    ]
}

3.    新しい EFS ファイルシステムに復元するには、リクエストの一意性 (冪等性) を強制する [CreationToken] 値を生成します。[CreationToken] は任意の値にすることができます。Linux オペレーティングシステムでは、[uuid] コマンドを実行して一意の識別子を生成できます。

uuid -r

出力は、次のようなユニバーサルユニーク識別子 (UUID) です。

d0c12345-678d-4071-bf30-8e7e54ab65df

4.    start-restore-job コマンドを実行するには、EFS インスタンスを復元するための特定のメタデータを定義する必要があります。メタデータは別の JSON ファイルで定義することも、コマンド内のパラメーターとしてメタデータを定義することもできます。

メタデータを別の JSON ファイルで定義するには、次のような JSON ファイルを作成します。

メモ:[CreationToken] には、手順 3 で生成した作成トークンの値を使用します。

{"file-system-id": "fs-6a1dcba2", "Encrypted": "false", "PerformanceMode": "generalPurpose", "CreationToken": "d0c12345-678d-4071-bf30-8e7e54ab65df", "newFileSystem": "true"}

次に、以下のように start-restore-job コマンドを実行します。

メモ:[--metadata] には、前のステップで作成した JSON ファイルを入力します。

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole"  --metadata file://path_to_json_file

メタデータを start-restore-job コマンド内のパラメーターとして定義するには、以下の形式でコマンドを実行します。

メモ:[CreationToken] には、手順 3 で生成した作成トークンの値を使用します。

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole" --metadata '{"file-system-id": "fs-6a1dcba2", "newFileSystem": "true", "CreationToken": "d0c12345-678d-4071-bf30-8e7e54ab65df", "Encrypted": "false", "PerformanceMode":"generalPurpose"}'

AWS Backup の復旧ポイントからアイテムレベルの EFS ファイルシステムの復元を実行する

1.    list-backup-jobs コマンドを実行して、復元する EFS ファイルシステムの Amazon リソースネーム (ARN) を取得します。AWS Backup の復旧ポイントから EFS ファイルシステムの復元を実行するには、復旧ポイント ARN が必要です。

$ aws backup list-backup-jobs --by-resource-type EFS --region us-east-1

**メモ:**AWS CLI コマンドの実行中にエラーが発生した場合は、AWS CLI の最新バージョンを使用していることを確認してください。

2.    コマンド出力で、[RecoveryPointARN] をメモします。

{
    "BackupJobs": [
        {
            "AccountId": "686948106210",
            "BackupJobId": "261f13d0-5ede-458e-a00e-d83ed5de0afe",
            "BackupVaultName": "Default",
            "BackupVaultArn": "arn:aws:backup:us-east-1:111222333444:backup-vault:Default",
            "RecoveryPointArn": "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347",
            "ResourceArn": "arn:aws:elasticfilesystem:us-east-1:111222333444:file-system/fs-6a1dcba2",
            "CreationDate": "2021-08-23T07:52:56.652000+00:00",
            "CompletionDate": "2021-08-23T07:53:09.547000+00:00",
            "State": "COMPLETED",
            "PercentDone": "100.0",
            "BackupSizeInBytes": 75,
            "IamRoleArn": "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole",
            "StartBy": "2021-08-23T08:52:56.652000+00:00",
            "ResourceType": "EFS"
        }

3.    start-restore-job コマンドを実行するには、EFS インスタンスを復元するための特定のメタデータを定義する必要があります。メタデータは別の JSON ファイルで定義することも、コマンド内のパラメーターとしてメタデータを定義することもできます。

メタデータを別の JSON ファイルで定義するには、次のような JSON ファイルを作成します。

{"file-system-id": "fs-6a1dcba2", "newFileSystem": "false", "Encrypted": "false", "PerformanceMode":"generalPurpose", "itemsToRestore":"[\"/my.test\"]"}

次に、以下のように start-restore-job コマンドを実行します。

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole"  --metadata file://path_to_json_file

メタデータを start-restore-job コマンド内のパラメーターとして定義するには、以下の形式でコマンドを実行します。

aws backup start-restore-job --region us-east-1 --recovery-point-arn "arn:aws:backup:us-east-1:111222333444:recovery-point:123e4567-6cd9-464e-bb6b-13f70e79d347" --iam-role-arn "arn:aws:iam::111222333444:role/service-role/AWSBackupDefaultServiceRole" --metadata '{"file-system-id": "fs-6a1dcba2", "newFileSystem": "false", "Encrypted": "false", "PerformanceMode":"generalPurpose", "itemsToRestore":"[\"/my.test\"]"}'

---