Exemples d’utilisation de l’AWS CLI avec Amazon Data Lifecycle Manager - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec Amazon Data Lifecycle Manager

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec Amazon Data Lifecycle Manager.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser create-default-role.

AWS CLI

Pour créer le rôle IAM requis pour Amazon DLM

L’exemple dlm create-default-role suivant crée le rôle par défaut AWSDataLifecycleManagerDefaultRole pour gérer les instantanés.

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

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Rôles de service par défaut pour Amazon Data Lifecycle Manager dans le Guide de l’utilisateur Amazon Elastic Compute Cloud.

  • Pour plus de détails sur l’API, consultez CreateDefaultRole dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-lifecycle-policy.

AWS CLI

Pour créer une politique de cycle de vie

L’exemple create-lifecycle-policy suivant crée une politique de cycle de vie qui génère un instantané quotidien des volumes à l’heure spécifiée. Les balises spécifiées sont ajoutées aux instantanés. Les balises sont également copiées depuis le volume et ajoutées aux instantanés. Si la création d’un nouvel instantané dépasse le nombre maximum spécifié, l’instantané le plus ancien est supprimé.

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

Contenu de 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
            }
        }
    ]
}

Sortie :

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

  • Pour plus de détails sur l’API, consultez CreateLifecyclePolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-lifecycle-policy.

AWS CLI

Pour supprimer une politique de cycle de vie

L’exemple suivant supprime la politique de cycle de vie spécifiée :

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

  • Pour plus de détails sur l’API, consultez DeleteLifecyclePolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-lifecycle-policies.

AWS CLI

Pour obtenir un récapitulatif de vos politiques de cycle de vie

L’exemple get-lifecycle-policies suivant répertorie toutes vos politiques de cycle de vie.

aws dlm get-lifecycle-policies

Sortie :

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

  • Pour plus de détails sur l’API, consultez GetLifecyclePolicies dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-lifecycle-policy.

AWS CLI

Pour décrire une politique de cycle de vie

L’exemple get-lifecycle-policy suivant affiche les informations sur la politique de cycle de vie spécifiée.

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

Sortie :

{
    "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
                  }
              }
            ]
        }
    }
}

  • Pour plus de détails sur l’API, consultez GetLifecyclePolicy dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-lifecycle-policy.

AWS CLI

Exemple 1 : pour activer une politique de cycle de vie

L’exemple update-lifecycle-policy suivant active la politique de cycle de vie spécifiée.

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

Exemple 2 : pour désactiver une politique de cycle de vie

L’exemple update-lifecycle-policy suivant désactive la politique de cycle de vie spécifiée.

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

Exemple 3 : pour mettre à jour les informations d’une politique de cycle de vie

L’exemple update-lifecycle-policy suivant met à jour les balises cibles pour la politique de cycle de vie spécifiée.

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

Contenu de policyDetails.json. Les autres informations non référencées dans ce fichier ne sont pas modifiées par la commande.

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

  • Pour plus de détails sur l’API, consultez UpdateLifecyclePolicy dans la Référence des commandes de l’AWS CLI.