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á.
# Adicionar tags personalizadas a recursos
A página a seguir demonstra as etapas necessárias para usar a propagação de tags personalizadas. A propagação de tags personalizadas requer as seguintes etapas:
+ Opte pela propagação de tags personalizadas
+ Adicionar tags personalizadas a recursos
Quando você ativa a propagação de tags personalizadas em um domínio existente, a propagação de tags não funciona para aplicações existentes até que a aplicação seja reiniciado. Da mesma forma, as tags não são atualizadas em um recurso existente quando novas tags personalizadas são adicionadas. Por exemplo, suponha que um domínio tenha duas tags e um usuário crie um recurso nesse domínio. O recurso, então, fica com duas tags. Se uma nova tag for adicionada ao domínio, essa nova tag não será adicionada ao recurso existente. No entanto, qualquer novo recurso criado terá a nova tag anexada ao recurso.
## Pré-requisitos
+ Os usuários devem ter a permissão de `sagemaker:AddTags` para criar qualquer recurso.
+ Para novos domínios criados com a política `SageMakerFullAccess` gerenciada ou usando o Gerenciador de SageMaker Funções, a `sagemaker:AddTags` permissão é pré-preenchida.
+ Para domínios existentes que usam AWS Identity and Access Management políticas personalizadas, você deve atualizar as políticas para incluir a `sagemaker:AddTags` permissão para permitir que os usuários criem recursos.
## Opte pela propagação de tags personalizadas
O processo para optar pela propagação de tags personalizadas difere dependendo se você está optando pelo console ou pela AWS CLI. No console, você só pode optar pela propagação de tags personalizadas atualizando um domínio existente. A partir do AWS CLI, você pode optar pela propagação personalizada de tags ao criar um domínio ou atualizar um domínio existente.
### Opte usando o console
As etapas a seguir descrevem como optar pela propagação de tags personalizadas a partir do console. Você só pode optar pela propagação de tags personalizadas a partir do console atualizando um domínio existente.
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, selecione **Configurações do administrador**. Em **Configurações do administrador**, selecione **Domínios**.
1. Na página **Domínios**, selecione o domínio para o qual deseja ativar a propagação de tags personalizadas.
1. Na página de **detalhes do domínio**, selecione a guia **Configurações do domínio**.
1. Na guia **Configurações do domínio**, navegue até **Propagação de tags personalizadas**.
1. Selecione **Editar**.
1. Na página **Editar propagação de tags personalizadas**, selecione **Propagar tags personalizadas automaticamente**
1. Selecione **Submit (Enviar)**.
### Inscreva-se usando o AWS CLI
Para optar pela propagação personalizada de tags usando o AWS CLI, use o `TagPropagation` atributo no e. [CreateDomain[UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html) APIs O valor do campo é `DISABLED` por padrão. Um valor vazio também tem como padrão `DISABLED`. O exemplo a seguir mostra como ativar a propagação de tags personalizadas.
```
aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation ENABLED
```
## Adicionar tags personalizadas
O processo para adicionar a propagação de tags personalizadas difere dependendo se você está adicionando a partir do console ou da AWS CLI.
### Adicione a partir do console
As etapas a seguir descrevem como adicionar tags personalizadas a um domínio a partir do console.
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, selecione **Configurações do administrador**. Em **Configurações do administrador**, selecione **Domínios**.
1. Na página **Domínios**, escolha o domínio ao qual deseja adicionar tags personalizadas.
1. Na página de **detalhes do domínio**, selecione a guia **Configurações do domínio**.
1. Na guia **Configurações do domínio**, navegue até **Tags**.
1. Selecione **Editar**.
1. Na página **Tags**, selecione **Adicionar tag**. Adicione um par de chave e valor para a tag personalizada.
1. Selecione **Salvar**. Essa tag personalizada agora é propagada para os recursos de SageMaker IA criados no domínio.
As etapas a seguir descrevem como adicionar tags personalizadas a um perfil de usuário a partir do console.
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, selecione **Configurações do administrador**. Em **Configurações do administrador**, selecione **Domínios**.
1. Na página **Domínios**, selecione o domínio que contém o perfil de usuário ao qual você deseja adicionar tags personalizadas.
1. Da página **Detalhes do domínio**, selecione a guia **Perfis de usuário**.
1. Na guia **Perfis de usuário**, selecione o perfil de usuário ao qual você deseja adicionar tags personalizadas.
1. Na guia **Detalhes do usuário**, navegue até a seção **Detalhes**.
1. Selecione **Editar**.
1. Na seção **Tags**, selecione **Adicionar tag**. Adicione um par de chave e valor para a tag personalizada.
1. Selecione **Submit (Enviar)**. Essa tag personalizada agora é propagada para os recursos de SageMaker IA criados no domínio.
### Adicione usando o AWS CLI
Depois de ativar a propagação de tags personalizadas, você pode adicionar tags personalizadas usando o AWS CLI no domínio, no perfil do usuário ou no nível do espaço durante a criação ou atualização. O método para adicionar tags personalizadas difere dependendo se você está criando um novo recurso ou adicionando tags a um recurso existente.
O seguinte exemplo mostra como adicionar tags personalizadas no nível do domínio durante a criação:
```
aws sagemaker create-domain \
--domain-name domain-id \
--auth-mode IAM \
--default-user-settings '{"ExecutionRole": "execution-role"}' \
--subnet-ids subnet-id \
--vpc-id vpc-id \
--tags Key=key,Value=value \
--tag-propagation ENABLED
```
Você deve usar a [AddTags](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddTags.html)API para adicionar tags personalizadas para domínio, perfil de usuário e espaços existentes da seguinte maneira.
```
aws sagemaker add-tags \
--resource-arn resource-arn-to-attach-tags \
--tags Key=key, Value=value
```