View a markdown version of this page

Marcação de recursos no Aurora DSQL - Amazon Aurora DSQL
Name tagRequisitos de marcaçãoTags de fluxo de CDCObservações sobre o uso de marcação

Marcação de recursos no Aurora DSQL

Na AWS, as tags são pares de chave-valor definidos pelo usuário e que são definidos e associados aos recursos do Aurora DSQL, como clusters e fluxos de CDC. As tags são opcionais. Se você fornecer uma chave, o valor será opcional.

Você pode usar o Console de gerenciamento da AWS, a AWS CLI ou os SDKs da AWS para adicionar, listar e excluir tags nos clusters e fluxos de CDC do Aurora DSQL. É possível adicionar tags durante e após a criação do recurso usando o Console da AWS. Para marcar um recurso após a criação com a AWS CLI, use a operação TagResource.

Marcar clusters com um nome

O Aurora DSQL cria clusters com um identificador globalmente exclusivo atribuído como nome do recurso da Amazon (ARN). Se você quiser atribuir um nome fácil ao cluster, recomendamos que use uma tag.

Se você criar um cluster com o console do Aurora DSQL, o Aurora DSQL criará automaticamente uma tag. Essa tag tem uma chave de nome e um valor gerado automaticamente que representa o nome do cluster. Esse valor é configurável, então você pode atribuir um nome mais fácil ao cluster. Se um cluster tiver uma tag de nome com um valor associado, você poderá ver o valor em todo o console do Aurora DSQL.

Requisitos de marcação

As tags têm os seguintes requisitos:

  • As chaves não podem ser prefixadas com aws:.

  • As chaves devem ser exclusivas por conjunto de tags.

  • Uma chave deve ter entre 1 e 128 caracteres permitidos.

  • Um valor deve ter entre 0 e 256 caracteres permitidos.

  • Os valores não precisam ser exclusivos por conjunto de tags.

  • Os caracteres permitidos para chaves e valores são letras, dígitos, espaço em branco e qualquer um dos seguintes símbolos: _ . : / = + - @.

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

Marcação dos fluxos de CDC

Os fluxos de CDC são recursos marcáveis de forma independente. Você pode adicionar tags ao criar um fluxo transmitindo o parâmetro --tags paraCreateStream, além de ler, adicionar ou remover tags em um fluxo existente usando ListTagsForResource, TagResource e UntagResource com o ARN do fluxo. As tags em um fluxo de CDC são separadas das tags no cluster principal e das tags no fluxo de dados do Amazon Kinesis de destino.

Um ARN de fluxo de CDC tem o formato arn:aws:dsql:region:account-id:cluster/cluster-id/stream/stream-id. Para obter mais informações sobre fluxos de CDC, consulte Fluxos de captura de dados de alteração (CDC).

Observações sobre o uso de marcação

Ao usar tags no Aurora DSQL, considere o seguinte:

  • Ao usar a CLI ou a API, forneça o nome do recurso da Amazon (ARN) do recurso do Aurora DSQL com o qual deseja trabalhar. Para ter mais informações, consulte Amazon Resource Name (ARNs) format for Aurora DSQL resources.

  • Cada recurso tem um conjunto de tags, que é uma coleção de uma ou mais tags atribuídas ao recurso.

  • Cada recurso pode ter até 50 tags por conjunto de tags.

  • Se você excluir um recurso, todas as tags associadas serão excluídas.

  • É possível adicionar tags ao criar um recurso. Você pode visualizar e modificar tags usando as seguintes operações de API: TagResource, UntagResource e ListTagsForResource.

  • Você pode usar tags com políticas do IAM. Também é possível usá-las para gerenciar o acesso a clusters do Aurora DSQL e controlar quais ações podem ser aplicadas a esses recursos. Para saber mais, consulte Controlar o acesso a recursos da AWS usando tags.

  • Você pode usar tags para várias outras atividades na AWS. Para saber mais, consulte Common tagging strategies.