# Marcar os recursos do Amazon Aurora Global Database
<a name="aurora-global-database-tagging"></a>

 Com o recurso Aurora Global Database, é possível aplicar etiquetas do RDS a recursos em diferentes níveis em um banco de dados global. Se você não souber a forma como as etiquetas são usadas com a AWS ou os recursos do Aurora, consulte [Marcar recursos do Amazon Aurora e do Amazon RDS](USER_Tagging.md) antes de aplicar as etiquetas ao banco de dados global. 

**nota**  
 Como os processos da AWS marcam dados como parte de seus mecanismos de relatório de custos, não inclua dados confidenciais nem informações de identificação pessoal (PII) nos nomes e nos valores das etiquetas. 

 É possível aplicar etiquetas aos seguintes tipos de recurso em um banco de dados global: 
+  O objeto de contêiner de todo o banco de dados global. Esse recurso é conhecido como cluster global. 

   Depois de criar o cluster global realizando uma operação **Adicionar região da AWS** no console, é possível adicionar etiquetas na página de detalhes do cluster global. Na guia **Etiquetas**, na página de detalhes do cluster global, é possível adicionar, remover ou modificar etiquetas e seus valores associados escolhendo **Gerenciar etiquetas**. 

   Com a AWS CLI e a API do RDS, é possível adicionar etiquetas ao cluster global no momento da criação. Também é possível adicionar, remover ou modificar etiquetas para um cluster global existente. 
+  O cluster primário. Aqui, use os mesmos procedimentos utilizados para trabalhar com etiquetas em clusters autônomos do Aurora. É possível configurar as etiquetas antes de transformar o cluster do Aurora original em um banco de dados global. Também é possível adicionar, remover ou modificar etiquetas e seus valores associados escolhendo **Gerenciar etiquetas** na guia **Etiquetas** da página de detalhes do cluster de banco de dados. 
+  Qualquer cluster secundário. Aqui, use os mesmos procedimentos utilizados para trabalhar com etiquetas em clusters autônomos do Aurora. É possível configurar as etiquetas ao mesmo tempo em que um cluster secundário do Aurora é criado com a ação **Adicionar região da AWS** no console. Também é possível adicionar, remover ou modificar etiquetas e seus valores associados escolhendo **Gerenciar etiquetas** na guia **Etiquetas** da página de detalhes do cluster de banco de dados. 
+  Instâncias de banco de dados individuais nos clusters primário ou secundário. Aqui, use os mesmos procedimentos utilizados para trabalhar com etiquetas em instâncias de banco de dados do Aurora ou do RDS. É possível configurar as etiquetas ao mesmo tempo em que uma nova instância de banco de dados é adicionada ao cluster do Aurora com a ação **Adicionar leitor** no console. Também é possível adicionar, remover ou modificar etiquetas e seus valores associados escolhendo **Gerenciar etiquetas** na guia **Etiquetas** da página de detalhes da instância de banco de dados. 

 Apresentamos a seguir alguns exemplos dos tipos de etiqueta que podem ser atribuídos em um banco de dados global: 
+  É possível adicionar etiquetas ao cluster global para registrar informações gerais sobre a aplicação, como identificadores anônimos que representam proprietários e contatos na organização. É possível usar etiquetas para representar propriedades da aplicação que usa o banco de dados global. 
+  É possível adicionar etiquetas ao cluster primário e aos clusters secundários para monitorar os custos da aplicação ao nível da região da AWS. Para saber detalhes sobre esse procedimento, consulte [Como o faturamento da AWS funciona com tags no Amazon RDS](USER_Tagging.md#Tagging.Billing). 
+  É possível adicionar etiquetas a instâncias de banco de dados específicas com os clusters do Aurora para indicar sua finalidade especial. Por exemplo, no cluster primário, é possível ter uma instância do leitor com baixa prioridade de failover usada exclusivamente para geração de relatórios. Uma etiqueta pode distinguir essa instância de banco de dados para fins especiais de outras instâncias dedicadas a alta disponibilidade no cluster primário. 
+  É possível usar etiquetas em todos os níveis dos recursos do banco de dados global para controlar o acesso por meio de políticas do IAM. Para obter mais informações, consulte [Controlar acesso aos recursos da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources) no *Guia do usuário do Gerenciamento de Identidade e Acesso da AWS*. 
**dica**  
 No Console de gerenciamento da AWS, adicione etiquetas ao contêiner do cluster global como uma etapa separada depois de criá-lo. Se você quiser evitar intervalos de tempo em que o cluster global exista sem etiquetas de controle de acesso, poderá aplicar as etiquetas durante a operação `CreateGlobalCluster`, criando esse recurso por meio da AWS CLI, da API do RDS ou de um modelo do CloudFormation. 
+  É possível usar etiquetas ao nível do cluster, ou para o cluster global, a fim de registrar informações sobre garantia de qualidade e testes da aplicação. Por exemplo, é possível especificar uma etiqueta em um cluster de banco de dados para registrar a última vez que você realizou uma transição para esse cluster. É possível especificar uma etiqueta no cluster global para registrar a hora da última simulação de recuperação de desastres para toda a aplicação. 

## Exemplos de marcação para bancos de dados globais na AWS CLI
<a name="aurora-global-database-tagging-cli-examples"></a>

 Os exemplos da AWS CLI a seguir mostram como especificar e examinar etiquetas para todos os tipos de recurso do Aurora no banco de dados global. 

 É possível especificar etiquetas para o contêiner do cluster global com o comando `create-global-cluster`. O exemplo a seguir cria um cluster global e atribui duas etiquetas a ele. As etiquetas têm as chaves `tag1` e `tag2`. 

```
$  aws rds create-global-cluster --global-cluster-identifier {{my_global_cluster_id}} \
  --engine aurora-mysql --tags Key=tag1,Value=val1 Key=tag2,Value=val2
```

 É possível listar as etiquetas no contêiner do cluster global com o comando `describe-global-clusters`. Ao trabalhar com etiquetas, você normalmente executa esse comando primeiro para recuperar o nome do recurso da Amazon (ARN) do cluster global. Você usará o ARN como parâmetro nos comandos subsequentes para trabalhar com etiquetas. O comando a seguir exibe as informações de etiquetas no atributo `TagList`. Também mostra o ARN, que é usado como parâmetro nos exemplos posteriores. 

```
$  aws rds describe-global-clusters --global-cluster-identifier {{my_global_cluster_id}}
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            "GlobalClusterArn": "{{my_global_cluster_arn}}",
            ...
            "TagList": [
                {
                    "Value": "val1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                }
            ]
        }
    ]
}
```

 É possível adicionar novas etiquetas com o comando `add-tags-to-resource`. Com esse comando, você especifica o nome do recurso da Amazon (ARN) do cluster global em vez do identificador. Adicionar uma etiqueta com o mesmo nome que uma etiqueta existente substitui o valor dessa etiqueta. Se você incluir espaços ou caracteres especiais nos valores da etiqueta, cite os valores conforme apropriado para o sistema operacional ou shell de comando. O exemplo a seguir modifica as etiquetas do cluster global do exemplo anterior. Originalmente, o cluster tinha etiquetas com as chaves `tag1` e `tag2`. Após a conclusão do comando, o cluster global terá uma nova etiqueta com a chave `tag3`, e a etiqueta com a chave `tag1` terá um valor diferente. 

```
$  aws rds add-tags-to-resource --resource-name {{my_global_cluster_arn}} \
  --tags Key=tag1,Value="new value for tag1" Key=tag3,Value="entirely new tag"

$  aws rds describe-global-clusters --global-cluster-identifier {{my_global_cluster_id}}
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                },
                {
                    "Value": "val2",
                    "Key": "tag2"
                },
                {
                    "Value": "entirely new tag",
                    "Key": "tag3"
                }
            ]
        }
    ]
}
```

 É possível excluir uma etiqueta do cluster global com o comando `remove-tags-from-resource`. Com esse comando, você especifica somente um conjunto de chaves de etiqueta, sem nenhum valor de etiqueta. O exemplo a seguir modifica as etiquetas do cluster global do exemplo anterior. Originalmente, o cluster tinha etiquetas com as chaves `tag1`, `tag2` e `tag3`. Depois que o comando terminar, somente a etiqueta com a chave `tag1` permanecerá. 

```
$  aws rds remove-tags-from-resource --resource-name {{my_global_cluster_arn}} --tag-keys tag2 tag3

$  aws rds describe-global-clusters --global-cluster-identifier {{my_global_cluster_id}}
{
    "GlobalClusters": [
        {
            "Status": "available",
            "Engine": "aurora-mysql",
            ...
            "TagList": [
                {
                    "Value": "new value for tag1",
                    "Key": "tag1"
                }
            ]
        }
    ]
}
```