Exemplos do Amazon Data Lifecycle Manager usando AWS CLI - AWS Exemplos de código do SDK
Ações

Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplos do Amazon Data Lifecycle Manager usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o 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 dlm create-default-role exemplo a seguir cria a função AWS DataLifecycleManagerDefaultRole padrão para gerenciar instantâneos.

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 obter detalhes da API, consulte CreateDefaultRoleem Referência de AWS CLI Comandos.

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 obter detalhes da API, consulte GetLifecyclePolicyem Referência de AWS CLI Comandos.

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