Balisage des ressources de connexions - Console Outils pour développeur
Ressources de balisage (console)Ressources de tags (CLI)

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.

Balisage des ressources de connexions

Une balise est une étiquette d'attribut personnalisée que vous attribuez ou AWS assignez à une AWS ressource. Chaque AWS étiquette comporte deux parties :

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

  • Un champ facultatif appelé valeur de balise (par exemple, 111122223333, Production ou le nom d’une équipe). Omettre la valeur de balise équivaut à l’utilisation d’une chaîne vide. Les valeurs de balise sont sensibles à la casse, tout comme les clés de balise.

Ensemble, ces informations sont qualifiées de paires clé-valeur.

Vous pouvez utiliser la console ou le CLI pour baliser les ressources.

Vous pouvez étiqueter les types de ressources suivants dans AWS CodeConnections :

  • Connexions

  • Hôtes

Ces étapes supposent que vous avez déjà installé une version récente AWS CLI ou que vous avez déjà mis à jour la version actuelle. Pour plus d’informations, consultez Installation d’ AWS CLI dans le Guide de l’utilisateur AWS Command Line Interface .

Outre l'identification, l'organisation et le suivi de votre ressource à l'aide de balises, vous pouvez utiliser des balises dans les politiques AWS Identity and Access Management (IAM) pour contrôler qui peut consulter votre ressource et interagir avec elle. Pour obtenir des exemples de stratégies d'accès basées sur les balises, consultez Utilisation de balises pour contrôler l'accès aux AWS CodeConnections ressources.

Ressources de balisage (console)

Vous pouvez utiliser la console pour ajouter, mettre à jour ou supprimer des balises sur une ressource de connexion.

Ajouter des balises à une ressource de connexion (console)

Vous pouvez utiliser la console pour ajouter des balises à une connexion ou un hôte existant.

Note

Lorsque vous créez une connexion pour un fournisseur installé tel qu' GitHubEnterprise Server, et qu'une ressource hôte est également créée pour vous, les balises lors de la création sont ajoutées à la connexion uniquement. Cela vous permet d'étiqueter un hôte séparément si vous souhaitez le réutiliser pour une nouvelle connexion. Si vous souhaitez ajouter des balises à l'hôte, suivez les étapes ci-dessous.

Pour ajouter des balises à une connexion

  1. Connectez-vous à la console . Choisissez Paramètres dans le volet de navigation.

  2. Sous Settings (Paramètres), choisissez Connections (Connexions). Choisissez l'onglet Connections (Connexions).

  3. Choisissez la connexion que vous souhaitez modifier. La page des paramètres de connexion s'affiche.

  4. Sous Connection tags (Balises de connexion), choisissez Edit (Modifier). La page Modifier les balises de connexion s'affiche.

  5. Dans les champs Clé et Valeur, entrez une paire de clés pour chaque ensemble de balises que vous souhaitez ajouter. (Le champ Valeur est facultatif.) Par exemple, dans Clé, saisissez Project. Dans Value (Valeur), entrez ProjectA.

    Connection tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.

  6. (Facultatif) Choisissez Add tag (Ajouter une balise) pour ajouter d'autres lignes et saisir d'autres balises.

  7. Sélectionnez Envoyer. Les balises sont répertoriées sous les paramètres de connexion.

Pour ajouter des balises à un hôte

  1. Connectez-vous à la console . Choisissez Paramètres dans le volet de navigation.

  2. Sous Settings (Paramètres), choisissez Connections (Connexions). Cliquez sur l'onglet Hosts (Hôtes).

  3. Choisissez l'hôte que vous voulez modifier. La page des paramètres d'hôte s'affiche.

  4. Sous Host tags (Balises d'hôte), choisissez Edit (Modifier). La page Balises d'hôte s'affiche.

  5. Dans les champs Clé et Valeur, entrez une paire de clés pour chaque ensemble de balises que vous souhaitez ajouter. (Le champ Valeur est facultatif.) Par exemple, dans Clé, saisissez Project. Dans Value (Valeur), entrez ProjectA.

    Edit Host tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.

  6. (Facultatif) Choisissez Add tag (Ajouter une balise) pour ajouter d'autres lignes et saisir d'autres balises pour un hôte.

  7. Sélectionnez Envoyer. Les balises sont répertoriées sous les paramètres d'hôte.

Affichage des balises d'une ressource de connexion (console)

Vous pouvez utiliser la console pour afficher les balises des ressources existantes.

Pour ajouter les balises d'une connexion

  1. Connectez-vous à la console . Choisissez Paramètres dans le volet de navigation.

  2. Sous Settings (Paramètres), choisissez Connections (Connexions). Choisissez l'onglet Connections (Connexions).

  3. Choisissez la connexion que vous souhaitez afficher. La page des paramètres de connexion s'affiche.

  4. Sous Connection tags (Balises de connexion), affichez les balises de connexion dans les colonnes Key (Clé) et Value (Valeur).

Pour afficher les balises d'un hôte

  1. Connectez-vous à la console . Choisissez Paramètres dans le volet de navigation.

  2. Sous Settings (Paramètres), choisissez Connections (Connexions). Cliquez sur l'onglet Hosts (Hôtes).

  3. Choisissez l'hôte que vous souhaitez afficher.

  4. Sous Host tags (Balises d'hôte), affichez les balises d'hôte dans les colonnes Key (Clé) et Value (Valeur).

Modifier les balises d'une ressource de connexion (console)

Vous pouvez utiliser la console pour modifier les balises qui ont été ajoutées aux ressources de connexion.

Pour modifier les balises d'une connexion

  1. Connectez-vous à la console . Choisissez Paramètres dans le volet de navigation.

  2. Sous Settings (Paramètres), choisissez Connections (Connexions). Choisissez l'onglet Connections (Connexions).

  3. Choisissez la connexion que vous souhaitez modifier. La page des paramètres de connexion s'affiche.

  4. Sous Connection tags (Balises de connexion), choisissez Edit (Modifier). La page Balises de connexion s'affiche.

  5. Dans les champs Clé et Valeur, mettez à jour les valeurs dans chaque champ selon vos besoins. Par exemple, pour la clé Project, dans Valeur, remplacez ProjectA par ProjectB.

  6. Sélectionnez Envoyer.

Pour modifier les balises d'un hôte

  1. Connectez-vous à la console . Choisissez Paramètres dans le volet de navigation.

  2. Sous Settings (Paramètres), choisissez Connections (Connexions). Cliquez sur l'onglet Hosts (Hôtes).

  3. Choisissez l'hôte que vous voulez modifier. La page des paramètres d'hôte s'affiche.

  4. Sous Host tags (Balises d'hôte), choisissez Edit (Modifier). La page Balises d'hôte s'affiche.

  5. Dans les champs Clé et Valeur, mettez à jour les valeurs dans chaque champ selon vos besoins. Par exemple, pour la clé Project, dans Valeur, remplacez ProjectA par ProjectB.

  6. Sélectionnez Envoyer.

Supprimer des balises d'une ressource de connexion (console)

Vous pouvez utiliser la console pour supprimer des balises des ressources de connexion. Lorsque vous supprimez des balises de la ressource associée, les balises sont supprimées.

Pour supprimer les balises d'une connexion

  1. Connectez-vous à la console . Choisissez Paramètres dans le volet de navigation.

  2. Sous Settings (Paramètres), choisissez Connections (Connexions). Choisissez l'onglet Connections (Connexions).

  3. Choisissez la connexion que vous souhaitez modifier. La page des paramètres de connexion s'affiche.

  4. Sous Connection tags (Balises de connexion), choisissez Edit (Modifier). La page Balises de connexion s'affiche.

  5. En regard de la clé et de la valeur de chaque balise que vous souhaitez supprimer, choisissez Supprimer la balise.

  6. Sélectionnez Envoyer.

Pour supprimer les balises d'un hôte

  1. Connectez-vous à la console . Choisissez Paramètres dans le volet de navigation.

  2. Sous Settings (Paramètres), choisissez Connections (Connexions). Cliquez sur l'onglet Hosts (Hôtes).

  3. Choisissez l'hôte que vous voulez modifier. La page des paramètres d'hôte s'affiche.

  4. Sous Host tags (Balises d'hôte), choisissez Edit (Modifier). La page Balises d'hôte s'affiche.

  5. En regard de la clé et de la valeur de chaque balise que vous souhaitez supprimer, choisissez Supprimer la balise.

  6. Sélectionnez Envoyer.

Ressources de tags (CLI)

Vous pouvez utiliser le CLI pour afficher, ajouter, mettre à jour ou supprimer des balises sur une ressource de connexion.

Ajouter des balises à une ressource de connexion (CLI)

Vous pouvez utiliser le AWS CLI pour étiqueter les ressources dans les connexions.

Sur le terminal ou sur la ligne de commande, exécutez la tag-resource commande en spécifiant le nom de ressource Amazon (ARN) de la ressource à laquelle vous souhaitez ajouter des balises, ainsi que la clé et la valeur de la balise que vous souhaitez ajouter. Vous pouvez ajouter plusieurs balises.

Pour ajouter des balises à une connexion

  1. ARNObtenez-en pour votre ressource. Utilisez la list-connections commande indiquée dans Affichage de la liste des connexions pour obtenir la connexionARN.

  2. Dans le terminal ou la ligne de commande, exécutez la commande tag-resource.

    Par exemple, utilisez la commande suivante pour baliser une connexion avec deux balises, une clé de balise nommée Project avec la valeur de balise de ProjectA, et une clé de balise nommée ReadOnly avec la valeur de balise de true.

    aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true

    Si elle aboutit, cette commande ne renvoie rien.

Pour ajouter des balises à un hôte

  1. ARNObtenez-en pour votre ressource. Utilisez la list-hosts commande indiquée dans Liste des hôtes pour obtenir l'hôteARN.

  2. Dans le terminal ou la ligne de commande, exécutez la commande tag-resource.

    Par exemple, utilisez la commande suivante pour étiqueter un hôte avec deux balises, une clé de balise nommée Project avec la valeur de balise de ProjectA, et une clé de balise nommée IscontainerBased avec la valeur de balise de true.

    aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true

    Si elle aboutit, cette commande ne renvoie rien.

Afficher les balises d'une ressource de connexion (CLI)

Vous pouvez utiliser le AWS CLI pour afficher les AWS balises d'une ressource de connexion. Si aucune balise n’a été ajoutée, la liste renvoyée est vide. Utilisation de la commande list-tags-for-resource pour afficher les balises qui ont été ajoutées à une connexion ou à un hôte.

Pour ajouter les balises d'une connexion

  1. ARNObtenez-en pour votre ressource. Utilisez la list-connections commande indiquée dans Affichage de la liste des connexions pour obtenir la connexionARN.

  2. Dans le terminal ou la ligne de commande, exécutez la commande list-tags-for-resource. Par exemple, utilisez la commande suivante pour afficher une liste de clés de balise et de valeurs de balise pour une connexion.

    aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f

    Cette commande renvoie les balises associées à la ressource. Cet exemple montre deux paires clé/valeur renvoyées pour une connexion.

    {
    "Tags": [
        {
            "Key": "Project",
            "Value": "ProjectA"
        },
        {
            "Key": "ReadOnly",
            "Value": "true"
        }
    ]
}
Pour afficher les balises d'un hôte

  1. ARNObtenez-en pour votre ressource. Utilisez la list-hosts commande indiquée dans Liste des hôtes pour obtenir l'hôteARN.

  2. Dans le terminal ou la ligne de commande, exécutez la commande list-tags-for-resource. Par exemple, utilisez la commande suivante pour afficher une liste de clés de balise et de valeurs de balise pour un hôte.

    aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605

    Cette commande renvoie les balises associées à la ressource. Cet exemple montre deux paires clé/valeur renvoyées pour un hôte.

    {
    "Tags": [
        {
            "Key": "IscontainerBased",
            "Value": "true"
        },
        {
            "Key": "Project",
            "Value": "ProjectA"
        }
    ]
}

Modifier les balises d'une ressource de connexions (CLI)

Vous pouvez utiliser le AWS CLI pour modifier le tag d'une ressource. Vous pouvez modifier la valeur d'une clé existante ou ajouter une autre clé.

Sur le terminal ou sur la ligne de commande, exécutez la tag-resource commande en spécifiant ARN la ressource sur laquelle vous souhaitez mettre à jour une balise, ainsi que la clé de balise et la valeur de balise à mettre à jour.

Lorsque vous modifiez des balises, toutes les clés de balise non spécifiées seront conservées, tandis que tout ce qui a la même clé, mais une nouvelle valeur sera mis à jour. Les nouvelles clés ajoutées avec la commande de modification sont ajoutées en tant que nouvelle paire clé/valeur.

Pour modifier les balises d'une connexion

  1. ARNObtenez-en pour votre ressource. Utilisez la list-connections commande indiquée dans Affichage de la liste des connexions pour obtenir la connexionARN.

  2. Dans le terminal ou la ligne de commande, exécutez la commande tag-resource.

    Dans cet exemple, la valeur de la clé Project est remplacée par ProjectB.

    aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB

    Si elle aboutit, cette commande ne renvoie rien. Pour vérifier quelles balises sont associées à la connexion, exécutez la commande list-tags-for-resource.

Pour modifier les balises d'un hôte

  1. ARNObtenez-en pour votre ressource. Utilisez la list-hosts commande indiquée dans Liste des hôtes pour obtenir l'hôteARN.

  2. Dans le terminal ou la ligne de commande, exécutez la commande tag-resource.

    Dans cet exemple, la valeur de la clé Project est remplacée par ProjectB.

    aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB

    Si elle aboutit, cette commande ne renvoie rien. Pour vérifier quelles balises sont associées à l'hôte, exécutez la commande list-tags-for-resource.

Supprimer les balises d'une ressource de connexion (CLI)

Procédez comme suit pour utiliser le AWS CLI pour supprimer une balise d'une ressource. Lorsque vous supprimez des balises de la ressource associée, les balises sont supprimées.

Note

Si vous supprimez une ressource de connexions, toutes les associations de balises sont effacées de la ressource supprimée. Vous n'avez pas besoin d'effacer les balises avant de supprimer une ressource de connexion.

Sur le terminal ou sur la ligne de commande, exécutez la untag-resource commande en spécifiant ARN la ressource sur laquelle vous souhaitez supprimer les balises et la clé de balise de la balise que vous souhaitez supprimer. Par exemple, pour supprimer plusieurs balises sur une connexion à l'aide des clés de balise Project and ReadOnly, utilisez la commande suivante.

aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys Project ReadOnly

Si elle aboutit, cette commande ne renvoie rien. Pour vérifier les balises associées à la ressource, exécutez la commande list-tags-for-resource. La sortie indique que toutes les balises ont été supprimées.

{
    "Tags": []
}