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.
AWS Proton recursos y etiquetado
AWS Proton Los recursos a los que se les asigna un nombre de recurso de Amazon (ARN) incluyen las plantillas de entorno y sus versiones principales y secundarias, las plantillas de servicio y sus versiones principales y secundarias, los entornos, los servicios, las instancias de servicio, los componentes y los repositorios. Puede etiquetar estos recursos como ayuda para identificarlos y organizarlos. Utilice etiquetas para clasificar los recursos según su finalidad, propietario, entorno u otro criterio. Para obtener más información, consulte Estrategias de etiquetado de
AWS etiquetado
Puede asignar metadatos a sus AWS recursos en forma de etiquetas. Cada etiqueta consta de una clave definida por el cliente y un valor opcional. Las etiquetas pueden ayudarle a administrar, identificar, organizar, buscar y filtrar recursos.
importante
No agregue información de identificación personal (PII) ni otra información confidencial en las etiquetas. Las etiquetas son accesibles para muchos Servicios de AWS, incluida la facturación. Las etiquetas no se han diseñado para usarse con información privada o confidencial.
Cada etiqueta de tiene dos partes:
-
Una clave de etiqueta (por ejemplo,
CostCenter
,Environment
, oProject
). Las claves de etiqueta distinguen entre mayúsculas y minúsculas. -
Un valor de etiqueta (opcional) (por ejemplo,
111122223333
oProduction
). Al igual que las claves de etiqueta, los valores de etiqueta distinguen entre mayúsculas y minúsculas.
Los siguientes requisitos básicos de nomenclatura y uso se aplican a las etiquetas.
-
Cada recurso puede tener un máximo de 50 etiquetas creadas por el usuario.
nota
Las etiquetas creadas por el sistema que comienzan con el
aws:
prefijo están reservadas para AWS su uso y no se tienen en cuenta para este límite. No puede editar ni eliminar una etiqueta que comience con el prefijoaws:
. -
Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.
-
La clave de etiqueta debe tener un mínimo de 1 y un máximo de 128 caracteres Unicode en UTF-8.
-
El valor de etiqueta debe ser un mínimo de 1 y un máximo de 256 caracteres Unicode en UTF-8.
-
Los caracteres permitidos en las etiquetas son letras, números y espacios representables en UTF-8, además de los siguientes caracteres:* _ . : / = + - @.
AWS Proton etiquetado
Con AWS Protonél, puedes usar tanto las etiquetas que crees como las que AWS Proton se generan automáticamente para ti.
AWS ProtonAWS etiquetas gestionadas
Al crear un AWS Proton recurso, genera AWS Proton automáticamente etiquetas AWS administradas para el nuevo recurso, como se muestra en el siguiente diagrama. AWS Las etiquetas administradas se propagan posteriormente a otros AWS Proton recursos que se basan en el nuevo recurso. Por ejemplo, las etiquetas administradas de una plantilla de entorno se propagan a sus versiones y las etiquetas administradas de un servicio se propagan a sus instancias de servicio.
nota
AWS las etiquetas administradas no se generan para las conexiones de las cuentas del entorno. Para obtener más información, consulte Conexiones de cuentas de entorno.

Propagación de etiquetas a recursos aprovisionados
Si los recursos aprovisionados, como los definidos en las plantillas de servicio y entorno, admiten el AWS etiquetado, las etiquetas gestionadas se propagan como etiquetas AWS gestionadas por el cliente a los recursos aprovisionados. Estas etiquetas no se propagarán a un recurso aprovisionado que no admita el etiquetado. AWS
AWS Proton aplica etiquetas a los recursos por AWS Proton cuentas, plantillas registradas y entornos implementados, así como por servicios e instancias de servicio, tal como se describe en la siguiente tabla. Puede usar etiquetas AWS administradas para ver y administrar sus AWS Proton recursos, pero no puede modificarlas.
AWS clave de etiqueta administrada | Clave administrada por el cliente propagada | Descripción |
---|---|---|
|
|
La AWS cuenta que crea y despliega AWS Proton los recursos. |
|
|
El ARN de una plantilla seleccionada. |
|
|
El ARN de un entorno seleccionado. |
|
|
El ARN de un servicio seleccionado. |
|
|
El ARN de una instancia de servicio seleccionada. |
|
|
El ARN de un componente seleccionado. |
El siguiente es un ejemplo de una etiqueta AWS administrada para un AWS Proton recurso.
"aws:proton:template" = "arn:aws:proton:
region-id
:account-id
:environment-template/env-template
"
El siguiente es un ejemplo de una etiqueta administrada por el cliente aplicada a un recurso aprovisionado que se propagó desde una etiqueta AWS administrada.
"proton:environment:database" = "arn:aws:proton:
region-id
:account-id
:rds/env-db
"
Con el aprovisionamiento AWS administrado, AWS Proton aplica las etiquetas propagadas directamente a los recursos aprovisionados.
Con el aprovisionamiento autogestionado, AWS Proton permite que las etiquetas propagadas estén disponibles junto con los archivos IaC renderizados que envía en la solicitud de extracción (PR) de aprovisionamiento. Las etiquetas se proporcionan en la variable de mapa de cadenas proton_tags
. Te recomendamos que hagas referencia a esta variable en tu configuración de Terraform para incluirla en ella las etiquetas. AWS Proton default_tags
Esto propaga las etiquetas de AWS Proton
a todos los recursos aprovisionados.
El siguiente ejemplo muestra este método de propagación de etiquetas en una plantilla de Terraform de entorno.
Esta es la definición de la variable proton_tags
:
proton.environment.variables.tf:
variable "environment" { type = object({ inputs = map(string) name = string }) } variable "proton_tags" { type = map(string) default = null }
Así es como se asignan los valores de las etiquetas a esta variable:
proton.auto.tfvars.json:
{
"environment": {
"name": "dev",
"inputs": {
"ssm_parameter_value": "MyNewParamValue"
}
}
"proton_tags" : {
"proton:account" : "123456789012",
"proton:template" : "arn:aws:proton:us-east-1:123456789012:environment-template/fargate-env",
"proton:environment" : "arn:aws:proton:us-east-1:123456789012:environment/dev"
}
}
Y aquí te explicamos cómo puedes agregar AWS Proton etiquetas a tu configuración de Terraform para que se agreguen a los recursos aprovisionados:
# Configure the AWS Provider provider "aws" { region = var.aws_region
default_tags { tags = var.proton_tags }
}
Etiquetas administradas por el cliente
Cada AWS Proton recurso tiene una cuota máxima de 50 etiquetas administradas por el cliente. Las etiquetas administradas por el cliente se propagan a AWS Proton los recursos secundarios de la misma manera que las etiquetas AWS administradas, excepto que no se propagan a AWS Proton los recursos existentes ni a los recursos aprovisionados. Si aplicas una etiqueta nueva a un AWS Proton recurso con recursos secundarios existentes y deseas etiquetar los recursos secundarios existentes con la nueva etiqueta, debes etiquetar cada recurso secundario existente manualmente, mediante la consola o. AWS CLI
Creación de etiquetas mediante la consola y la CLI
Cuando crea un AWS Proton recurso con la consola, tiene la oportunidad de crear etiquetas administradas por el cliente en la primera o segunda página del procedimiento de creación, como se muestra en la siguiente instantánea de la consola. Seleccione Agregar nueva etiqueta e introduzca la clave y el valor.
Tras crear un recurso nuevo mediante la AWS Proton consola, puede ver su lista de etiquetas AWS gestionadas y gestionadas por el cliente en la página de detalles.
Creación o edición de etiquetas
-
En la AWS Proton consola
, abra una página AWS Proton de detalles del recurso en la que podrá ver una lista de etiquetas. -
Elija Administrar etiquetas.
-
En la página Administrar etiquetas, puede ver, crear, eliminar y editar etiquetas. No puede modificar las etiquetas AWS gestionadas que aparecen en la parte superior. Sin embargo, puede añadir y modificar las etiquetas gestionadas por el cliente mediante campos de edición, que aparecen después de las etiquetas AWS gestionadas.
Para crear una etiqueta nueva, elija Agregar nueva etiqueta.
-
Escriba una clave y un valor para la nueva etiqueta.
-
Para editar una etiqueta, introduzca un valor en el campo de valor de la etiqueta para una clave seleccionada.
-
Para eliminar una etiqueta, seleccione Eliminar para una etiqueta seleccionada.
-
Cuando haya completado los cambios, elija Guardar cambios.
Cree etiquetas mediante el AWS ProtonAWS CLI
Puede ver, crear, eliminar y editar etiquetas utilizando el AWS Proton AWS CLI.
También puede crear o editar una etiqueta para un recurso, tal y como se muestra en el siguiente ejemplo.
$
aws proton tag-resource \ --resource-arn "arn:aws:proton:
region-id
:account-id
:service-template/webservice
" \ --tags '[{"key":"mykey1
","value":"myval1
"},{"key":"mykey2
","value":"myval2
"}]'
Puede eliminar una etiqueta de un recurso, como se muestra en el siguiente ejemplo.
$
aws proton untag-resource \ --resource-arn "arn:aws:proton:
region-id
:account-id
:service-template/webservice
" \ --tag-keys '["mykey1
","mykey2
"]'
Puede enumerar las etiquetas de un recurso, como se muestra en el ejemplo final.
$
aws proton list-tags-for-resource \ --resource-arn "arn:aws:proton:
region-id
:account-id
:service-template/webservice
"