Applicazione di tag alle risorse - Amazon Transcribe

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Applicazione di tag alle risorse

Un tag è un'etichetta di metadati personalizzata che puoi aggiungere a una risorsa per semplificarne l'identificazione, l'organizzazione e l'individuazione in una ricerca. I tag sono costituiti da due parti: una chiave di tag e un valore di tag. Queste compongono una coppia chiave:valore.

Una chiave di tag rappresenta in genere una categoria più ampia, mentre un valore di tag rappresenta un sottoinsieme di quella categoria. Ad esempio, tag key=Color e tag value=Blue produrrebbero la coppia chiave-valore Color:Blue. Tieni presente che è possibile impostare il valore di un tag su una stringa vuota, ma non su null. Non specificare il valore del tag equivale a utilizzare una stringa vuota.

Suggerimento

AWS Billing and Cost Management puoi utilizzare i tag per separare le fatture in categorie dinamiche. Ad esempio, se aggiungi tag per rappresentare diversi reparti all'interno dell'azienda, come Department:Sales oDepartment:Legal, AWS può fornirti la distribuzione dei costi per reparto.

In Amazon Transcribe, puoi taggare le seguenti risorse:

  • Processi di trascrizione

  • Processi di trascrizione medica

  • Vocabolari personalizzati

  • Vocabolari medici personalizzati

  • Filtri di vocabolario personalizzati

  • Modelli linguistici personalizzati

Le chiavi di tag possono avere una lunghezza massima di 128 caratteri e i valori di tag di 256 caratteri; entrambi distinguono tra minuscole e maiuscole. Amazon Transcribe supporta fino a 50 tag per risorsa. Per una determinata risorsa, ciascuna chiave di tag deve essere univoca e avere un solo valore. Nota che i tuoi tag non possono iniziare con aws: perché AWS riserva questo prefisso per i tag generati dal sistema. Non puoi aggiungere, modificare o eliminare aws:* tag e non rientrano nel tuo limite. tags-per-resource

APIoperazioni specifiche per l'etichettatura delle risorse

ListTagsForResource, TagResource, UntagResource

Per utilizzare i tagAPIs, devi includere un Amazon Resource Name (ARN) nella tua richiesta. ARNshanno il formatoarn:partition:service:region:account-id:resource-type/resource-id. Per esempio, quello ARN associato a un lavoro di trascrizione potrebbe assomigliare a:. arn:aws:transcribe:us-west-2:111122223333:transcription-job/my-transcription-job-name

Per ulteriori informazioni sui tag, comprese le migliori pratiche, consulta Tagging AWS risorse.

Controllo degli accessi basato su tag

È possibile utilizzare i tag per controllare l'accesso all'interno del Account AWS. Per il controllo degli accessi basato su tag, fornisci le informazioni sui tag nell'elemento condition di un IAM politica. Puoi quindi utilizzare i tag e la chiave di condizione tag associata per controllare l'accesso a:

  • Risorse: controlla l'accesso al tuo Amazon Transcribe risorse in base ai tag che hai assegnato a tali risorse.

    • Utilizza la chiave di condizione aws:ResourceTag/key-name per specificare quale coppia chiave-valore deve essere collegata alla risorsa.

  • Richiesta: controlla quali tag possono essere trasferiti in una richiesta .

    • Usa la chiave aws:RequestTag/key-name condition per specificare quali tag possono essere aggiunti, modificati o rimossi da un IAM utente o ruolo.

  • Processi di autorizzazione: controlla l'accesso basato sui tag per qualsiasi parte del processo di autorizzazione.

    • Utilizza la chiave di condizione aws:TagKeys/ per controllare se specifiche chiavi di tag possono essere utilizzate su una risorsa, in una richiesta o da un principale. In questo caso, il valore chiave non è importante.

Per un esempio di policy di controllo dell'accesso basato sui tag, consulta Visualizzazione dei processi di trascrizione in base ai tag.

Per informazioni più dettagliate sul controllo degli accessi basato su tag, consulta Controllo dell'accesso a AWS risorse che utilizzano tag.

Aggiungere tag al tuo Amazon Transcribe risorse

Puoi aggiungere tag prima o dopo aver eseguito il Amazon Transcribe lavoro. Utilizzando gli esistenti Create* e Start*APIs, puoi aggiungere tag alla tua richiesta di trascrizione.

È possibile aggiungere, modificare o eliminare i tag utilizzando il AWS Management Console, AWS CLI, oppure AWS SDKs; vedi quanto segue per alcuni esempi:

  1. Accedere a AWS Management Console.

  2. Nel riquadro di navigazione, scegli Processi di trascrizione, quindi seleziona Crea processo (in alto a destra). Si aprirà la pagina Specifica i dettagli del processo.

  3. Scorri fino alla fine della pagina Specifica i dettagli del processo per trovare la casella Tag - opzionale e seleziona Aggiungi nuovo tag.

    Amazon Transcribe schermata della console: la pagina «specifica i dettagli del lavoro».
  4. Inserisci le informazioni per il campo Chiave e, facoltativamente, per il campo Valore.

    Amazon Transcribe schermata della console: il pannello 'tags', che mostra tag di esempio.
  5. Compila tutti i campi che desideri includere nella pagina Specifica i dettagli del processo, quindi seleziona Avanti. Verrà visualizzata la pagina Configura processo - opzionale.

    Seleziona Crea processo per eseguire il processo di trascrizione.

  6. Puoi visualizzare i tag associati a un processo di trascrizione accedendo alla pagina Processi di trascrizione, selezionando un processo di trascrizione e scorrendo fino alla fine della pagina delle informazioni di quel processo. Se desideri modificare i tag, puoi farlo selezionando Gestisci tag.

    Amazon Transcribe schermata della console: il pannello «tag» nella pagina delle informazioni di un processo di trascrizione.

Questo esempio utilizza il start-transcription-jobcomando e il parametro. Tags Per ulteriori informazioni, consulta StartTranscriptionJob e 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

Ecco un altro esempio di utilizzo del start-transcription-jobcomando e un corpo della richiesta che aggiunge tag a quel processo.

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

Il file my-first-tagging-job.json contiene il seguente corpo di richiesta.

{ "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" } ] }

L'esempio seguente utilizza AWS SDK for Python (Boto3) per aggiungere un tag utilizzando l'Tagsargomento per il metodo start_transcription_job. Per ulteriori informazioni, consulta StartTranscriptionJob e Tag.

Per ulteriori esempi utilizzando il AWS SDKs, inclusi esempi specifici di funzionalità, scenari e servizi multipli, consulta il capitolo. Esempi di codice per l'utilizzo di Amazon Transcribe AWS SDKs

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)