Aviso de fin de soporte: el 7 de octubre de 2026, AWS finalizará el soporte para AWS Proton. Después del 7 de octubre de 2026, ya no podrás acceder a la AWS Proton consola ni a AWS Proton los recursos. La infraestructura implementada permanecerá intacta. Para obtener más información, consulte la Guía AWS Proton de desaprobación y migración del servicio.

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 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 . Para realizar un seguimiento de sus recursos de AWS Proton y administrarlos, puede utilizar las características de etiquetado que se describen en las siguientes secciones.

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 ayudar a administrar, identificar, organizar, buscar y filtrar recursos de .

AWS Proton etiquetado

Con AWS Proton, puedes usar tanto las etiquetas que creas como las que AWS Proton se generan automáticamente para ti.

AWS Proton​ AWS etiquetas administradas

Al crear un AWS Proton recurso, genera AWS Proton automáticamente etiquetas AWS administradas para el nuevo recurso, tal y 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.

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 administradas se propagan como etiquetas AWS administradas 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 sus recursos por AWS Proton cuentas, plantillas registradas y entornos implementados, así como por servicios e instancias de servicio, tal y como se describe en la tabla siguiente. Puedes usar etiquetas AWS administradas para ver y administrar tus AWS Proton recursos, pero no puedes modificarlas.

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"

A continuación se muestra un ejemplo de una etiqueta gestionada por el cliente aplicada a un recurso aprovisionado que se propagó desde una etiqueta AWS gestionada.

"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 hace que las etiquetas propagadas estén disponibles junto con los archivos IaC renderizados que envía en la solicitud de extracción de aprovisionamiento (PR). Las etiquetas se proporcionan en la variable de mapa de cadenas proton_tags. Le recomendamos que haga referencia a esta variable en su configuración de Terraform para incluir etiquetas en ella. 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 así es como 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 quieres que los recursos secundarios existentes se etiqueten 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 creas un AWS Proton recurso mediante la consola, tienes la oportunidad de crear etiquetas administradas por el cliente en la primera o en la segunda página del procedimiento de creación, tal y 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 nuevo recurso con la AWS Proton consola, puedes ver su lista de etiquetas AWS gestionadas y gestionadas por clientes en la página de detalles.

Cree etiquetas mediante el AWS Proton​ AWS CLI

Puede ver, crear, eliminar y editar etiquetas mediante 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"