Marcação dos seus recursos do MemoryDB - Amazon MemoryDB

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

Marcação dos seus recursos do MemoryDB

Para ajudar você a gerenciar seus clusters e outros recursos do MemoryDB, é possível atribuir seus próprios metadados a cada recurso na forma de tags. As tags permitem que você categorize seus AWS recursos de maneiras diferentes, por exemplo, por finalidade, proprietário ou ambiente. Isso é útil quando você tem muitos recursos do mesmo tipo. É possível identificar rapidamente um recurso específico baseado nas tags que você atribuiu a ele. Este tópico descreve tags e mostra a você como criá-los.

Atenção

Como uma prática recomendada, sugerimos que você não inclua dados confidenciais nas suas tags.

Uma tag é um rótulo que você atribui a um AWS recurso. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você. As tags permitem que você categorize seus AWS recursos de maneiras diferentes, por exemplo, por finalidade ou proprietário. Por exemplo, você pode definir um conjunto de tags para os clusters do MemoryDB da sua conta que o ajudem a rastrear o proprietário e o grupo de usuários de cada cluster.

Recomendamos que você desenvolva um conjunto de chave de tags que atenda suas necessidades para cada tipo de recurso. Usar um conjunto consistente de chaves de tags facilita para você gerenciar seus recursos da . É possível pesquisar e filtrar os recursos de acordo com as tags que adicionar. Para obter mais informações sobre como implementar uma estratégia eficaz de marcação de recursos, consulte o whitepaper da AWS , Práticas recomendadas de marcação.

As tags não têm nenhum significado semântico para o MemoryDB e são interpretadas estritamente como uma sequência de caracteres. Além disso, as tags não são automaticamente atribuídas aos seus recursos. É possível editar chaves de tags e valores, e é possível remover as tags de um recurso a qualquer momento. É possível definir o valor de uma tag como null. Ao adicionar uma tag que tenha a mesma chave de uma tag existente nesse recurso, o novo valor substituirá o antigo. Se você excluir um recurso, todas as tags do recurso também serão excluídas.

Você pode trabalhar com tags usando a API AWS Management Console AWS CLI, the e MemoryDB.

Se você estiver usando o IAM, você pode controlar quais usuários AWS da sua conta têm permissão para criar, editar ou excluir tags. Para ter mais informações, consulte Permissões em nível de recurso.

Você pode usar tags na maioria dos recursos do MemoryDB que já existem em sua conta. A tabela a seguir lista os recursos compatíveis com o uso de tags. Se você estiver usando o AWS Management Console, você pode aplicar tags aos recursos usando o Editor de tags. Algumas telas de recursos permitem que você especifique tags para um recurso ao criá-lo; por exemplo, uma tag com uma chave de nome e um valor que você especificar. Na maioria dos casos, o console aplicará as tags imediatamente depois de o recurso ser criado (em vez de durante a criação de recursos). O console pode organizar os recursos de acordo com a tag Nome, mas essa tag não tem nenhum significado semântico para o serviço do MemoryDB.

Além disso, algumas ações de criação de recursos permitem que você especifique tags para um recurso quando ele é criado. Se as tags não puderem ser aplicadas durante a criação dos recursos, nós reverteremos o processo de criação de recursos. Isso garante que os recursos sejam criados com tags ou, então, não criados, e que nenhum recurso seja deixado sem tags. Ao marcar com tags os recursos no momento da criação, você elimina a necessidade de executar scripts personalizados de uso de tags após a criação do recurso.

Se você estiver usando a API Amazon MemoryDB, a AWS CLI ou um AWS SDK, poderá usar o Tags parâmetro na ação relevante da API MemoryDB para aplicar tags. Eles são:

  • CreateCluster

  • CopySnapshot

  • CreateParameterGroup

  • CreateSubnetGroup

  • CreateSnapshot

  • CreateACL

  • CreateUser

A tabela a seguir descreve os recursos do MemoryDB que podem ser marcados e os recursos que podem ser marcados na criação usando a API MemoryDB, a AWS CLI ou um SDK. AWS

Suporte à marcação para recursos do MemoryDB
Recurso Compatível com tags Oferece suporte à marcação na criação
ParameterGroup Sim Sim
SubnetGroup Sim Sim
cluster Sim Sim
snapshot Sim Sim
usuário Sim Sim
acl Sim Sim

É possível aplicar permissões em nível de recurso baseadas em tags em suas políticas do IAM às ações da API do MemoryDB que oferecem suporte à marcação na criação para implementar um controle granular sobre os usuários e grupos que podem marcar recursos na criação. Seus recursos estão devidamente protegidos a partir da criação. As tags são aplicadas imediatamente aos recursos. Portanto, todas as permissões em nível de recurso baseadas em tags que controlam o uso de recursos entram imediatamente em vigor. Seus recursos podem ser rastreados e relatados com mais precisão. É possível obrigar o uso de marcação com tags nos novos recursos e controlar quais chaves e valores de tag são definidos nos seus recursos.

Para ter mais informações, consulte Exemplo de marcação de recursos.

Para obter mais informações sobre como marcar os seus recursos para o faturamento, consulte Monitoramento de custos com tags de alocação de custos.

As seguintes regras se aplicam à marcação como parte das operações de solicitação:

  • CreateCluster :

    • Se o --cluster-name for fornecido:

      Se as tags forem incluídas na solicitação, o cluster será marcado.

    • Se o --snapshot-name for fornecido:

      Se as tags forem incluídas na solicitação, o cluster será marcado somente com essas tags. Se nenhuma tag for incluída na solicitação, as tags de snapshot serão adicionadas ao cluster.

  • CreateSnapshot :

    • Se o --cluster-name for fornecido:

      Se as tags forem incluídas na solicitação, somente as tags de solicitação serão adicionadas ao snapshot. Se nenhuma tag for incluída na solicitação, as tags de cluster de cache serão adicionadas ao snapshot.

    • Para snapshots automáticos:

      As tags serão propagadas a partir das tags do cluster.

  • CopySnapshot :

    Se as tags forem incluídas na solicitação, somente as tags de solicitação serão adicionadas ao snapshot. Se nenhuma tag for incluída na solicitação, as tags de snapshot da origem serão adicionadas ao snapshot copiado.

  • TagResourcee UntagResource:

    As tags serão adicionadas/removidas do recurso.

As restrições básicas a seguir se aplicam a tags:

  • Número máximo de tags por recurso –- 50

  • Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor.

  • Comprimento máximo da chave – 128 caracteres Unicode em UTF-8.

  • Comprimento máximo do valor – 256 caracteres Unicode em UTF-8.

  • Embora o MemoryDB permita qualquer caractere em suas tags, outros serviços podem ser restritivos. Os caracteres permitidos nos serviços são: letras, números e espaços representáveis em UTF-8 e os seguintes caracteres: + - = . _ : / @

  • As chaves e os valores de tags diferenciam maiúsculas de minúsculas.

  • O aws: prefixo está reservado para AWS uso. Não é possível editar nem excluir a chave ou o valor de uma tag quando ela tem uma chave de tag com esse prefixo. As tags com o prefixo aws: não contam para as tags por limite de recurso.

Você não pode encerrar, parar ou excluir um recurso baseado unicamente em suas tags; será preciso especificar o identificador de recursos. Por exemplo, para excluir snapshots marcados com uma chave de tag chamada DeleteMe, use a ação DeleteSnapshot com os identificadores de recursos dos snapshots, como snap-1234567890abcdef0.

Para obter mais informações sobre os recursos do MemoryDB que você pode usar tags, consulte Recursos que podem ser marcados.

  • Adicionar tags a um cluster.

    aws memorydb tag-resource \ --resource-arn arn:aws:memorydb:us-east-1:111111222233:cluster/my-cluster \ --tags Key="project",Value="XYZ" Key="memorydb",Value="Service"
  • Criação de um cluster usando tags.

    aws memorydb create-cluster \ --cluster-name testing-tags \ --description cluster-test \ --subnet-group-name test \ --node-type db.r6g.large \ --acl-name open-access \ --tags Key="project",Value="XYZ" Key="memorydb",Value="Service"
  • Criação de um snapshot com tags.

    Para esse caso, se você adicionar tags sob solicitação, mesmo que o cluster contenha tags, o snapshot receberá somente as tags da solicitação.

    aws memorydb create-snapshot \ --cluster-name testing-tags \ --snapshot-name bkp-testing-tags-mycluster \ --tags Key="work",Value="foo"