AWS Protonressources et balises

AWS Protonles ressources auxquelles est attribué un Amazon Resource Name (ARN) 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 mieux les organiser et les identifier. Vous pouvez utiliser les balises pour classer vos ressources par objectif, propriétaire, environnement ou selon d'autres critères. Pour de plus amples informations, consultez Politiques de balisage . Pour suivre et gérer votreAWS Protonressources, vous pouvez utiliser les fonctionnalités de balise décrites dans les sections suivantes.

AWSmarquage

Vous pouvez attribuer des métadonnées à vos ressources AWS sous la forme d'identifications. Chaque balise est constituée d'une clé et d'une valeur facultative. Les balises peuvent vous aider à gérer, identifier, organiser, rechercher et filtrer des ressources.

Important

N'ajoutez pas de données d'identification personnelle (PII) ou d'autres informations confidentielles ou sensibles dans les étiquettes. Les étiquettes accessibles à de nombreux Services AWS, y compris la facturation. Les étiquettes ne sont pas destinées à être utilisées pour des données privées ou sensibles.

Chaque balise se compose de deux parties.

• Une clé de balise (par exemple, CostCenter, Environment ou Project). Les clés de balises sont sensibles à la casse.

• Une valeur de balise (facultative) (par exemple,111122223333ouProduction). Les valeurs de balise sont sensibles à la casse, tout comme les clés de balise.

Les exigences d'utilisation et de désignation basiques suivantes s'appliquent aux balises.

• Chaque ressource peut avoir un maximum de 50 balises créées par l'utilisateur.

  Note

  Les balises créées par le système qui commencent paraws:les préfixes sont réservés àAWSutilisez et ne sont pas prises en compte dans cette limite. Vous ne pouvez pas modifier ou supprimer une balise commençant par le préfixe aws:.

• Pour chaque ressource, chaque clé d'identification doit être unique, et chaque clé d'identification peut avoir une seule valeur.

• La clé de balise doit comporter au minimum 1 caractère et au maximum 128 caractères Unicode en UTF-8.

• La valeur de balise doit être au minimum 1 caractère et au maximum 256 caractères Unicode en UTF-8.

• Les caractères autorisés dans les balises sont les lettres, les lettres, les lettres, les lettres, les lettres, les lettres, les lettres, les lettres, les lettres, les lettres, les lettres, les lettres, les lettres et les lettres

AWS Protonmarquage

avecAWS Proton, vous pouvez utiliser à la fois les balises que vous créez et celles quiAWS Protongénère automatiquement pour vous.

AWS Proton​ AWSbalises gérées

Lorsque vous créez unAWS Protonressource,AWS Protongénère automatiquementAWSbalises gérées pour votre nouvelle ressource comme illustré dans le diagramme suivant.AWSles balises gérées se propagent ensuite vers d'autresAWS Protondes 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.

Note

AWSbalises géréesne sont pasgénéré pour les connexions aux comptes d'environnement. Pour plus d'informations, consultez Connexions aux comptes environnementaux.

Propagation des balises vers les ressources provisionnées

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

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

AWSclé de balise gérée	Clés gérées par le client	Description
aws:proton:account	proton:account	LeAWScompte qui crée et déploieAWS Protonressources.
aws:proton:template	proton:template	L'ARN d'un modèle sélectionné.
aws:proton:environment	proton:environment	L'ARN d'un environnement sélectionné.
aws:proton:service	proton:service	L'ARN d'un service sélectionné.
aws:proton:service-instance	proton:service-instance	L'ARN d'une instance de service sélectionnée.
aws:proton:component	proton:component	L'ARN d'un composant sélectionné.

Voici un exemple deAWStag géré pour unAWS Protonressource.

"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 et qui a été gérée par uneAWSbalise gérée.

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

avecAWS-provisionnement géré,AWS Protonapplique les balises propagées directement aux ressources provisionnées.

avecprovisionnement autogéré,AWS Protonmet à disposition les balises propagées ainsi que les fichiers iAC rendus qu'il soumet dans la pull request (PR) de provisionnement. 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 inclureAWS Protontags dansdefault_tags. Cela se propageAWS Protondes balises vers toutes les ressources provisionnées.

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

Voici le pluginproton_tagsdéfinition de la variable :

proton.environment.variables.tf :

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

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

Voici comment les valeurs de balise 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 vous pouvez ajouterAWS Protondes 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ées par les clients

EACHAWS ProtonLa ressource dispose d'un quota maximum de 50 balises gérées par le client. Les tags gérés par le client sont transmis à l'enfantAWS Protonressources de la même manière queAWSles balises gérées le font, sauf qu'elles ne se propagent pas aux balises existantesAWS Protonaux ressources ou aux ressources mises à disposition. Si vous appliquez une nouvelle étiquette àAWS Protonressource avec des ressources enfants existantes et si 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 ouAWS CLI.

Création de balises via la console et l'interface de ligne

Lorsque vous créez unAWS Protonressource à 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. ChoisissezAjouter un nouveau tag, saisissez la clé et la valeur, puis continuez.

Lorsque vous avez créé une nouvelle ressource en utilisant le pluginAWS Protonconsole, vous pouvez afficher sa liste deAWSbalises gérées et gérées par le client depuis la page détaillée.

Créer ou modifier une balise

1. DansAWS Protonconsole, ouvrez un pluginAWS Protonpage de détail de la ressource où vous pouvez voir une liste de balises.

2. Choisissez Manage tags (Gérer les balises).

3. DansGérer les balisespage, vous pouvez afficher, créer, supprimer et modifier des balises. Vous ne pouvez pas modifierAWSbalises gérées en haut. Toutefois, vous pouvez ajouter et modifier les balises gérées par le client à l'aide de champs d'édition, répertoriés après leAWSbalises gérées.

   ChoisissezAjouter un nouveau tagpour créer une nouvelle balise.

4. Entrez une clé et une valeur pour la nouvelle balise.

5. Pour modifier une balise, entrez une valeur dans le champ de valeur de balise pour la clé sélectionnée.

6. Pour supprimer une balise choisissezSupprimezpour une balise sélectionnée.

7. Lorsque vous avez terminé vos modifications, choisissezEnregistrer les modifications.

Créez des balises en utilisant le pluginAWS Proton​ AWS CLI

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

Vous pouvez créer ou modifier une balise 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 une balise pour une ressource comme illustré 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"