

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á.

# Atribua recursos com AWS CLI
<a name="assigning-resources-json"></a>

## Filtrar por serviços ou tipos de recursos
<a name="resource-assignment-filter"></a>

A seleção de recursos é baseada em nomes de serviços e tipos de recursos. O método de seleção de recursos determina se um recurso está incluído no backup. Essa inclusão depende dos nomes dos serviços, dos tipos de recursos e das configurações de aceitação.

**Seleção por nome de serviço**  
Quando você especifica somente um nome de serviço na seleção de recursos, a inclusão do backup depende da configuração de aceitação dos tipos de recursos subjacentes. Por exemplo, com `arn:aws:ec2:*`, as instâncias do EC2 serão incluídas no backup somente se a configuração de aceitação para o tipo de recurso do EC2 estiver ativada.

**Seleção por tipo de recurso**  
Se você especificar a seleção de recursos diretamente pelo tipo de recurso, ele será incluído no backup independentemente da configuração de aceitação desse serviço específico. Por exemplo, com `arn:aws:ec2:::instance/*`, será feito backup de instâncias do EC2, independentemente da configuração de aceitação.

**Tipos de recursos compartilhados**  
Quando vários recursos compartilham o mesmo tipo de recurso, você precisa ativar as configurações de aceitação para tipos de recursos específicos ao iniciar backups.

**Example**  
Os clusters do Aurora e do RDS compartilham o formato de ARN: `arn:aws:rds:::cluster:*`. Para fazer backup dos bancos de dados do Aurora, você deve ativar a configuração de aceitação do Aurora.  
FSx e FSx para OpenZFS, compartilhe o formato ARN. `arn:aws:fsx:::file-system/*` Ative as respectivas configurações de aceitação para fazer backup desses sistemas de arquivos.

## Uso de um JSON para definir a atribuição de recursos do plano de backup
<a name="backup-resource-json"></a>

É possível definir uma atribuição de recursos em um documento JSON.

Você pode especificar condições, tags ou recursos para definir o que será incluído no seu plano de backup. Para obter mais informações para ajudar a determinar quais parâmetros incluir, consulte [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BackupSelection.html#Backup-Type-BackupSelection-ListOfTags](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BackupSelection.html#Backup-Type-BackupSelection-ListOfTags).

Esse exemplo de atribuição de recursos atribui todas as instâncias do Amazon EC2 ao plano de backup: *BACKUP-PLAN-ID*

```
{
  "BackupPlanId":"BACKUP-PLAN-ID",
  "BackupSelection":{
    "SelectionName":"resources-list-selection", 
    "IamRoleArn":"arn:aws:iam::ACCOUNT-ID:role/IAM-ROLE-ARN",
    "Resources":[
      "arn:aws:ec2:*:*:instance/*"
    ]
  }
}
```

Supondo que esse JSON esteja armazenado como `backup-selection.json`, você poderá atribuir esses recursos ao seu plano de backup usando o seguinte comando da CLI:

```
aws backup create-backup-selection --cli-input-json file://PATH-TO-FILE/backup-selection.json
```

Veja a seguir exemplos de atribuições de recursos, junto com o documento JSON correspondente. Para facilitar a leitura dessa tabela, os exemplos omitem os campos `"BackupPlanId"`, `"SelectionName"`, e `"IamRoleArn"`. O curinga `*` representa zero ou mais caracteres que não sejam espaços em branco.

**Example Exemplo: selecione todos os recursos em minha conta**  

```
{
  "BackupSelection":{
    "Resources":[
      "*"
    ]
  }
}
```

**Example Exemplo: selecione todos os recursos em minha conta, mas exclua os volumes do EBS**  

```
{
  "BackupSelection":{
    "Resources":[
      "*"
    ],
    "NotResources":[
      "arn:aws:ec2:*:*:volume/*"
    ]
  }
}
```

**Example Exemplo: selecione todos os recursos marcados com "backup":"true", mas exclua os volumes do EBS**  

```
{
  "BackupSelection":{
    "Resources":[
      "*"
    ],
    "NotResources":[
      "arn:aws:ec2:*:*:volume/*"
    ],
    "Conditions":{
      "StringEquals":[
        {
          "ConditionKey":"aws:ResourceTag/backup",
          "ConditionValue":"true"
        }
      ]
    }
  }
}
```

**Importante**  
RDS, Aurora, Neptune e DocumentDB começam com. ARNs `arn:aws:rds:` Refine sua seleção com tags e operadores condicionais caso não pretenda incluir todos esses tipos.

**Example Exemplo: selecione todos os volumes do EBS e instâncias de banco de dados do RDS marcados com "backup":"true" e "stage":"prod"**  
A aritmética booleana é semelhante à das políticas do IAM, com aquelas em "Resources" combinadas usando um OR booliano e aquelas em `"Conditions"` combinadas com um AND booliano.  
A expressão `"arn:aws:rds:*:*:db:*"` de `"Resources"` seleciona somente instâncias de banco de dados do RDS porque não há recursos do Aurora, Neptune ou DocumentDB correspondentes.  

```
{
  "BackupSelection":{
    "Resources":[
      "arn:aws:ec2:*:*:volume/*",
      "arn:aws:rds:*:*:db:*"
    ],
    "Conditions":{
      "StringEquals":[
        {
          "ConditionKey":"aws:ResourceTag/backup",
          "ConditionValue":"true"
        },
        {
          "ConditionKey":"aws:ResourceTag/stage",
          "ConditionValue":"prod"
        }
      ]
    }
  }
}
```

**Example Exemplo: selecione todos os volumes do EBS e instâncias do RDS marcados com "backup":"true", mas não com "stage":"test"**  

```
{
  "BackupSelection":{
    "Resources":[
      "arn:aws:ec2:*:*:volume/*",
      "arn:aws:rds:*:*:db:*"
    ],
    "Conditions":{
      "StringEquals":[
        {
          "ConditionKey":"aws:ResourceTag/backup",
          "ConditionValue":"true"
        }
      ],
      "StringNotEquals":[
        {
          "ConditionKey":"aws:ResourceTag/stage",
          "ConditionValue":"test"
        }
      ]
    }
  }
}
```

**Example Exemplo: selecione todos os recursos marcados com "key1" e um valor que comece com "include", mas não com "key2", e um valor que contenha a palavra "exclude"**  
Você pode usar o caractere curinga no início, no final e no meio de uma string. Observe o uso do caractere curinga (\$1) no `include*` e `*exclude*` no exemplo acima. Você também pode usar o caractere curinga no meio de uma string, conforme mostrado no exemplo anterior, `arn:aws:rds:*:*:db:*`.  

```
{
  "BackupSelection":{
    "Resources":[
      "*"
    ],
    "Conditions":{
      "StringLike":[
        {
          "ConditionKey":"aws:ResourceTag/key1",
          "ConditionValue":"include*"
        }
      ],
      "StringNotLike":[
        {
          "ConditionKey":"aws:ResourceTag/key2",
          "ConditionValue":"*exclude*"
        }
      ]
    }
  }
}
```

**Example Exemplo: selecione todos os recursos marcados com, "backup":"true" exceto sistemas de FSx arquivos e recursos do RDS, Aurora, Neptune e DocumentDB**  
Os itens em `NotResources` são combinados usando o booliano OR.  

```
{
  "BackupSelection":{
    "Resources":[
      "*"
    ],
    "NotResources":[
      "arn:aws:fsx:*",
      "arn:aws:rds:*"
    ],
    "Conditions":{
      "StringEquals":[
        {
          "ConditionKey":"aws:ResourceTag/backup",
          "ConditionValue":"true"
        }
      ]
    }
  }
}
```

**Example Exemplo: selecione todos os recursos marcados com uma tag "backup" e qualquer valor**  

```
{
  "BackupSelection":{
    "Resources":[
      "*"
    ],
    "Conditions":{
      "StringLike":[
        {
          "ConditionKey":"aws:ResourceTag/backup",
          "ConditionValue":"*"
        }
      ]
    }
  }
}
```

**Example Exemplo: selecione todos os sistemas de FSx arquivos, o cluster "my-aurora-cluster" Aurora e todos os recursos marcados com"backup":"true", exceto os recursos marcados com "stage":"test"**  

```
{
  "BackupSelection":{
    "Resources":[
      "arn:aws:fsx:*",
      "arn:aws:rds:*:*:cluster:my-aurora-cluster"
    ],
    "ListOfTags":[
      {
        "ConditionType":"StringEquals",
        "ConditionKey":"backup",
        "ConditionValue":"true"
      }
    ],
    "Conditions":{
      "StringNotEquals":[
        {
          "ConditionKey":"aws:ResourceTag/stage",
          "ConditionValue":"test"
        }
      ]
    }
  }
}
```

**Example Exemplo: selecione todos os recursos marcados com a tag `"backup":"true"`, exceto os volumes do EBS marcados com `"stage":"test"`**  
Use dois comandos da CLI para criar duas seleções para selecionar esse grupo de recursos. A primeira seleção se aplica a todos os recursos, exceto aos volumes do EBS. A segunda seleção se aplica aos volumes do EBS.  

```
{
  "BackupSelection":{
    "Resources":[
      "*"
    ],
    "NotResources":[
      "arn:aws:ec2:*:*:volume/*"
    ],
    "Conditions":{
      "StringEquals":[
        {
          "ConditionKey":"aws:ResourceTag/backup",
          "ConditionValue":"true"
        }
      ]
    }
  }
}
```

```
{
  "BackupSelection":{
    "Resources":[
      "arn:aws:ec2:*:*:volume/*"
    ],
    "Conditions":{
      "StringEquals":[
        {
          "ConditionKey":"aws:ResourceTag/backup",
          "ConditionValue":"true"
        }
      ],
      "StringNotEquals":[
        {
          "ConditionKey":"aws:ResourceTag/stage",
          "ConditionValue":"test"
        }
      ]
    }
  }
}
```