Beispiele für die Verwendung der AWS CLI mit AWS Backup - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit AWS Backup

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit AWS Backup nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie create-backup-plan verwendet wird.

AWS CLI

So erstellen Sie einen Sicherungsplan

Im folgenden Beispiel für create-backup-plan wird der angegebene Backup-Plan mit einer Aufbewahrung von 35 Tagen erstellt.

aws backup create-backup-plan \
--backup-plan "{\"BackupPlanName\":\"Example-Backup-Plan\",\"Rules\":[{\"RuleName\":\"DailyBackups\",\"ScheduleExpression\":\"cron(0 5 ? * * *)\",\"StartWindowMinutes\":480,\"TargetBackupVaultName\":\"Default\",\"Lifecycle\":{\"DeleteAfterDays\":35}}]}"

Ausgabe:

{
    "BackupPlanId": "1fa3895c-a7f5-484a-a371-2dd6a1a9f729",
    "BackupPlanArn": "arn:aws:backup:us-west-2:123456789012:backup-plan:1fa3895c-a7f5-484a-a371-2dd6a1a9f729",
    "CreationDate": 1568928754.747,
    "VersionId": "ZjQ2ZTI5YWQtZDg5Yi00MzYzLWJmZTAtMDI1MzhlMDhjYjEz"
}

Weitere Informationen finden Sie unter Erstellen eines Backup-Plans im Entwicklerhandbuch zu AWS Backup.

Das folgende Codebeispiel zeigt, wie create-backup-vault verwendet wird.

AWS CLI

So erstellen Sie einen Backup-Tresor

Im folgenden Beispiel für create-backup-vault wird ein Backup-Tresor mit dem angegebenen Namen erstellt.

aws backup create-backup-vault
    --backup-vault-name sample-vault

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe:

{
    "BackupVaultName": "sample-vault",
    "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:sample-vault",
    "CreationDate": 1568928338.385
}

Weitere Informationen finden Sie unter Erstellen eines Backup-Tresors im Entwicklerhandbuch zu AWS Backup.

Das folgende Codebeispiel zeigt, wie get-backup-plan-from-template verwendet wird.

AWS CLI

So rufen Sie einen vorhandenen Backup-Plan aus einer Vorlage ab

Im folgenden Beispiel für get-backup-plan-from-template wird ein vorhandener Backup-Plan aus einer Vorlage abgerufen, in der ein tägliches Backup mit einer Aufbewahrung von 35 Tagen angegeben ist.

aws backup get-backup-plan-from-template \
    --backup-plan-template-id "87c0c1ef-254d-4180-8fef-2e76a2c38aaa"

Ausgabe:

{
    "BackupPlanDocument": {
        "Rules": [
            {
                "RuleName": "DailyBackups",
                "ScheduleExpression": "cron(0 5 ? * * *)",
                "StartWindowMinutes": 480,
                "Lifecycle": {
                    "DeleteAfterDays": 35
                }
            }
        ]
    }
}

Weitere Informationen finden Sie unter Erstellen eines Backup-Plans im Entwicklerhandbuch zu AWS Backup.

Das folgende Codebeispiel zeigt, wie get-backup-plan verwendet wird.

AWS CLI

So rufen Sie die Details eines Backup-Plans ab

Im folgenden Beispiel für get-backup-plan werden die Details des angegebenen Backup-Plans angezeigt.

aws backup get-backup-plan \
    --backup-plan-id "fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5"

Ausgabe:

{
    "BackupPlan": {
        "BackupPlanName": "Example-Backup-Plan",
        "Rules": [
            {
                "RuleName": "DailyBackups",
                "TargetBackupVaultName": "Default",
                "ScheduleExpression": "cron(0 5 ? * * *)",
                "StartWindowMinutes": 480,
                "CompletionWindowMinutes": 10080,
                "Lifecycle": {
                    "DeleteAfterDays": 35
                },
                "RuleId": "70e0ccdc-e9df-4e83-82ad-c1e5a9471cc3"
            }
        ]
    },
    "BackupPlanId": "fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5",
    "BackupPlanArn": "arn:aws:backup:us-west-2:123456789012:backup-plan:fcbf5d8f-bd77-4f3a-9c97-f24fb3d373a5",
    "VersionId": "NjQ2ZTZkODktMGVhNy00MmQ0LWE4YjktZTkwNTQ3OTkyYTcw",
    "CreationDate": 1568926091.57
}

Weitere Informationen finden Sie unter Erstellen eines Backup-Plans im Entwicklerhandbuch zu AWS Backup.

  • API-Details finden Sie unter GetBackupPlan in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-backup-jobs verwendet wird.

AWS CLI

Beispiel 1: So listen Sie alle Backup-Aufträge auf

Im folgenden Beispiel für list-backup-jobs werden Metadaten zu den Backup-Aufträgen in Ihrem AWS-Konto zurückgegeben.

aws backup list-backup-jobs

Ausgabe:

{
    "BackupJobs": [
        {
            "BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "BackupVaultName": "Default",
            "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default",
            "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-12345678901234567",
            "CreationDate": 1600721892.929,
            "State": "CREATED",
            "PercentDone": "0.0",
            "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole",
            "StartBy": 1600725492.929,
            "ResourceType": "EC2"
        },
        {
            "BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "BackupVaultName": "Default",
            "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default",
            "RecoveryPointArn": "arn:aws:backup:us-west-2:123456789012:recovery-point:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "ResourceArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-12345678",
            "CreationDate": 1600721724.77,
            "CompletionDate": 1600721744.488,
            "State": "COMPLETED",
            "PercentDone": "100.0",
            "BackupSizeInBytes": 71,
            "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole",
            "StartBy": 1600725324.77,
            "ResourceType": "EFS"
        }
    ]
}

Weitere Informationen finden Sie unter Erstellen eines Backups im Entwicklerhandbuch zu AWS Backup.

Beispiel 2: So listen Sie abgeschlossene Backup-Aufträge auf

Im folgenden Beispiel für list-backup-jobs werden Metadaten zu den abgeschlossenen Backup-Aufträgen in Ihrem AWS-Konto zurückgegeben.

aws backup list-backup-jobs \
    --by-state COMPLETED

Ausgabe:

{
    "BackupJobs": [
        {
            "BackupJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "BackupVaultName": "Default",
            "BackupVaultArn": "arn:aws:backup:us-west-2:123456789012:backup-vault:Default",
            "RecoveryPointArn": "arn:aws:backup:us-west-2:123456789012:recovery-point:a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "ResourceArn": "arn:aws:elasticfilesystem:us-west-2:123456789012:file-system/fs-12345678",
            "CreationDate": 1600721724.77,
            "CompletionDate": 1600721744.488,
            "State": "COMPLETED",
            "PercentDone": "100.0",
            "BackupSizeInBytes": 71,
            "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole",
            "StartBy": 1600725324.77,
            "ResourceType": "EFS"
        }
    ]
}

Weitere Informationen finden Sie unter Erstellen eines Backups im Entwicklerhandbuch zu AWS Backup.

  • API-Details finden Sie unter ListBackupJobs in der AWS CLI-Befehlsreferenz.