Avis de fin de support : le 7 octobre 2026, AWS le support pour AWS Proton. Après le 7 octobre 2026, vous ne pourrez plus accéder à la AWS Proton console ni aux AWS Proton ressources. Votre infrastructure déployée restera intacte. Pour plus d'informations, consultez le Guide AWS Proton de dépréciation et de migration des services.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS Proton ressources et balisage

AWS Proton les ressources auxquelles un Amazon Resource Name (ARN) est attribué incluent les modèles d'environnement et leurs versions majeures et mineures, les modèles de service et leurs versions majeures et mineures, les environnements, les services, les instances de service, les composants et les référentiels. Vous pouvez baliser ces ressources pour vous aider à les organiser et à les identifier. Vous pouvez utiliser des balises pour classer les ressources en fonction de leur objectif, de leur propriétaire, de leur environnement ou d'autres critères. Pour de plus amples informations, consultez Politiques de balisage . Pour suivre et gérer vos AWS Proton ressources, vous pouvez utiliser les fonctionnalités de balisage décrites dans les sections suivantes.

AWS balisage

Vous pouvez attribuer des métadonnées à vos AWS ressources sous forme de balises. Chaque étiquette se compose d'une clé définie par le client et d'une valeur facultative. Les balises peuvent vous aider à gérer, identifier, organiser, rechercher et filtrer des ressources.

AWS Proton balisage

Avec AWS Proton, vous pouvez utiliser à la fois les balises que vous créez et celles qui AWS Proton sont générées automatiquement pour vous.

AWS Proton​ AWS balises gérées

Lorsque vous créez une AWS Proton ressource, génère AWS Proton automatiquement des balises AWS gérées pour votre nouvelle ressource, comme indiqué dans le schéma suivant. AWS les balises gérées se propagent ensuite à d'autres AWS Proton ressources basées sur votre nouvelle ressource. Par exemple, les balises gérées d'un modèle d'environnement se propagent vers ses versions, et les balises gérées d'un service se propagent vers ses instances de service.

Propagation des balises vers les ressources provisionnées

Si les ressources provisionnées, telles que celles définies dans les modèles de service et d'environnement, prennent en charge le AWS balisage, les balises gérées se propagent sous forme de balises AWS gérées par le client vers les ressources provisionnées. Ces balises ne seront pas propagées vers une ressource provisionnée qui ne prend pas en charge AWS le balisage.

AWS Proton applique des balises à vos ressources par AWS Proton comptes, modèles enregistrés et environnements déployés, ainsi que par services et instances de service, comme décrit dans le tableau suivant. Vous pouvez utiliser des balises AWS gérées pour afficher et gérer vos AWS Proton ressources, mais vous ne pouvez pas les modifier.

Voici un exemple de balise AWS gérée pour une AWS Proton ressource.

"aws:proton:template" = "arn:aws:proton:region-id:account-id:environment-template/env-template"

Voici un exemple de balise gérée par le client appliquée à une ressource provisionnée qui a été propagée à partir d'une balise AWS gérée.

"proton:environment:database" = "arn:aws:proton:region-id:account-id:rds/env-db"

Avec AWS-managed provisioning, AWS Proton applique les balises propagées directement aux ressources provisionnées.

Avec le provisionnement autogéré, AWS Proton met à disposition les balises propagées ainsi que les fichiers IaC rendus qu'il soumet dans la pull request (PR) de provisioning. Les balises sont fournies dans la variable de type string mapproton_tags. Nous vous recommandons de faire référence à cette variable dans votre configuration Terraform pour y inclure des AWS Proton balises. default_tags Cela propage les AWS Proton balises à toutes les ressources provisionnées.

L'exemple suivant montre cette méthode de propagation de balises dans un modèle d'environnement Terraform.

Voici la définition de la proton_tags variable :

proton.environnement.variables.tf :

variable "environment" {
  type = object({
    inputs = map(string)
    name = string
  })
}

variable "proton_tags" {
  type = map(string)
  default = null
}

Voici comment les valeurs des balises sont attribuées à cette 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"
  }
}

Et voici comment ajouter des AWS Proton balises à votre configuration Terraform afin qu'elles soient ajoutées aux ressources provisionnées :

# Configure the AWS Provider
provider "aws" {
  region = var.aws_region
  default_tags {
    tags = var.proton_tags
  }
}

Tags gérés par le client

Chaque AWS Proton ressource dispose d'un quota maximum de 50 balises gérées par le client. Les balises gérées par le client se propagent aux AWS Proton ressources enfants de la même manière que les balises AWS gérées, sauf qu'elles ne se propagent pas aux AWS Proton ressources existantes ou aux ressources provisionnées. Si vous appliquez une nouvelle étiquette à une AWS Proton ressource contenant des ressources enfants existantes et que vous souhaitez que les ressources enfants existantes soient balisées avec la nouvelle balise, vous devez baliser chaque ressource enfant existante manuellement, à l'aide de la console ou AWS CLI.

Création de balises à l'aide de la console et de la CLI

Lorsque vous créez une AWS Proton ressource à l'aide de la console, vous avez la possibilité de créer des balises gérées par le client sur la première ou la deuxième page de la procédure de création, comme indiqué dans la capture d'écran de console suivante. Choisissez Ajouter une nouvelle étiquette, entrez la clé et la valeur, puis continuez.

Après avoir créé une nouvelle ressource à l'aide de la AWS Proton console, vous pouvez consulter sa liste de balises AWS gérées et gérées par le client sur la page détaillée.

Créez des balises à l'aide du AWS Proton​ AWS CLI

Vous pouvez afficher, créer, supprimer et modifier des balises à l'aide du AWS Proton AWS CLI.

Vous pouvez créer ou modifier une étiquette pour une ressource, comme illustré dans l'exemple suivant.

$ 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"}]'

Vous pouvez supprimer un tag pour une ressource comme indiqué dans l'exemple suivant.

$ aws proton untag-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
    --tag-keys '["mykey1","mykey2"]'

Vous pouvez répertorier les balises d'une ressource comme indiqué dans le dernier exemple.

$ aws proton list-tags-for-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice"