Balisage des ressources

Une balise est une étiquette de métadonnées personnalisée que vous pouvez ajouter à une ressource pour faciliter son identification, son organisation et sa 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 large, tandis qu’une valeur de balise représente un sous-ensemble de cette catégorie. Par exemple, vous pourriez avoir tag key=Color et tag value=Blue, ce qui produirait la paire clé:valeur Color:Blue. Notez que vous pouvez définir la valeur d’une balise sur une chaîne vide, mais que 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.

Dans Amazon Transcribe, vous pouvez étiqueter les ressources suivantes :

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

Pour en savoir plus sur le balisage, notamment sur les meilleures pratiques, consultez les ressources relatives au balisage AWS.

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

Vous pouvez utiliser des balises pour contrôler l'accès au sein de votre Comptes AWS. Pour le contrôle d'accès basé sur des balises, vous fournissez les informations relatives aux balises dans l'élément de condition d'une IAM politique. Vous pouvez ensuite utiliser des balises et leur clé de condition de balise associée pour contrôler l’accès aux éléments suivants :

Pour un exemple de politique de contrôle d’accès basée sur les balises, consultez la section Affichage des tâches de transcription en fonction des balises.

Pour plus d’informations sur le contrôle d’accès basé sur des balises, consultez la section Contrôle de l’accès aux ressources AWS à l’aide de balises.

Ajouter des tags à vos Amazon Transcribe ressources

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

Vous pouvez ajouter, modifier ou supprimer des balises à AWS Management Consolel'AWS CLIaide du ou AWS SDKs; voir les exemples suivants :

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

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

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

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://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = 'amzn-s3-demo-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)