Etiquetado de recursos en AWS Database Migration Service

Puede utilizar etiquetas en AWS Database Migration Service (AWS DMS) para agregar metadatos a los recursos. Además, puede usar estas etiquetas junto con políticas de AWS Identity and Access Management (IAM) para administrar el acceso a los recursos de AWS DMS y controlar qué acciones se pueden aplicar a los recursos de AWS DMS. Por último, estas etiquetas se pueden utilizar para hacer un seguimiento de costos, agrupando los gastos correspondientes a recursos con etiqueta similar.

Todos los recursos de AWS DMS pueden etiquetarse:

• Certificados

• Proveedores de datos

• Migraciones de datos

• Puntos de conexión

• Suscripciones de eventos

• Perfiles de instancias

• Proyectos de migración

• Instancias de replicación

• Grupos de subredes de replicación

• Tareas de replicación

Una etiquetaa de AWS DMS es un pare nombre-valor que define y asocia a un recurso de AWS DMS. El nombre es la clave. Si lo desea puede proporcionar un valor para la clave o no. También puede usar etiquetas para asignar información arbitraria a un recurso de AWS DMS. Las claves de etiqueta podrían utilizarse, por ejemplo, para definir una categoría, y el valor de la etiqueta podría ser un elemento dentro de esa categoría. Por ejemplo, puede definir una clave de etiqueta “proyecto” y un valor de etiqueta “Salix” para indicar que el recurso de AWS DMS va asignado al proyecto Salix. También puede usar etiquetas para designar recursos de AWS DMS para pruebas o para producción a través de una clave como entorno=prueba o entorno=producción. Se recomienda utilizar un conjunto coherente de claves de etiqueta que facilite el seguimiento de los metadatos asociados a los recursos de AWS DMS.

Puede usar etiquetas para organizar la factura de AWS de modo que refleje su propia estructura de costos. Para ello, inscríbase para obtener una factura de Cuenta de AWS que incluya valores de clave de etiquetas. A continuación, para ver los costos de los recursos combinados, organice la información de facturación de acuerdo con los recursos con los mismos valores de clave de etiquetas. Por ejemplo, puede etiquetar varios recursos con un nombre de aplicación específico y luego organizar su información de facturación para ver el costo total de la aplicación en distintos servicios. Para obtener más información, consulte Uso de etiquetas de asignación de costos en la Guía del usuario de AWS Billing.

Cada recurso de AWS DMS tiene un conjunto de etiquetas con todas las etiquetas asignadas a ese recurso de AWS DMS. Un conjunto de etiquetas puede contener hasta diez etiquetas o puede estar vacío. Si agrega una etiqueta a un recurso de AWS DMS con la misma clave que una etiqueta existente en el recurso, el nuevo valor sobrescribirá al antiguo.

AWS no aplica ningún significado semántico a las etiquetas, que se interpretan estrictamente como cadenas de caracteres. AWS DMS podría definir etiquetas en un recurso de AWS con arreglo a la configuración utilizada al crear el recurso.

En la siguiente lista se describen las características de una etiqueta de AWS DMS.

• La clave de la etiqueta es el nombre obligatorio de la etiqueta. El valor de la cadena puede tener una longitud de entre 1 y 128 caracteres Unicode y no puede llevar los prefijos "aws:" ni "dms:". La cadena puede contener únicamente los siguientes caracteres del conjunto Unicode: letras, dígitos, espacio en blanco, '_', '.', '/', '=', '+', '-' (regex Java: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

• El valor de etiqueta es un valor de cadena optativo en la etiqueta. El valor de cadena puede tener una longitud de entre 1 y 256 caracteres Unicode y no puede llevar los prefijos "aws:" ni "dms:". La cadena puede contener únicamente los siguientes caracteres del conjunto Unicode: letras, dígitos, espacio en blanco, '_', '.', '/', '=', '+', '-' (regex Java: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$").

  Los valores no deben ser únicos dentro de un conjunto de etiquetas y también pueden ser nulos. Por ejemplo, puede tener un par clave-valor en un conjunto de etiquetas en proyecto/Trinity y centro-de-costos/Trinity.

Puede utilizar la AWS CLI o la API de AWS DMS para agregar, mostrar y eliminar etiquetas de los recursos de AWS DMS. Si utiliza la AWS CLI o la API de AWS DMS, deberá proporcionar el nombre de recurso de Amazon (ARN) correspondiente al recurso de AWS DMS con el que desee trabajar. Para obtener más información sobre cómo crear un ARN, consulte Creación de un nombre de recurso de Amazon (ARN) para AWS DMS.

Tenga en cuenta que las etiquetas se almacenan en caché con fines de autorización. Por este motivo, cuando se actualizan o se agregan valores a las etiquetas de recursos de AWS DMS, pueden tardar varios minutos en estar disponibles.

API

Puede agregar, mostrar o eliminar etiquetas para una recurso de AWS DMS utilizando la API de AWS DMS.

• Para agregar una etiqueta a un recurso de AWS DMS, utilice la operación AddTagsToResource.

• Para mostrar las etiquetas asignadas a un recurso de AWS DMS, utilice la operación ListTagsForResource.

• Para eliminar etiquetas de un recurso de AWS DMS, utilice la operación RemoveTagsFromResource.

Para obtener más información acerca de cómo crear el ARN requerido, consulte Creación de un nombre de recurso de Amazon (ARN) para AWS DMS.

Cuando se trabaja con XML mediante la API de AWS DMS, las etiquetas utilizan el esquema siguiente:

<Tagging>
  <TagSet>
  	<Tag>
  		<Key>Project</Key>
  		<Value>Trinity</Value>
  	</Tag>
  	<Tag>
  		<Key>User</Key>
  		<Value>Jones</Value>
  	</Tag>
  </TagSet>
</Tagging> 

La tabla siguiente proporciona una lista de las etiquetas XML permitidas y sus características. Tenga en cuenta que los valores de clave y de valor distinguen entre mayúsculas y minúsculas. Por ejemplo, proyecto=Trinity y PROYECTO=Trinity son dos etiquetas diferentes.

Elemento de etiquetado	Descripción
TagSet	Los conjuntos de etiquetas contienen todas las etiquetas asignadas a un recurso de Amazon RDS. Solo puede haber un conjunto de etiquetas por recurso. Solo puede trabajar con conjuntos de etiquetas a través de la API de AWS DMS.
Tag	Las etiquetas son pares clave-valor que define el usuario. En un conjunto de etiquetas puede haber entre 1 y 10 etiquetas.
Key	La clave es el nombre obligatorio de la etiqueta. El valor de cadena puede tener una longitud entre 1 y 128 caracteres Unicode y no puede llevar los prefijos "aws:" ni "dms:". La cadena solo puede contener el conjunto de letras Unicode, dígitos, espacio en blanco, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"). Las claves deben ser únicas dentro de un conjunto de etiquetas. Por ejemplo, en un conjunto de etiquetas no puede haber claves iguales pero con valores diferentes, como proyecto/Trinity y proyecto/Xanadu.
Valor	El valor es la parte opcional de la etiqueta. El valor de cadena puede tener una longitud entre 1 y 256 caracteres Unicode y no puede llevar los prefijos "aws:" ni "dms:". La cadena solo puede contener el conjunto de letras Unicode, dígitos, espacio en blanco, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"). Los valores no deben ser únicos dentro de un conjunto de etiquetas y también pueden ser nulos. Por ejemplo, puede tener un par clave-valor en un conjunto de etiquetas en proyecto/Trinity y centro-de-costos/Trinity.