Esempi di utilizzo di Amazon Data Lifecycle Manager con la AWS CLI - AWS Command Line Interface
Operazioni

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

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

Le operazioni 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, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

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

Per 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

Per eliminare una policy per il ciclo di vita dei dati

Nell’esempio seguente viene eliminata 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

Nell’esempio seguente get-lifecycle-policy 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 in AWS CLI Command Reference.

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

AWS CLI

Esempio 1: abilitare una policy del ciclo di vita

Nell’esempio seguente update-lifecycle-policy elimina la policy sul ciclo di vita specificata.

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

Esempio 2: disabilitare una policy del ciclo di vita

Nell’esempio seguente update-lifecycle-policy elimina la policy sul ciclo di vita specificata.

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

Esempio 3: 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"
        }
    ]
}