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. # Marquage des ressources Amazon Braket Une *balise* est une étiquette d'attribut personnalisée que vous attribuez ou attribuez à une AWS ressource. AWS Une balise est une *métadonnée* qui en dit plus sur votre ressource. Chaque balise se compose d’une *clé* et d’une *valeur*. Ensemble, ces informations sont qualifiées de *paires clé-valeur*. Pour les balises que vous attribuez, vous définissez la clé et la valeur. Dans la console Amazon Braket, vous pouvez accéder à une tâche quantique ou à un bloc-notes et consulter la liste des balises qui y sont associées. Vous pouvez ajouter un tag, supprimer un tag ou modifier un tag. Vous pouvez étiqueter une tâche quantique ou un bloc-notes lors de sa création, puis gérer les balises associées via la console AWS CLI, ouAPI. **En savoir plus sur AWS les tags** + Pour des informations générales sur le balisage, y compris les conventions de dénomination et d'utilisation, voir [Qu'est-ce que l'éditeur de balises ?](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html) dans le guide de l'utilisateur *des AWS ressources de balisage et de l'éditeur de balises*. + Pour plus d'informations sur les restrictions relatives au balisage, voir [Limites et exigences en matière de dénomination des balises](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices) dans le guide de l'utilisateur * AWS des ressources de balisage et de l'éditeur de balises*. + Pour connaître les meilleures pratiques et les stratégies de balisage, consultez la section [Meilleures pratiques pour le balisage des ressources AWS](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html). + Pour obtenir la liste des services qui prennent en charge l'utilisation de balises, consultez [https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html). Les sections suivantes fournissent des informations plus spécifiques sur les tags pour Amazon Braket. **Topics** + [Utilisation d’étiquettes](#tags) + [Ressources prises en charge pour le balisage dans Amazon Braket](#tag-supported-resources) + [Balisage avec l'Amazon Braket API](#braket-cli-tagging) + [Restrictions de balisage](tag-restrictions.md) + [Gestion des tags dans Amazon Braket](tag-managing.md) + [Exemple de AWS CLI balisage dans Amazon Braket](braket-tags-example.md) ## Utilisation d’étiquettes Les balises peuvent organiser vos ressources en catégories qui vous sont utiles. Par exemple, vous pouvez attribuer une balise « Department » pour indiquer le département propriétaire de cette ressource. Chaque balise se compose de deux parties : + Une clé de balise (par exemple *CostCenter*, *Environnement* ou *Projet*). Les touches de tag distinguent les majuscules et minuscules. + *Champ facultatif appelé valeur de balise (par exemple, *111122223333* ou Production).* 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. Les balises vous aident à effectuer les tâches suivantes : + **Identifiez et organisez vos AWS ressources.** Beaucoup Services AWS prennent en charge le balisage. Vous pouvez donc attribuer le même tag aux ressources provenant de différents services pour indiquer que les ressources sont liées. + **Suivez vos AWS coûts.** Vous activez ces balises sur le AWS Billing and Cost Management tableau de bord. AWS utilise les balises pour classer vos coûts et vous fournir un rapport mensuel de répartition des coûts. Pour plus d’informations, consultez [Utilisation des balises de répartition des coûts](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dans le [Guide de l’utilisateur *AWS Billing and Cost Management *](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html). + **Contrôlez l'accès à vos AWS ressources.** Pour plus d'informations, consultez la section [Contrôle de l'accès à l'aide de balises](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html). ## Ressources prises en charge pour le balisage dans Amazon Braket Le type de ressource suivant dans Amazon Braket prend en charge le balisage : + [https://docs.aws.amazon.com/braket/latest/developerguide/braket-manage-access.html#resources](https://docs.aws.amazon.com/braket/latest/developerguide/braket-manage-access.html#resources) ressource + **Nom de la ressource :** `AWS::Service::Braket` + **ARN Regex :** `arn:${Partition}:braket:${Region}:${Account}:quantum-task/${RandomId}` **Remarque :** vous pouvez appliquer et gérer des balises pour vos blocs-notes Amazon Braket dans la console Amazon Braket, en utilisant la console pour accéder à la ressource du bloc-notes, bien que les blocs-notes soient en fait des ressources Amazon AI. SageMaker Pour plus d'informations, consultez la section [Métadonnées des instances de bloc-notes](https://docs.aws.amazon.com/sagemaker/latest/dg/nbi-metadata.html) dans la SageMaker documentation. ## Balisage avec l'Amazon Braket API + Si vous utilisez Amazon Braket API pour configurer des balises sur une ressource, appelez le. [https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html) `aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tags {\"city\":\"Seattle\"}` + Pour supprimer des balises d'une ressource, appelez le [https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html). `aws braket list-tags-for-resource --resource-arn $YOUR_TASK_ARN` + Pour répertorier toutes les balises associées à une ressource donnée, appelez le [https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html). `aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tag-keys "[\"city\",\"state\"]"` # Restrictions de balisage Les restrictions de base suivantes s'appliquent aux tags figurant sur les ressources Amazon Braket : + Nombre maximum de balises que vous pouvez attribuer à une ressource : 50 + Longueur de clé maximale : 128 caractères Unicode + Longueur de valeur maximale : 256 caractères Unicode + Caractères valides pour la clé et la valeur :`a-z, A-Z, 0-9, space`, et ces caractères : `_ . : / = + -` et `@` + Les clés et les valeurs sont sensibles à la casse. + Ne l'utilisez pas `aws` comme préfixe pour les clés ; il est réservé à l' AWS usage. # Gestion des tags dans Amazon Braket Vous définissez des balises en tant que *propriétés* d'une *ressource*. Vous pouvez consulter, ajouter, modifier, répertorier et supprimer des tags via la console Amazon Braket, Amazon API Braket ou le. AWS CLI Pour plus d'informations, consultez la référence de l'[API Amazon Braket](https://docs.aws.amazon.com/braket/latest/APIReference/Welcome.html). **Topics** + [Ajout de balises](#add-tags) + [Affichage des balises](#view-tags) + [Modification des balises](#edit-tags) + [Suppression de balises](#remove-tags) ## Ajout de balises Vous pouvez ajouter des balises aux ressources étiquetables aux moments suivants : + **Lorsque vous créez la ressource :** utilisez la console ou incluez le `Tags` paramètre dans l'`Create`opération dans l'[AWS API](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html). + **Après avoir créé la ressource :** utilisez la console pour accéder à la tâche quantique ou à la ressource du bloc-notes, ou appelez l'`TagResource`opération dans l'[AWS API](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html). Pour ajouter des balises à une ressource lorsque vous la créez, vous devez également être autorisé à créer une ressource du type spécifié. ## Affichage des balises Vous pouvez consulter les balises de n'importe quelle ressource étiquetable dans Amazon Braket en utilisant la console pour accéder à la tâche ou à la ressource du bloc-notes, ou en appelant l'opération. AWS `ListTagsForResource` API Vous pouvez utiliser la AWS API commande suivante pour afficher les balises d'une ressource : + ** AWS API:** `ListTagsForResource` ## Modification des balises Vous pouvez modifier les balises en utilisant la console pour accéder à la tâche quantique ou à la ressource du bloc-notes ou vous pouvez utiliser la commande suivante pour modifier la valeur d'une balise attachée à une ressource étiquetable. Lorsque vous spécifiez une clé de balise qui existe déjà, la valeur de cette clé est remplacée : + ** AWS API:** `TagResource` ## Suppression de balises Vous pouvez supprimer des balises d'une ressource en spécifiant les clés à supprimer, en utilisant la console pour accéder à la tâche quantique ou à la ressource du bloc-notes, ou lorsque vous appelez l'`UntagResource`opération. + ** AWS API:** `UntagResource` # Exemple de AWS CLI balisage dans Amazon Braket Lorsque vous utilisez le AWS Command Line Interface (AWS CLI) pour interagir avec Amazon Braket, le code suivant est un exemple de commande qui montre comment créer une balise qui s'applique à une tâche quantique que vous créez. Dans cet exemple, la tâche est exécutée sur le simulateur SV1 quantique avec des paramètres définis pour l'unité de traitement Rigetti quantique (QPU). Il est important que dans l'exemple de commande, la balise soit spécifiée à la toute fin, après tous les autres paramètres requis. Dans ce cas, la balise possède une **clé** `state` et une **valeur** de`Washington`. Ces balises pourraient être utilisées pour aider à catégoriser ou à identifier cette tâche quantique particulière. ``` aws braket create-quantum-task --action / "{\"braketSchemaHeader\": {\"name\": \"braket.ir.jaqcd.program\", / \"version\": \"1\"}, / \"instructions\": [{\"angle\": 0.15, \"target\": 0, \"type\": \"rz\"}], / \"results\": null, / \"basis_rotation_instructions\": null}" / --device-arn "arn:aws:braket:::device/quantum-simulator/amazon/sv1" / --output-s3-bucket "my-example-braket-bucket-name" / --output-s3-key-prefix "my-example-username" / --shots 100 / --device-parameters / "{\"braketSchemaHeader\": / {\"name\": \"braket.device_schema.rigetti.rigetti_device_parameters\", / \"version\": \"1\"}, \"paradigmParameters\": / {\"braketSchemaHeader\": / {\"name\": \"braket.device_schema.gate_model_parameters\", / \"version\": \"1\"}, / \"qubitCount\": 2}}" / --tags {\"state\":\”Washington\"} ``` Cet exemple montre comment appliquer des balises à vos tâches quantiques lorsque vous les exécutez dans le AWS CLI, ce qui est utile pour organiser et suivre vos ressources Braket.