Exemplos do Amazon Data Lifecycle Manager usando a AWS CLI - AWS Command Line Interface
Ações

Exemplos do Amazon Data Lifecycle Manager usando a AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a AWS Command Line Interface com o Amazon Data Lifecycle Manager.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar create-default-role.

AWS CLI

Para criar o perfil do IAM necessário para o Amazon DLM

O exemplo dlm create-default-role a seguir cria a função padrão da AWS DataLifecycleManagerDefaultRole para gerenciar snapshots.

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

Este comando não produz saída.

Para obter mais informações, consulte Perfis de serviço padrão para o Amazon Data Lifecycle Manager no Guia do usuário do Amazon Elastic Compute Cloud.

  • Para ver detalhes da API, consulte CreateDefaultRole na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar create-lifecycle-policy.

AWS CLI

Para criar uma política de ciclo de vida

O exemplo create-lifecycle-policy a seguir cria uma política de ciclo de vida que cria um snapshot diário dos volumes no horário especificado. As tags especificadas são adicionadas aos snapshots, e as tags também são copiadas do volume e adicionadas aos snapshots. Se a criação de um novo snapshot exceder a contagem máxima especificada, o snapshot mais antigo será excluído.

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

Conteúdo 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
            }
        }
    ]
}

Saída:

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

O código de exemplo a seguir mostra como usar delete-lifecycle-policy.

AWS CLI

Para excluir uma política de ciclo de vida

O exemplo a seguir exclui a política de ciclo de vida especificada:

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

O código de exemplo a seguir mostra como usar get-lifecycle-policies.

AWS CLI

Para obter um resumo de suas políticas de ciclo de vida

O exemplo get-lifecycle-policies a seguir lista todas as suas políticas de ciclo de vida.

aws dlm get-lifecycle-policies

Saída:

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

O código de exemplo a seguir mostra como usar get-lifecycle-policy.

AWS CLI

Para descrever uma política de ciclo de vida

O exemplo get-lifecycle-policy a seguir exibe os detalhes da política de ciclo de vida especificada.

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

Saída:

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

  • Para ver detalhes da API, consulte GetLifecyclePolicy na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar update-lifecycle-policy.

AWS CLI

Exemplo 1: habilitar uma política de ciclo de vida

O exemplo update-lifecycle-policy a seguir habilita a política de ciclo de vida especificada.

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

Exemplo 2: desabilitar uma política de ciclo de vida

O exemplo update-lifecycle-policy a seguir desabilita a política de ciclo de vida especificada.

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

Exemplo 3: atualizar os detalhes da política de ciclo de vida

O exemplo update-lifecycle-policy a seguir atualiza as tags de destino para a política de ciclo de vida especificada.

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

Conteúdo de policyDetails.json. Outros detalhes não referenciados neste arquivo não são alterados pelo comando.

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