Étiquetage des ressources

Une balise est une étiquette de métadonnées personnalisée que vous pouvez ajouter à une ressource pour faciliter l'identification, l'organisation et la recherche dans une recherche. Les balises sont composées de deux parties distinctes : une clé de balise et une valeur de balise. C'est ce que l'on appelle une paire clé:valeur.

Une clé de balise représente généralement une catégorie plus vaste, tandis qu'une valeur de balise représente un sous-ensemble de cette catégorie. Par exemple, vous pourriez avoir la balise KEY=color et la balise value=blue, qui produiraient la paire clé:valeurColor:Blue. Notez que vous pouvez définir la valeur d'une balise sur une chaîne vide, mais vous ne pouvez pas définir la valeur d'une balise sur null. Omettre la valeur de balise équivaut à l'utilisation d'une chaîne vide.

Astuce

AWS Billing and Cost Managementvous pouvez utiliser des balises pour séparer vos factures en catégories dynamiques. Par exemple, si vous ajoutez des balises pour représenter les différents services de votre entreprise, par exempleDepartment:Sales ouDepartment:Legal, vousAWS pouvez obtenir la répartition des coûts par département.

Dans Amazon Transcribe, vous pouvez baliser les ressources suivantes :

• Emplois de transcription

• Emplois de transcription médicale

• Tâches de transcription post-appel liées à l'analyse des appels

• Vocabulaires personnalisés

• Vocabulaires médicaux personnalisés

• Filtres de vocabulaire personnalisés

• Modèles linguistiques personnalisés

Les clés de balise peuvent comporter jusqu'à 128 caractères et les valeurs de balise peuvent comporter jusqu'à 256 caractères. Amazon Transcribeprend en charge jusqu'à 50 balises par ressource. Pour une ressource donnée, chaque clé de balise doit être unique et comporter une seule valeur. Notez que vos balises ne peuvent pas commencer par,aws:AWS car ce préfixe est réservé aux balises générées par le système. Vous ne pouvez pas ajouter, modifier ou supprimer desaws:* balises, et elles ne sont pas prises en compte dans votre tags-per-resource limite.

Opérations d'API spécifiques au balisage des ressources

ListTagsForResource, TagResource, UntagResource

Pour utiliser les API de balisage, vous devez inclure un nom Amazon Resource Name (ARN) avec votre demande. Les ARN ont le formatarn:partition:service:region:account-id:resource-type/resource-id. Par exemple, l'ARN associé à une tâche de transcription peut ressembler à :arn:aws:transcribe:us-west-2:111122223333:transcription-job/my-transcription-job-name.

Pour en savoir plus sur le balisage, y compris les meilleures pratiques, consultez la section AWSRessources sur le balisage.

Contrôle d'accès basé sur les étiquettes

Vous pouvez utiliser des balises pour contrôler l'accès dans votreComptes AWS. Pour le contrôle d'accès basé sur des balises, vous devez fournir les informations des balises dans l'élément de condition d'uneIAM stratégie. Vous pouvez ensuite utiliser les balises et la clé de condition de balise associée pour contrôler l'accès à :

• Ressources : Contrôler l'accès à vosAmazon Transcribe ressources en fonction des balises que vous avez attribuées à ces ressources.

  • Utilisez la clé deaws:ResourceTag/key-name condition pour spécifier quelle paire clé:valeur de balise doit être attachée à la ressource.

• Demandes : Contrôle les balises qui peuvent être transmises dans une demande.

  • Utilisez la clé deaws:RequestTag/key-name condition pour spécifier quelles balises peuvent être ajoutées, modifiées ou supprimées d'unIAM utilisateur ou rôle.

• Processus d'autorisation : contrôlez l'accès basé sur des balises pour n'importe quelle partie de votre processus d'autorisation.

  • Utilisez la clé deaws:TagKeys/ condition pour contrôler si des clés de balise spécifiques peuvent être utilisées sur une ressource, dans une demande ou par un mandataire. Dans ce cas, la valeur de la clé n'importe pas.

Pour un exemple de stratégie de contrôle d'accès basée sur des balises, consultezAffichage des tâches de transcription basées sur les balises.

Pour plus d'informations sur le contrôle d'accès basé sur des balises, consultez Contrôle de l'accès auxAWS ressources à l'aide de balises.

Ajout de balises à vosAmazon Transcribe ressources

Vous pouvez ajouter des balises avant ou après l'exécution de votreAmazon Transcribe tâche. À l'aide des API Create* et Start* existantes, vous pouvez ajouter des balises à votre demande de transcription.

Vous pouvez ajouter, modifier ou supprimer des balises à l'aide des kits de développement logiciel AWS Management ConsoleAWS CLI, ou AWSdes kits SDK ; consultez les exemples suivants :

AWS Management Console

1. Connectez-vous à AWS Management Console.

2. Dans le volet de navigation, choisissez Tâches de transcription, puis sélectionnez Créer une tâche (en haut à droite). La page Spécifier les détails de la tâche s'ouvre.

3. Accédez au bas de la page Spécifier les détails du poste pour trouver la case Étiquettes - facultative et sélectionnez Ajouter une nouvelle étiquette.

   

4. Entrez les informations pour le champ Clé et, éventuellement, pour le champ Valeur.

   

5. Remplissez tous les autres champs que vous souhaitez inclure sur la page Spécifier les détails du poste, puis sélectionnez Suivant. Vous accédez alors à la page Configurer la tâche - facultative.

   Sélectionnez Créer une tâche pour exécuter votre tâche de transcription.

6. Vous pouvez consulter les balises associées à une tâche de transcription en accédant à la page Tâches de transcription, en sélectionnant une tâche de transcription et en faisant défiler la page d'informations de cette tâche jusqu'en bas. Si vous souhaitez modifier vos balises, vous pouvez le faire en sélectionnant Gérer les balises.

   

AWS CLI

Cet exemple utilise la start-transcription-jobcommande et leTags paramètre. Pour plus d'informations, consultez StartTranscriptionJob et Tag.

aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac \
--output-bucket-name DOC-EXAMPLE-BUCKET \
--output-key my-output-files/ \
--language-code en-US \
--tags Key=color,Value=blue Key=shape,Value=square

Voici un autre exemple utilisant la start-transcription-jobcommande et un corps de requête qui ajoute des balises à cette tâche.

aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://filepath/my-first-tagging-job.json

Le fichier my-first-tagging-job.json contient le corps de requête suivant.

{
  "TranscriptionJobName": "my-first-transcription-job",
  "Media": {
        "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
  },
  "OutputBucketName": "DOC-EXAMPLE-BUCKET",
  "OutputKey": "my-output-files/", 
  "LanguageCode": "en-US",
  "Tags": [ 
        {
           "Key": "color",
           "Value": "blue"
        },
        {
           "Key": "shape",
           "Value": "square"
        }
  ]
}

AWS SDK for Python (Boto3)

L'exemple suivant utilise leAWS SDK for Python (Boto3) pour ajouter une balise à l'aide de l'Tagsargument de la méthode start_transcription_job. Pour plus d'informations, consultez StartTranscriptionJob et Tag.

Pour des exemples supplémentaires d'utilisationAWS des SDK, y compris des exemples spécifiques à des fonctionnalités, des scénarios et des exemples interservices, consultez leExemples de code pour Amazon Transcribe à l'aide de kits de développement logiciel AWS chapitre.

from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-transcription-job"
job_uri = "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = 'DOC-EXAMPLE-BUCKET',
    OutputKey = 'my-output-files/', 
    LanguageCode = 'en-US', 
    Tags = [
        {
            'Key':'color', 
            'Value':'blue'
        }
    ]
)

while True:
    status = transcribe.get_transcription_job(TranscriptionJobName = job_name)
    if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)