

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 de recursos do Amazon Braket
<a name="braket-tagging-resources"></a>

Uma *tag* é um rótulo de atributo personalizado que você atribui ou AWS atribui a um AWS recurso. Uma tag são *metadados* que informam mais sobre seu recurso. Cada tag consiste em uma *chave* e um *valor*. Juntos, são conhecidos como *pares de chave/valor*. Em tags atribuídas por você, você mesmo define a chave e o valor.

No console do Amazon Braket, você pode navegar até uma tarefa quântica ou um caderno e ver a lista de tags associadas a ela. Você pode adicionar uma tag, remover uma tag ou modificar uma tag. Você pode marcar uma tarefa quântica ou um notebook após a criação e, em seguida, gerenciar as tags associadas por meio do console AWS CLI, ouAPI.

**Mais sobre AWS e tags**
+ Para obter informações gerais sobre marcação, incluindo convenções de nomenclatura e uso, consulte [O que é o](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html) Tag Editor? no Guia do usuário * AWS dos recursos de marcação e do editor de tags*.
+ Para obter informações sobre restrições à marcação, consulte [Limites e requisitos de nomenclatura de tags no Guia](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices) do usuário dos * AWS recursos de marcação e do editor de tags*.
+ Para ver as melhores práticas e estratégias de marcação, consulte [Melhores práticas para marcar recursos da AWS](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html).
+ Para obter uma lista de serviços que oferecem suporte à atribuição de tags, consulte a [https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html).

As seções a seguir fornecem mais informações sobre tags para o Amazon Braket.

**Topics**
+ [Usar tags](#tags)
+ [Recursos compatíveis para marcação no Amazon Braket](#tag-supported-resources)
+ [Marcar com o Amazon Braket API](#braket-cli-tagging)
+ [Restrições de marcação](tag-restrictions.md)
+ [Gerenciamento de tags no Amazon Braket](tag-managing.md)
+ [Exemplo de AWS CLI marcação no Amazon Braket](braket-tags-example.md)

## Usar tags
<a name="tags"></a>

As tags podem organizar seus recursos em categorias que são úteis para você. Por exemplo, você pode atribuir uma tag “Department” para especificar o departamento responsável pelo recurso.

Cada tag da tem duas partes:
+ Uma chave de tag (por exemplo *CostCenter*, *Ambiente* ou *Projeto*). As chaves de tag diferenciam maiúsculas de minúsculas
+ Um campo opcional, conhecido como valor de tag (por exemplo, 111122223333 ou *Production*). Omitir o valor da tag é o mesmo que usar uma string vazia. Assim como as chaves de tag, os valores de tag diferenciam maiúsculas de minúsculas.

As tags ajudam a:
+  **Identifique e organize seus AWS recursos.** Muitos Serviços da AWS oferecem suporte à marcação, então você pode atribuir a mesma tag a recursos de serviços diferentes para indicar que os recursos estão relacionados.
+  **Acompanhe seus AWS custos.** Você ativa essas tags no Gerenciamento de Faturamento e Custos da AWS painel. AWS usa as tags para categorizar seus custos e entregar um relatório mensal de alocação de custos para você. Para obter mais informações, consulte [Usar tags de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no [Guia do Usuário do Gerenciamento de Faturamento e Custos da AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html).
+  **Controle o acesso aos seus AWS recursos.** Para obter mais informações, consulte [Controlando o acesso usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).

## Recursos compatíveis para marcação no Amazon Braket
<a name="tag-supported-resources"></a>

Os seguintes recursos do Amazon Braket são compatíveis com a marcação:
+  Recurso do [https://docs.aws.amazon.com/braket/latest/developerguide/braket-manage-access.html#resources](https://docs.aws.amazon.com/braket/latest/developerguide/braket-manage-access.html#resources)
+  **Nome do recurso:** `AWS::Service::Braket` 
+  **Regex do ARN:** `arn:${Partition}:braket:${Region}:${Account}:quantum-task/${RandomId}` 

 **Nota:** Você pode aplicar e gerenciar etiquetas para seus cadernos Amazon Braket no console Amazon Braket, usando o console para navegar até o recurso de notebook, embora os notebooks sejam, na verdade, recursos de IA da Amazon. SageMaker Para obter mais informações, consulte [Metadados da instância do notebook](https://docs.aws.amazon.com/sagemaker/latest/dg/nbi-metadata.html) na SageMaker documentação.

## Marcar com o Amazon Braket API
<a name="braket-cli-tagging"></a>
+ Se você estiver usando a API do Amazon Braket para configurar tags em um recurso, chame o [https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html).

 `aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tags {\"city\":\"Seattle\"}` 
+ Para remover tags de um recurso, chame [https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html).

 `aws braket list-tags-for-resource --resource-arn $YOUR_TASK_ARN` 
+ Para listar todas as tags anexadas a um recurso específico, chame [https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html).

 `aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tag-keys "[\"city\",\"state\"]"` 