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.
# Etiquetar sus recursos AWS Cloud Map
Una etiqueta es una etiqueta que se asigna a un AWS recurso. Cada etiqueta está formada por una *clave* y un *valor* opcional, ambos definidos por el usuario.
Las etiquetas te permiten clasificar tus AWS recursos, por ejemplo, por su propósito, propietario o entorno. Cuando tenga muchos recursos del mismo tipo, puede identificar rápidamente un recurso específico en función de las etiquetas que le haya asignado. Por ejemplo, puedes definir un conjunto de etiquetas para tus AWS Cloud Map servicios que te ayuden a realizar un seguimiento del propietario y del nivel de pila de cada servicio. Le recomendamos que diseñe un conjunto coherente de claves de etiqueta para cada tipo de recurso.
Además, las etiquetas no se asignan a los recursos automáticamente. Después de agregar una etiqueta, puede editar las claves y los valores de las etiquetas o eliminar etiquetas de un recurso en cualquier momento. Si elimina un recurso, también se eliminará cualquier etiqueta asignada a dicho recurso.
Las etiquetas no tienen ningún significado semántico AWS Cloud Map y se interpretan estrictamente como una cadena de caracteres. Puede establecer el valor de una etiqueta como una cadena vacía, pero no puede asignarle un valor nulo. Si añade una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al antiguo.
Puede trabajar con etiquetas mediante la Consola de administración de AWS AWS CLI, la y la AWS Cloud Map API.
Si utilizas AWS Identity and Access Management (IAM), puedes controlar qué usuarios de tu AWS cuenta tienen permiso para crear, editar o eliminar etiquetas.
## Cómo se etiquetan los recursos
Puede etiquetar AWS Cloud Map espacios de nombres y servicios nuevos o existentes.
Si utilizas la AWS Cloud Map consola, puedes aplicar etiquetas a los recursos nuevos cuando se creen o a los recursos existentes en cualquier momento mediante la pestaña **Etiquetas** de la página de recursos correspondiente.
Si utilizas la AWS Cloud Map API, el SDK o un AWS SDK AWS CLI, puedes aplicar etiquetas a los nuevos recursos mediante el `tags` parámetro de la acción de API correspondiente o a los recursos existentes mediante la acción de la [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html)API. Para obtener más información, consulte [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html).
Además, algunas acciones de creación de recursos le permiten especificar etiquetas para un recurso al crearlo. Si no se pueden aplicar etiquetas durante la creación del recurso, el proceso de creación de recursos falla. Esto garantiza que los recursos que pretendía etiquetar en el momento de su creación se creen con etiquetas específicas o no se creen en absoluto. Si etiqueta recursos en el momento de su creación, no es necesario ejecutar scripts de etiquetado personalizados después de la creación del recurso.
En la siguiente tabla se describen los AWS Cloud Map recursos que se pueden etiquetar y los recursos que se pueden etiquetar al crearlos.
**Soporte de etiquetado para los recursos AWS Cloud Map**
| Recurso | Admite etiquetas | Admite la propagación de etiquetas | Admite el etiquetado en el momento de la creación (AWS Cloud Map API AWS CLI, AWS SDK) |
| --- | --- | --- | --- |
| AWS Cloud Map espacios de nombres | Sí | No. Las etiquetas del espacio de nombres no se propagan a ningún otro recurso asociado al espacio de nombres. | Sí |
| AWS Cloud Map servicios | Sí | No. Las etiquetas de servicio no se propagan a ningún otro recurso asociado al servicio. | Sí |
## Restricciones
Se aplican las siguientes restricciones básicas a las etiquetas:
+ Número máximo de etiquetas para cada recurso: 50.
+ Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.
+ Longitud máxima de la clave: 128 caracteres Unicode en UTF-8
+ Longitud máxima del valor: 256 caracteres Unicode en UTF-8
+ Si su esquema de etiquetado se usa en varios AWS servicios y recursos, recuerde que otros servicios pueden tener restricciones en cuanto a los caracteres permitidos. Los caracteres permitidos generalmente son: letras, números y espacios representables en UTF-8, además de los siguientes caracteres: \$1 - = . \$1 : / @.
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
+ No utilices `aws:``AWS:`, ni ninguna combinación de mayúsculas o minúsculas, como prefijo para las claves o los valores, ya que está reservado para su uso. AWS Las claves y valores de etiquetas que tienen este prefijo no se pueden editar. Las etiquetas con este prefijo no se tienen en cuenta para el límite. tags-per-resource
# Actualizar las etiquetas de los recursos AWS Cloud Map
Usa los siguientes AWS CLI comandos u operaciones de AWS Cloud Map API para agregar, actualizar, enumerar y eliminar las etiquetas de tus recursos.
**Soporte de etiquetado para los recursos AWS Cloud Map**
| Tarea | Acción de la API | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| Agregar o sobrescribir una o varias etiquetas. | [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html) | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/tag-resource.html) | [Agregar- Etiquetar SDResource](https://docs.aws.amazon.com/powershell/v4/reference/items/Add-SDResourceTag.html) |
| Eliminar una o varias etiquetas. | [UntagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_UntagResource.html) | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/untag-resource.html) | [Eliminar SDResource etiqueta](https://docs.aws.amazon.com/powershell/v4/reference/items/Remove-SDResourceTag.html) |
| Enumerar las etiquetas de un recurso | [ListTagsForResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListTagsForResource.html) | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-tags-for-resource.html) | [Obtener- SDResource Etiqueta](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-SDResourceTag.html) |
Los siguientes ejemplos muestran cómo agregar o quitar etiquetas a los recursos mediante la AWS CLI.
**Ejemplo 1: Etiquetar un recurso existente**
El siguiente comando etiqueta un recurso existente.
```
aws servicediscovery tag-resource --resource-arn resource_ARN --tags team=devs
```
**Ejemplo 2: Eliminar la etiqueta de un recurso existente**
El siguiente comando elimina una etiqueta de un recurso existente.
```
aws servicediscovery untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**Ejemplo 3: enumerar etiquetas de un recurso**
El siguiente comando enumera las etiquetas asociadas a un recurso existente.
```
aws servicediscovery list-tags-for-resource --resource-arn resource_ARN
```
Algunas acciones de creación de recursos le permiten especificar etiquetas al crear el recurso. Las siguientes acciones admiten etiquetado durante la creación.
| Tarea | Acción de la API | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| Crear un espacio de nombres de HTTP | [CreateHttpNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateHttpNamespace.html) | [create-http-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-http-namespace.html) | [Nuevo: SDHttp espacio de nombres](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDHttpNamespace.html) |
| Crear un espacio de nombres privado basado en DNS | [CreatePrivateDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePrivateDnsNamespace.html) | [create-private-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-private-dns-namespace.html) | [Nuevo- SDPrivate DnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPrivateDnsNamespace.html) |
| Crear un espacio de nombres público basado en DNS | [CreatePublicDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePublicDnsNamespace.html) | [create-public-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-public-dns-namespace.html) | [Nuevo- SDPublic DnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPublicDnsNamespace.html) |
| Crear un servicio | [CreateService](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html) | [create-service](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-service.html) | [Nuevo- SDService](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDService.html) |