Marcar os recursos do Amazon Aurora Global Database - Amazon Aurora
Exemplos de marcação para bancos de dados globais na AWS CLI

Marcar os recursos do Amazon Aurora Global Database

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

  • É 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 no Guia do usuário do Gerenciamento de Identidade e Acesso da AWS.

    dica

    No AWS Management Console, 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 AWS 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

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"
                }
            ]
        }
    ]
}