AWS re:Post Knowledge Center Feedback Survey

Help us improve the AWS re:Post Knowledge Center by sharing your feedback in a brief survey. Your input can influence how we create and update our content to better support your AWS journey.

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

所要時間3分

AWS コマンドラインインターフェイス (AWS CLI) を使用して、AWS バックアップの復旧ポイントから Amazon Elastic File System (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 ファイルシステムの復元を実行する

$ 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"
        }

メタデータを別の 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\"]"}'

トピック: Storage
タグ: AWS Backup
言語: 日本語

AWS公式更新しました 4年前

コメントはありません

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

解決策

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

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

関連するコンテンツ