Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/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.
**Topics**
+ [Ações](#actions)
## Ações
### `create-default-role`
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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/service-role.html#default-service-roles) no *Guia do usuário do Amazon Elastic Compute Cloud*.
+ Para obter detalhes da API, consulte [CreateDefaultRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/create-default-role.html)em *Referência de AWS CLI Comandos*.
### `create-lifecycle-policy`
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"
}
```
+ Para obter detalhes da API, consulte [CreateLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/create-lifecycle-policy.html)em *Referência de AWS CLI Comandos*.
### `delete-lifecycle-policy`
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
```
+ Para obter detalhes da API, consulte [DeleteLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/delete-lifecycle-policy.html)em *Referência de AWS CLI Comandos*.
### `get-lifecycle-policies`
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"
}
]
}
```
+ Para obter detalhes da API, consulte [GetLifecyclePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/get-lifecycle-policies.html)em *Referência de AWS CLI Comandos*.
### `get-lifecycle-policy`
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 [GetLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/get-lifecycle-policy.html)em *Referência de AWS CLI Comandos*.
### `update-lifecycle-policy`
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"
}
]
}
```
+ Para obter detalhes da API, consulte [UpdateLifecyclePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/dlm/update-lifecycle-policy.html)em *Referência de AWS CLI Comandos*.