Beispiele für die Verwendung der AWS CLI mit Amazon Data Lifecycle Manager - AWS Command Line Interface
Aktionen

Diese Dokumentation bezieht sich ausschließlich auf Version 1 der AWS CLI. Eine Dokumentation zu Version 2 der AWS CLI finden Sie im Benutzerhandbuch für Version 2.

Beispiele für die Verwendung der AWS CLI mit Amazon Data Lifecycle Manager

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Amazon Data Lifecycle Manager 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-default-role verwendet wird.

AWS CLI

So erstellen Sie die erforderliche IAM-Rolle für Amazon DLM

Im folgenden Beispiel für dlm create-default-role wird die Standardrolle AWSDataLifecycleManagerDefaultRole für die Verwaltung von Snapshots erstellt.

aws dlm create-default-role \
    --resource-type snapshot

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Standardservicerollen für Amazon Data Lifecycle Manager im Benutzerhandbuch zu Amazon Elastic Compute Cloud.

Das folgende Codebeispiel zeigt, wie create-lifecycle-policy verwendet wird.

AWS CLI

So erstellen Sie eine Lebenszyklusrichtlinie

Im folgenden Beispiel für create-lifecycle-policy wird eine Lebenszyklusrichtlinie aufgestellt, die einen täglichen Snapshot der Volumes zum angegebenen Zeitpunkt erstellt. Die angegebenen Tags werden den Snapshots hinzugefügt. Tags werden auch aus dem Volume kopiert und den Snapshots hinzugefügt. Wenn das Erstellen eines neuen Snapshots die angegebene maximale Anzahl überschreitet, wird der älteste Snapshot gelöscht.

aws dlm create-lifecycle-policy \
    --description "My first policy" \
    --state ENABLED \
    --execution-role-arn arn:aws:iam::12345678910:role/AWSDataLifecycleManagerDefaultRole \
    --policy-details file://policyDetails.json

Inhalt von policyDetails.json:

{
    "ResourceTypes": [
        "VOLUME"
    ],
    "TargetTags": [
        {
            "Key": "costCenter",
            "Value": "115"
        }
    ],
    "Schedules":[
        {
            "Name": "DailySnapshots",
            "CopyTags": true,
            "TagsToAdd": [
                {
                    "Key": "type",
                     "Value": "myDailySnapshot"
                }
            ],
            "CreateRule": {
                "Interval": 24,
                "IntervalUnit": "HOURS",
                "Times": [
                    "03:00"
                ]
            },
            "RetainRule": {
                "Count":5
            }
        }
    ]
}

Ausgabe:

{
    "PolicyId": "policy-0123456789abcdef0"
}

Das folgende Codebeispiel zeigt, wie delete-lifecycle-policy verwendet wird.

AWS CLI

Löschen einer Lebenszyklus-Richtlinie

Im folgenden Beispiel wird die angegebene Lebenszyklus-Richtlinie gelöscht:

aws dlm delete-lifecycle-policy --policy-id policy-0123456789abcdef0

Das folgende Codebeispiel zeigt, wie get-lifecycle-policies verwendet wird.

AWS CLI

So rufen Sie eine Zusammenfassung Ihrer Lebenszyklus-Richtlinien ab

Das folgende get-lifecycle-policies-Beispiel listet alle Ihre Lebenszyklus-Richtlinien auf.

aws dlm get-lifecycle-policies

Ausgabe:

{
    "Policies": [
        {
            "PolicyId": "policy-0123456789abcdef0",
            "Description": "My first policy",
            "State": "ENABLED"
        }
    ]
}

Das folgende Codebeispiel zeigt, wie get-lifecycle-policy verwendet wird.

AWS CLI

So beschreiben Sie eine Lebenszyklus-Richtlinie

Im folgenden Beispiel für get-lifecycle-policy werden die Details für die angegebene Lebenszyklus-Richtlinie angezeigt.

aws dlm get-lifecycle-policy \
    --policy-id policy-0123456789abcdef0

Ausgabe:

{
    "Policy": {
        "PolicyId": "policy-0123456789abcdef0",
        "Description": "My policy",
        "State": "ENABLED",
        "ExecutionRoleArn": "arn:aws:iam::123456789012:role/AWSDataLifecycleManagerDefaultRole",
        "DateCreated": "2019-08-08T17:45:42Z",
        "DateModified": "2019-08-08T17:45:42Z",
        "PolicyDetails": {
            "PolicyType": "EBS_SNAPSHOT_MANAGEMENT",
            "ResourceTypes": [
                "VOLUME"
            ],
            "TargetTags": [
              {
                  "Key": "costCenter",
                  "Value": "115"
              }
            ],
            "Schedules": [
              {
                  "Name": "DailySnapshots",
                  "CopyTags": true,
                  "TagsToAdd": [
                    {
                        "Key": "type",
                        "Value": "myDailySnapshot"
                    }
                  ],
                  "CreateRule": {
                    "Interval": 24,
                    "IntervalUnit": "HOURS",
                    "Times": [
                        "03:00"
                    ]
                  },
                  "RetainRule": {
                    "Count": 5
                  }
              }
            ]
        }
    }
}

Das folgende Codebeispiel zeigt, wie update-lifecycle-policy verwendet wird.

AWS CLI

Beispiel 1: So aktivieren Sie eine Lebenszyklus-Richtlinie

Im folgenden Beispiel für update-lifecycle-policy wird die angegebene Lebenszyklus-Richtlinie aktiviert.

aws dlm update-lifecycle-policy \
    --policy-id policy-0123456789abcdef0 \
    --state ENABLED

Beispiel 2: So deaktivieren Sie eine Lebenszyklus-Richtlinie

Im folgenden Beispiel für update-lifecycle-policy wird die angegebene Lebenszyklus-Richtlinie deaktiviert.

aws dlm update-lifecycle-policy \
    --policy-id policy-0123456789abcdef0 \
    --state DISABLED

Beispiel 3: So aktualisieren Sie die Details für die Lebenszyklus-Richtlinie

Im folgenden Beispiel für update-lifecycle-policy werden die Ziel-Tags für die angegebene Lebenszyklus-Richtlinie aktualisiert.

aws dlm update-lifecycle-policy \
    --policy-id policy-0123456789abcdef0
    --policy-details file://policyDetails.json

Inhalt von policyDetails.json. Andere Details, auf die in dieser Datei nicht verwiesen wird, werden durch den Befehl nicht geändert.

{
    "TargetTags": [
        {
            "Key": "costCenter",
            "Value": "120"
        },
        {
            "Key": "project",
            "Value": "lima"
        }
    ]
}