Adición de etiquetas personalizadas a los recursos - Amazon SageMaker AI
Requisitos previosActivación de la propagación de etiquetas personalizadasAdición de etiquetas personalizadas

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 los dominios nuevos creados con la política administrada SageMakerFullAccess o mediante el administrador de roles de SageMaker, el permiso sagemaker:AddTags se rellena previamente.

    • En el caso de los dominios existentes que utilizan políticas personalizadas de AWS Identity and Access Management, debe actualizar las políticas para incluir el permiso sagemaker:AddTags con el fin de permitir 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 la AWS CLI, puede activar 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. Abra la consola de Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.

  2. En el panel de navegación izquierdo, seleccione Configuraciones de administración. En Configuraciones de administración, seleccione Dominios.

  3. En la página Dominios, seleccione el dominio para el que desea activar la propagación de etiquetas personalizadas.

  4. En la página de Detalles del dominio, seleccione la pestaña Configuración del dominio.

  5. En la pestaña Configuración del dominio, vaya a Propagación de etiquetas personalizadas.

  6. Seleccione Editar.

  7. En la página Editar la propagación de etiquetas personalizadas, seleccione Propagar automáticamente las etiquetas personalizadas.

  8. Seleccione Enviar.

Activación mediante la AWS CLI

Para activar la propagación de etiquetas personalizadas mediante la AWS CLI, utilice el atributo TagPropagation en las API CreateDomain y UpdateDomain. 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. Abra la consola de Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.

  2. En el panel de navegación izquierdo, seleccione Configuraciones de administración. En Configuraciones de administración, seleccione Dominios.

  3. En la página Dominios, elija el dominio al que desea añadir etiquetas.

  4. En la página de Detalles del dominio, seleccione la pestaña Configuración del dominio.

  5. En la pestaña Configuración del dominio, vaya a Etiquetas.

  6. Seleccione Editar.

  7. En la página Etiquetas, seleccione Agregar etiqueta. Añada un par clave-valor para la etiqueta personalizada.

  8. Seleccione Guardar. Esta etiqueta personalizada ahora se propaga a los recursos de SageMaker AI creados en el dominio.

Los siguientes pasos describen cómo añadir etiquetas personalizadas a un perfil de usuario desde la consola.

  1. Abra la consola de Amazon SageMaker AI en https://console.aws.amazon.com/sagemaker/.

  2. En el panel de navegación izquierdo, seleccione Configuraciones de administración. En Configuraciones de administración, seleccione Dominios.

  3. En la página Dominios, seleccione el dominio que contiene el perfil de usuario al que desea añadir etiquetas personalizadas.

  4. En la página Detalles del dominio, elija la pestaña Perfiles de usuario.

  5. En la pestaña Perfiles de usuario, seleccione el perfil de usuario al que desea añadir etiquetas personalizadas.

  6. En la pestaña Detalles del usuario, vaya a la sección Detalles.

  7. Seleccione Editar.

  8. En la sección Etiquetas, seleccione Agregar etiqueta. Añada un par clave-valor para la etiqueta personalizada.

  9. Seleccione Enviar. Esta etiqueta personalizada ahora se propaga a los recursos de SageMaker AI creados en el dominio.

Adición mediante la AWS CLI

Una vez que haya activado la propagación de etiquetas personalizadas, puede añadir etiquetas personalizadas mediante la AWS CLI en el dominio, perfil de usuario o espacio durante el proceso de 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 API AddTags para añadir 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