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á.
# AWS Service Catalog TagOption Biblioteca
Para permitir que os administradores gerenciem facilmente as tags em produtos provisionados, AWS Service Catalog fornece uma biblioteca. TagOption A TagOption é um par de valores-chave gerenciado em. AWS Service Catalog Não é uma AWS tag, mas serve como um modelo para criar uma AWS tag com base na TagOption.
AWS Service Catalog não oferece suporte aos produtos TagOptions Terraform Open Source ou Terraform Cloud.
A TagOption biblioteca facilita a aplicação do seguinte:
+ Uma taxonomia consistente
+ Marcação adequada de recursos AWS Service Catalog
+ Opções definidas selecionáveis pelo usuário para tags permitidas
Os administradores podem se TagOptions associar a portfólios e produtos. Durante o lançamento de um produto (provisionamento), AWS Service Catalog agrega o portfólio e o produto TagOptions associados e os aplica ao produto provisionado, conforme mostrado no diagrama a seguir.
![\[TagOptions Diagrama de fluxo\]](http://docs.aws.amazon.com/pt_br/servicecatalog/latest/adminguide/images/TagOption-library.png)
Com a TagOption biblioteca, você pode desativar TagOptions e manter suas associações a portfólios ou produtos e reativá-las quando precisar delas. Essa abordagem não apenas ajuda a manter a integridade da biblioteca, mas também permite gerenciar o TagOptions que pode ser usado de forma intermitente ou somente em circunstâncias especiais.
Você gerencia TagOptions com o AWS Service Catalog console ou a API da TagOption biblioteca. Para obter mais informações, consulte a [Referência de APIs do Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/dg/API_Reference.html).
**Topics**
+ [Lançamento de um produto com TagOptions](tagoptions-launching.md)
+ [Gerenciando TagOptions](tagoptions-manage.md)
+ [Usando TagOptions com políticas de AWS Organizations tag](tagoption-policies.md)
# Lançamento de um produto com TagOptions
Quando um usuário lança um produto que tem TagOptions, AWS Service Catalog executa as seguintes ações em seu nome:
+ Coleta tudo TagOptions para o produto e o portfólio de lançamento.
+ Garante que somente TagOptions chaves exclusivas sejam usadas em uma tag no produto provisionado. Os usuários obtêm uma lista de valores de múltipla escolha para uma chave. Depois que o usuário escolhe um valor, ele se torna uma tag no produto provisionado.
+ Permite que os usuários adicionem tags não conflitantes ao produto durante o provisionamento.
Os casos de uso a seguir demonstram como TagOptions funcionam durante o lançamento.
## Exemplo 1: Uma TagOption chave exclusiva
**Um administrador cria **TagOption[Grupo=Finanças]** e o associa ao **Portfólio1, que tem o Produto1 sem nenhum**.** TagOptions Quando um usuário inicia o produto provisionado, o single TagOption se torna **Tag [Group=Finance**], da seguinte forma:
![\[TagOptions Exemplo 1: Uma chave exclusiva\]](http://docs.aws.amazon.com/pt_br/servicecatalog/latest/adminguide/images/tagoptions-ex1.png)
## Exemplo 2: Um conjunto TagOptions com a mesma chave em um portfólio
Um administrador colocou duas TagOptions com a mesma chave em um portfólio, e não há nenhuma TagOptions com a mesma chave em nenhum produto desse portfólio. Durante o lançamento, o usuário deve selecionar um dos dois valores associados à chave. O produto provisionado é marcado com a chave e o valor selecionados pelo usuário.
![\[TagOptions Exemplo 2: Mesma chave em um portfólio\]](http://docs.aws.amazon.com/pt_br/servicecatalog/latest/adminguide/images/tagoptions-ex2.png)
## Exemplo 3: Um conjunto TagOptions com a mesma chave no portfólio e em um produto desse portfólio
Um administrador colocou vários TagOptions com a mesma chave em um portfólio, e também há vários TagOptions com a mesma chave no produto desse portfólio. AWS Service Catalog cria um conjunto de valores a partir da agregação (operação lógica AND) do TagOptions. Quando lança o produto, o usuário vê e seleciona a partir desse conjunto de valores. O produto provisionado é marcado com a chave e o valor selecionados pelo usuário.
![\[TagOptions Exemplo 3: Mesma chave em um portfólio e produto nesse portfólio\]](http://docs.aws.amazon.com/pt_br/servicecatalog/latest/adminguide/images/tagoptions-ex3.png)
## Exemplo 4: Vários TagOptions com a mesma chave e valores conflitantes
Um administrador colocou vários TagOptions com a mesma chave em um portfólio, e também há vários TagOptions com a mesma chave no produto desse portfólio. AWS Service Catalog cria um conjunto de valores a partir da agregação (operação lógica AND) do TagOptions. Se a agregação não encontrar valores para a chave, AWS Service Catalog cria uma tag com a mesma chave e um valor de`sc-tagconflict-portfolioid-productid`, onde `portfolioid` e onde `productid` estão o ARNs portfólio e o produto. Isso garante que o produto provisionado seja marcado com a chave correta e com um valor que o administrador pode localizar e corrigir.
![\[TagOptions Exemplo 4: Mesma chave e valores conflitantes\]](http://docs.aws.amazon.com/pt_br/servicecatalog/latest/adminguide/images/tagoptions-ex4.png)
# Gerenciando TagOptions
Como administrador, você pode realizar as seguintes ações para gerenciar TagOptions na TagOptions biblioteca:
+ Criar e excluir
+ Ativar ou desativar
+ Associar ou desassociar
+ Edição
****Para criar TagOptions no console****
1. Abra o console do Service Catalog em [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).
1. No menu de navegação à esquerda, escolha **TagOptionsbiblioteca**.
1. Em **Criar novo TagOption**, insira uma chave e um valor e escolha **Adicionar**.
Depois que o novo TagOption é criado, ele é agrupado por par de valores-chave e classificado em ordem alfabética na lista. **TagOptions**
Para criar um TagOption usando a AWS Service Catalog API, consulte [CreateTagOption](https://docs.aws.amazon.com/servicecatalog/latest/dg/API_CreateTagOption.html).
****Para excluir TagOptions no console****
1. Abra o console do Service Catalog em [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).
1. No menu de navegação à esquerda, escolha **TagOptions biblioteca** e, em seguida, escolha **Ações**.
1. Escolha **Excluir** e confirme a exclusão.
****Para ativar ou desativar um ou mais TagOptions no console****
1. Abra o console do Service Catalog em [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).
1. No menu de navegação à esquerda, escolha **TagOptions biblioteca** e, em seguida, escolha **Ações**.
1. Para ativar, escolha o inativo TagOption que você deseja. Em seguida, escolha **Ações** e selecione **Ativar** no menu suspenso e confirme sua seleção.
Para desativar, escolha o ativo que TagOption você deseja. Em seguida, escolha **Ações** e selecione **Desativar** no menu suspenso e confirme sua seleção.
****Para associar ou desassociar um ou mais TagOptions de um portfólio no console****
1. Abra o console do Service Catalog em [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).
1. No menu de navegação à esquerda, selecione **Portfólios** e, em seguida, o portfólio que você deseja associar ou dissociar.
1. Escolha a **TagOptions**guia e selecione uma ou mais TagOptions para associar ou desassociar do portfólio.
1. Escolha **Ações**. Em seguida, selecione **Associar** ou **Desassociar** e confirme sua seleção.
****Para associar ou desassociar um ou mais TagOptions de um produto no console****
1. Abra o AWS Service Catalog console em: [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).
1. No menu de navegação à esquerda, em **Administração**, selecione **Produtos**. Em seguida, abra o produto que você deseja associar ou desassociar.
1. Escolha a **TagOptions**guia e selecione uma ou mais TagOptions para associar ou desassociar do portfólio.
1. Escolha **Ações**. Em seguida, selecione **Associar** ou **Desassociar** e confirme sua seleção.
**nota**
Para TagOptions associar-se a um portfólio ou produto usando a AWS Service Catalog API, consulte [AssociateTagOptionWithResource](https://docs.aws.amazon.com/servicecatalog/latest/dg/API_AssociateTagOptionWithResource.html).
Para remover (desassociar) TagOptions usando a AWS Service Catalog API, consulte [DisassociateTagOptionFromResource](https://docs.aws.amazon.com/servicecatalog/latest/dg/API_DisassociateTagOptionFromResource.html).
**Para editar valores para TagOptions no console**
1. Abra o console do Service Catalog em [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/).
1. No menu de navegação à esquerda, escolha **TagOptionsbiblioteca**.
1. Escolha um TagOption e abra o valor. (O valor tem um hiperlink.) Em seguida, escolha **Editar**.
1. No campo **Valor**, edite o valor e escolha **Salvar alterações**.
# Usando TagOptions com políticas de AWS Organizations tag
Este tópico fornece uma breve visão geral das políticas de tags para AWS Organizations e TagOptions para AWS Service Catalog. Também sugere como evitar conflitos de marcação ao usar os dois recursos simultaneamente.
TagOptions para AWS Service Catalog aplicar a produtos provisionados (CloudFormationpilhas), enquanto as políticas de tag AWS Organizations se aplicam a AWS contas e unidades organizacionais (OU) ou a uma raiz organizacional. Por exemplo, se você anexar uma política de tags a uma UO, a mesma política de tags se aplicará a todas as contas dessa UO. Se você usar os dois recursos de marcação simultaneamente, deverá configurá-los para que não entrem em conflito.
## Políticas de tag
As políticas de tags permitem que você defina regras sobre como usar tags em recursos da AWS em suas contas em AWS Organizations. Você pode usar políticas de tags para criar e manter uma abordagem consistente para marcar AWS recursos no nível da conta.
As políticas de tags fornecem uma maneira fácil de garantir que os usuários apliquem tags consistentes, auditem recursos marcados e mantenham a categorização adequada dos recursos. Você também pode definir como as chaves de tag devem ser capitalizadas e os valores que você deseja permitir. Por exemplo, você pode exigir que todas as instâncias do EC2 em uma conta tenham uma chave de tag definida como **CostCenter** e valores para que essa tag seja **Data Insights** ou **Marketing**.
As políticas de tags permitem que você selecione opções para impor regras de marcação, evitar operações não compatíveis com tags e especificar os tipos de recursos aos quais a fiscalização se aplica. Se você não escolher uma opção de imposição, as políticas de tags permitem criar ou alterar as tags não compatíveis, mas as denunciam como não compatíveis no console. AWS Organizations
Para obter mais informações sobre como configurar a aplicação da marcação em nível de conta, consulte [Políticas de tags](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_tag-policies.html) em *AWS Organizations*.
## TagOptions
TagOptions são um recurso de marcação que AWS Service Catalog se aplica aos produtos provisionados no nível da CloudFormation pilha se forem aplicados a um produto associado. AWS Service Catalog fornece uma TagOptions biblioteca na qual você pode definir os pares de valores-chave a serem associados aos seus AWS Service Catalog produtos. Ao lançar um AWS Service Catalog produto, você deve escolher TagOption valores para as TagOption chaves existentes associadas a esse portfólio ou produto para lançar esse produto. Como você define os TagOptions níveis de portfólio ou produto, você pode aplicar uma taxonomia consistente para marcação com portfólios compartilhados entre contas e regiões.
Para obter mais informações sobre como configurar TagOptions AWS Service Catalog, consulte [AWS Service Catalog TagOption Biblioteca](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/tagoptions.html).
## Evitando conflitos entre políticas de AWS Organizations tags e AWS Service Catalog TagOptions
Se você configurar políticas de AWS Organizations tags para contas em sua organização, recomendamos o seguinte:
+ Compartilhe os requisitos de etiquetas de conformidade com administradores que também TagOptions gerenciam AWS Service Catalog portfólios e produtos.
+ Compartilhe os requisitos de etiquetas de conformidade com os usuários finais que possam lançar produtos AWS Service Catalog e anexe etiquetas de usuário final opcionais aos lançamentos de seus produtos.
Suponha que você queira lançar um produto AWS Service Catalog que use a TagOption chave `city` e tenha uma política de tags que exija que as chaves de tag tenham valores de tag de **cidades dos EUA****Atlanta**, como**San Francisco**, ou**Austin**. `city` AWS Service Catalog não permite que você lance um produto sem ter selecionado TagOption valores para as TagOption chaves necessárias para um produto.
Nesse caso, se você tiver TagOption valores para a TagOption chave `city` que incluam **cidades da América do Sul**, como **Rio de Janeiro** ou**Buenos Aires**, não AWS Service Catalog lançará o produto. Em vez disso, você deve selecionar um TagOption valor que inclua uma cidade dos EUA durante o lançamento para estar em conformidade com a política de tags.
A tabela a seguir fornece cenários que descrevem como resolver os problemas de conflito de marcação que você pode encontrar ao usar políticas de tag e ao TagOptions mesmo tempo.
| Cenário | Motivo | Solução |
| --- | --- | --- |
| O produto não é lançado devido a tags não compatíveis se a aplicação de tags for verificada na política de tags. | Especificar TagOptions com chaves e valores que você não adicionou à lista permitida de tags compatíveis em sua política de tags. Adicionar tags personalizadas opcionais que não estão em conformidade com sua política de tags. | Se você configurar um esquema de capitalização específico em sua política de tags. A aplicação da capitalização de chaves de tag, certifique-se de que suas chaves de TagOptions tag e chaves de tag personalizadas opcionais sejam consistentes com o que você especificou em sua política de tags. Observe que quando a caixa de imposição de capitalização da chave de tag está desmarcada em sua política de tags, isso faz com que todas as chaves de tag em minúsculas estejam em conformidade e garante que suas chaves de tag e chaves de TagOptions tag personalizadas opcionais sejam consistentes (como todas em minúsculas) com o que você exigiu em sua política de tags. |
| O produto falha ao iniciar devido à não conformidade com a capitalização da chave de tag. | Especificar letras maiúsculas nas TagOptions chaves que é inconsistente com as regras de aplicação de maiúsculas e minúsculas da política de tags. | Configure corretamente suas políticas de tags. Se você não especificar a conformidade com a capitalização da chave de tag, a capitalização padrão da chave de tag será toda em minúsculas. Além disso, se você não especificar a conformidade com letras maiúsculas e minúsculas em sua política de tags, verifique se as chaves de TagOptions tag AWS Service Catalog estão todas em minúsculas para cumprir as regras de fiscalização.Se você usar uma política de tags que não tenha a conformidade com letras maiúsculas ativada, essa política de tags considerará apenas todas as chaves de tag em minúsculas como compatíveis. |
| O produto falha no lançamento devido a valores de tag incompatíveis. | Selecionar um valor de TagOptions tag para o lançamento de um produto que não está na sua lista de permissões de conformidade com valores de tags. | Associe TagOptions aos seus produtos e portfólios que sejam consistentes com o que você exigiu na política de etiquetas Valores de etiquetas Conformidade com valores de etiquetas permitidos. |