Mise en file d'attente des offres d'emploi

Grâce à la mise en file d'attente des tâches, vous pouvez soumettre plus de demandes de transcription que celles qui peuvent être traitées simultanément. Sans mise en file d'attente des tâches, une fois que vous avez atteint le quota de demandes simultanées autorisées, vous devez attendre qu'une ou plusieurs demandes soient terminées avant d'en soumettre une nouvelle.

La mise en file d'attente des tâches est facultative pour les demandes de transcription. La mise en file d'attente des tâches est automatiquement activée pour les demandes d'analyse post-appel.

Si vous activez la mise en file d'attente des tâches,Amazon Transcribe crée une file d'attente contenant toutes les demandes dépassant votre limite. Dès qu'une demande est terminée, une nouvelle demande est retirée de votre file d'attente et traitée. Les demandes en file d'attente sont traitées dans un ordre FIFO (premier entré, premier sorti).

Vous pouvez ajouter jusqu'à 10 tâches sur simple demande de tâches à la demande de tâches. Si vous dépassez cette limite, vous obtenez uneLimitExceededConcurrentJobException erreur. Pour maintenir des performances optimales,Amazon Transcribe n'utilisez que 90 % de votre quota (soit un ratio de bande passante de 0,9) pour traiter les tâches en file d'attente. Notez que ce sont des valeurs par lots qui peuvent être augmentés sur simple demande.

Astuce

Vous trouverez une liste des limites et des quotas par défaut pour lesAmazon Transcribe ressources dans la RéférenceAWS générale. Certaines de tâches par lots peuvent être augmentés sur simple demande.

Si vous activez la mise en file d'attente des tâches sans dépasser le quota de demandes simultanées, toutes les demandes sont traitées simultanément.

Activde tâches

Vous pouvez activer la mise en file d'attente des tâches à l'aide AWSdes kits SDK AWS Management ConsoleAWS CLI, ou. Consultez les exemples suivants ; 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. Dans la zone Paramètres de la Job, vous trouverez un panneau de paramètres supplémentaires. Si vous agrandissez ce panneau, vous pouvez sélectionner la case Ajouter à la file d'attente des tâches pour activer la mise en file d'attente des tâches.

   

4. 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.

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

AWS CLI

Cet exemple utilise la start-transcription-jobcommande et lejob-execution-settings paramètre avec leAllowDeferredExecution sous-paramètre. Notez que lorsque vous incluezAllowDeferredExecution dans votre demande, vous devez également inclureDataAccessRoleArn.

Pour plus d'informations, consultez StartTranscriptionJob et JobExecutionSettings.

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 \
--job-execution-settings AllowDeferredExecution=true,DataAccessRoleArn=arn:aws:iam::111122223333:role/ExampleRole

Voici un autre exemple d'utilisation de la start-transcription-jobcommande et d'un corps de requête qui permet la mise en file d'attente.

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

Le fichier my-first-queueing-request.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",
  "JobExecutionSettings": {
        "AllowDeferredExecution": true,
        "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
  }
}

AWS SDK for Python (Boto3)

Cet exemple utilise leAWS SDK for Python (Boto3) pour activer la mise en file d'attente des tâches à l'aide de l'AllowDeferredExecutionargument de la méthode start_transcription_job. Notez que lorsque vous incluezAllowDeferredExecution dans votre demande, vous devez également inclureDataAccessRoleArn. Pour plus d'informations, consultez StartTranscriptionJob et JobExecutionSettings.

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-queueing-request"
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', 
    JobExecutionSettings = {
        'AllowDeferredExecution': True,
        'DataAccessRoleArn': 'arn:aws:iam::111122223333:role/ExampleRole'
   }
)

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)

Vous pouvez consulter la progression d'une tâche en file d'attente via leAWS Management Console ou en soumettant une GetTranscriptionJobdemande. Lorsqu'une tâche est en file d'attente, elle l'StatusestQUEUED. Le statut passe àIN_PROGRESS une fois que le traitement de votre tâche commence, puis passe àCOMPLETED ouFAILED lorsque le traitement est terminé.