View a markdown version of this page

Atribua recursos com AWS CLI - AWS Backup

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

Filtrar por serviços ou tipos de recursos

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.

exemplo

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 compartilham o formato de 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

É 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 BackupSelection.

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.

exemplo Exemplo: selecione todos os recursos em minha conta
{ "BackupSelection":{ "Resources":[ "*" ] } }
exemplo Exemplo: selecione todos os recursos em minha conta, mas exclua os volumes do EBS
{ "BackupSelection":{ "Resources":[ "*" ], "NotResources":[ "arn:aws:ec2:*:*:volume/*" ] } }
exemplo Exemplo: Selecione todos os recursos marcados com “backup”: “verdadeiro”, mas exclui volumes do EBS
{ "BackupSelection":{ "Resources":[ "*" ], "NotResources":[ "arn:aws:ec2:*:*:volume/*" ], "Conditions":{ "StringEquals":[ { "ConditionKey":"aws:ResourceTag/backup", "ConditionValue":"true" } ] } } }
Importante

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

exemplo Exemplo: selecione todos os volumes do EBS e instâncias de banco de dados do RDS marcados com ambos “backup”: “verdadeiro” and “estágio”: “produção”

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" } ] } } }
exemplo Exemplo: Selecione todos os volumes do EBS e instâncias do RDS marcados com “backup”: “verdadeiro” mas não “estágio”: “teste”
{ "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" } ] } } }
exemplo Exemplo: Selecione todos os recursos marcados com “chave 1" e um valor que começa com “incluir” mas não com “chave 2" e valor que contém a palavra “excluir”

Você pode usar o caractere curinga no início, no final e no meio de uma string. Observe o uso do caractere curinga (*) 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*" } ] } } }
exemplo Exemplo: Selecione todos os recursos marcados com “backup”: “verdadeiro” exceto sistemas de arquivos FSx e recursos de 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" } ] } } }
exemplo Exemplo: selecione todos os recursos marcados com uma tag “backup” e qualquer valor
{ "BackupSelection":{ "Resources":[ "*" ], "Conditions":{ "StringLike":[ { "ConditionKey":"aws:ResourceTag/backup", "ConditionValue":"*" } ] } } }
exemplo Exemplo: selecione todos os sistemas de arquivos FSx, o cluster Aurora “meu aglomerado de aurora”, e todos os recursos marcados com “backup”: “verdadeiro”, exceto para recursos marcados com “estágio”: “teste”
{ "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" } ] } } }
exemplo 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" } ] } } }