Esempi di utilizzo di Amazon Data Lifecycle Manager con la AWS CLI - Esempi di codice per SDK AWS
Azioni

Sono disponibili altri esempi per SDK AWS nel repository GitHub della documentazione degli esempi per SDK AWS.

Esempi di utilizzo di Amazon Data Lifecycle Manager con la AWS CLI

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con il Sistema di gestione del ciclo di vita dei dati Amazon (Amazon DLM).

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare create-default-role.

AWS CLI

Come creare il ruolo IAM richiesto per Amazon DLM

L’esempio dlm create-default-role seguente crea il ruolo predefinito di AWS DataLifecycleManagerDefaultRole per la gestione degli snapshot.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Ruoli di servizio predefiniti per Amazon Data Lifecycle Manager nella Guida per l’utente di Amazon Elastic Compute Cloud.

  • Per informazioni dettagliate sull’API, consulta CreateDefaultRole in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-lifecycle-policy.

AWS CLI

Come creare una policy del ciclo di vita

L’esempio create-lifecycle-policy seguente crea una policy sul ciclo di vita che genera uno snapshot giornaliero dei volumi all’ora specificata. I tag specificati vengono aggiunti alle istantanee e i tag vengono inoltre copiati dal volume e aggiunti agli snapshot. Se la creazione di un nuovo snapshot supera il numero massimo specificato, lo snapshot meno recente viene eliminato.

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

Contenuto di 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
            }
        }
    ]
}

Output:

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

L’esempio di codice seguente mostra come utilizzare delete-lifecycle-policy.

AWS CLI

Come eliminare una policy per il ciclo di vita dei dati

L’esempio seguente elimina la policy sul ciclo di vita specificata:

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

L’esempio di codice seguente mostra come utilizzare get-lifecycle-policies.

AWS CLI

Come ottenere un riepilogo delle policy sul ciclo di vita

L’esempio get-lifecycle-policies seguente elenca tutte le policy sul ciclo di vita.

aws dlm get-lifecycle-policies

Output:

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

  • Per informazioni dettagliate sull’API, consulta GetLifecyclePolicies in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-lifecycle-policy.

AWS CLI

Come eliminare una policy sul ciclo di vita

L’esempio get-lifecycle-policy seguente mostra i dettagli della policy sul ciclo di vita specificata.

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

Output:

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

  • Per informazioni dettagliate sull’API, consulta GetLifecyclePolicy nella documentazione dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare update-lifecycle-policy.

AWS CLI

Esempio 1: come abilitare una policy del ciclo di vita

L’esempio update-lifecycle-policy seguente abilita la policy sul ciclo di vita specificata.

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

Esempio 2: come disabilitare una policy del ciclo di vita

L’esempio update-lifecycle-policy seguente disabilita la policy sul ciclo di vita specificata.

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

Esempio 3: come aggiornare i dettagli della policy sul ciclo di vita

L’esempio update-lifecycle-policy seguente aggiorna i tag di destinazione per la policy del ciclo di vita specificata.

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

Contenuto di policyDetails.json. Gli altri dettagli non citati in questo file non vengono modificati dal comando.

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