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

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

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 funções de serviço individuais, é possível ver as ações no contexto em seus cenários relacionados.

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

Tópicos

Ações

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

AWS CLI

Para criar a IAM função necessária para a 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 Funções de serviço padrão para o Amazon Data Lifecycle Manager no Guia do usuário do Amazon Elastic Compute Cloud.

  • Para API obter detalhes, consulte CreateDefaultRolena 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 create-lifecycle-policy exemplo a seguir cria uma política de ciclo de vida que cria um instantâneo diário dos volumes no horário especificado. As tags especificadas são adicionadas aos instantâneos, e as tags também são copiadas do volume e adicionadas aos instantâneos. Se a criação de um novo instantâneo exceder a contagem máxima especificada, o instantâneo 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 get-lifecycle-policies exemplo 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 get-lifecycle-policy exemplo a seguir exibe 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
                  }
              }
            ]
        }
    }
}

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

AWS CLI

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

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

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

Exemplo 2: Para desativar uma política de ciclo de vida

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

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

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

O update-lifecycle-policy exemplo 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"
        }
    ]
}