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.

Entrée Amazon Transcribe, vous pouvez baliser les ressources suivantes :

Les clés de balise peuvent comporter jusqu'à 128 caractères, tandis que les valeurs de balise peuvent en contenir jusqu'à 256. Elles sont sensibles à la casse. 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: parce que AWS réserve ce préfixe pour les 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 la section Balisage AWS ressources.

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 des informations sur les balises dans l'élément de condition d'un 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 des informations plus détaillées sur le contrôle d'accès basé sur des balises, voir Contrôle de l'accès à AWS ressources utilisant des balises.

Ajouter des tags à votre Amazon Transcribe resources

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

Vous pouvez ajouter, modifier ou supprimer des balises à l'aide du AWS Management Console, AWS CLI, 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://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

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://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"
        }
  ]
}

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)