Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Adición de etiquetas personalizadas a los recursos
En la página siguiente, se muestran los pasos necesarios para utilizar la propagación de etiquetas personalizadas. La propagación de etiquetas personalizadas requiere los siguientes pasos:
+ Activación de la propagación de etiquetas personalizadas
+ Adición de etiquetas personalizadas a los recursos
Al activar la propagación de etiquetas personalizadas en un dominio existente, la propagación de etiquetas no funciona para las aplicaciones existentes hasta que se reinicia la aplicación. Del mismo modo, las etiquetas no se actualizan en un recurso existente cuando se añaden nuevas etiquetas personalizadas. Por ejemplo, supongamos que un dominio tiene dos etiquetas y que un usuario crea un recurso en ese dominio. El recurso tendría entonces dos etiquetas. Si se añadiera una etiqueta nueva al dominio, esa nueva etiqueta no se añadiría al recurso existente. Sin embargo, cualquier recurso nuevo que se creara tendría la nueva etiqueta asociada al recurso.
## Requisitos previos
+ Los usuarios deben tener el permiso `sagemaker:AddTags` para crear cualquier recurso.
+ En el caso de los dominios nuevos creados con la política `SageMakerFullAccess` gestionada o mediante el administrador de SageMaker funciones, el `sagemaker:AddTags` permiso se rellena previamente.
+ En el caso de los dominios existentes que utilizan AWS Identity and Access Management políticas personalizadas, debe actualizar las políticas para incluir el `sagemaker:AddTags` permiso que permita a los usuarios crear recursos.
## Activación de la propagación de etiquetas personalizadas
El proceso para activar la propagación de etiquetas personalizadas varía en función de si lo hace desde la consola o desde la AWS CLI. Desde la consola, solo puede activar la propagación de etiquetas personalizadas al actualizar un dominio existente. Desde allí AWS CLI, puedes optar por la propagación de etiquetas personalizadas al crear un dominio o actualizar un dominio existente.
### Activación desde la consola
Los siguientes pasos describen cómo activar la propagación de etiquetas personalizadas desde la consola. Solo puede activar la propagación de etiquetas personalizadas desde la consola al actualizar un dominio existente.
1. Abre la consola Amazon SageMaker AI en [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. En el panel de navegación izquierdo, seleccione **Configuraciones de administración**. En **Configuraciones de administración**, seleccione **Dominios**.
1. En la página **Dominios**, seleccione el dominio para el que desea activar la propagación de etiquetas personalizadas.
1. En la página de **Detalles del dominio**, seleccione la pestaña **Configuración del dominio**.
1. En la pestaña **Configuración del dominio**, vaya a **Propagación de etiquetas personalizadas**.
1. Seleccione **Editar**.
1. En la página **Editar la propagación de etiquetas personalizadas**, seleccione **Propagar automáticamente las etiquetas personalizadas**.
1. Seleccione **Enviar**.
### Inscríbase mediante el AWS CLI
Para optar por la propagación de etiquetas personalizadas mediante el AWS CLI, utilice el `TagPropagation` atributo que aparece en y. [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 El valor predeterminado de este campo es `DISABLED`. Un valor vacío también es de forma predeterminada `DISABLED`. En el siguiente ejemplo, se demuestra cómo activar la propagación de etiquetas personalizadas.
```
aws sagemaker update-domain \
--domain-id domain-id \
--region region \
--tag-propagation ENABLED
```
## Adición de etiquetas personalizadas
El proceso para añadir la propagación de etiquetas personalizadas varía en función de si se añade desde la consola o desde la AWS CLI.
### Adición desde la consola
Los siguientes pasos describen cómo añadir etiquetas personalizadas a un dominio desde la consola.
1. Abre la consola Amazon SageMaker AI en [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. En el panel de navegación izquierdo, seleccione **Configuraciones de administración**. En **Configuraciones de administración**, seleccione **Dominios**.
1. En la página **Dominios**, elija el dominio al que desea añadir etiquetas.
1. En la página de **Detalles del dominio**, seleccione la pestaña **Configuración del dominio**.
1. En la pestaña **Configuración del dominio**, vaya a **Etiquetas**.
1. Seleccione **Editar**.
1. En la página **Etiquetas**, seleccione **Agregar etiqueta**. Añada un par clave-valor para la etiqueta personalizada.
1. Seleccione **Guardar**. Esta etiqueta personalizada ahora se propaga a los recursos de SageMaker IA creados en el dominio.
Los siguientes pasos describen cómo añadir etiquetas personalizadas a un perfil de usuario desde la consola.
1. Abre la consola Amazon SageMaker AI en [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. En el panel de navegación izquierdo, seleccione **Configuraciones de administración**. En **Configuraciones de administración**, seleccione **Dominios**.
1. En la página **Dominios**, seleccione el dominio que contiene el perfil de usuario al que desea añadir etiquetas personalizadas.
1. En la página **Detalles del dominio**, elija la pestaña **Perfiles de usuario**.
1. En la pestaña **Perfiles de usuario**, seleccione el perfil de usuario al que desea añadir etiquetas personalizadas.
1. En la pestaña **Detalles del usuario**, vaya a la sección **Detalles**.
1. Seleccione **Editar**.
1. En la sección **Etiquetas**, seleccione **Agregar etiqueta**. Añada un par clave-valor para la etiqueta personalizada.
1. Seleccione **Enviar**. Esta etiqueta personalizada ahora se propaga a los recursos de SageMaker IA creados en el dominio.
### Añádala mediante el AWS CLI
Una vez que haya activado la propagación de etiquetas personalizadas, puede añadir etiquetas personalizadas AWS CLI a nivel de dominio, perfil de usuario o espacio durante la creación o actualización. El método para añadir etiquetas personalizadas varía en función de si se crea un recurso nuevo o se añaden etiquetas a un recurso existente.
En el siguiente ejemplo, se muestra cómo añadir etiquetas personalizadas en el dominio durante el proceso de creación.
```
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
```
Debe usar la [AddTags](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddTags.html)API para agregar etiquetas personalizadas para el dominio, el perfil de usuario y los espacios existentes de la siguiente manera.
```
aws sagemaker add-tags \
--resource-arn resource-arn-to-attach-tags \
--tags Key=key, Value=value
```