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à.
Assegnazione di tag alle risorse
Un tag è un'etichetta di metadati personalizzata aggiunta a una risorsa per semplificare l'identificazione, l'organizzazione e la ricerca in una ricerca. I tag sono composti da due parti singole: una chiave di tag e un valore di tag. Questa è denominata 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 potresti avere il tag key=color e il tag value=blue, che produrrebbero la coppia chiave:valoreColor:Blue
. Nota che puoi 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 Managementpuoi usare i tag per separare le tue fatture in categorie dinamiche. Ad esempio, se aggiungi tag per rappresentare diversi reparti della tua azienda, ad esempioDepartment:Sales
oDepartment:Legal
,AWS puoi fornirti la distribuzione dei costi per reparto.
In Amazon Transcribe è possibile applicare tag alle seguenti risorse:
Lavori di trascrizione
Lavori di trascrizione medica
Lavori di trascrizione post-chiamata di Call Analytics
Vocabolari Personalizza
Vocabolari medici personalizzati
Filtri di vocabolario personalizzati
Modelli linguistici personalizzati
Le chiavi di tag possono essere composti da un massimo di 128 caratteri e i valori di tag possono essere composti da un massimo di 256 caratteri; entrambi fanno distinzione tra maiuscole e minuscole. Amazon Transcribesupporta fino a 50 tag per risorsa. Per una risorsa, ogni chiave del tag deve essere univoca con un solo valore. Tieni presente che i tag non possono iniziare conaws:
perchéAWS riserva questo prefisso ai tag generati dal sistema. Non puoi aggiungere, modificare o eliminare iaws:*
tag e questi non vengono conteggiati ai fini del tuo tags-per-resource limite.
Operazioni API specifiche per l'etichettatura delle risorse
ListTagsForResource
,
TagResource
,
UntagResource
Per utilizzare le API di Tagging delle tag, devi includere un Amazon Resource Name (ARN) nella richiesta. Gli ARN hanno il formatoarn:partition:service:region:account-id:resource-type/resource-id
. Ad esempio, l'ARN associato a un processo di trascrizione può assomigliare a:arn:
.aws
:transcribe:us-west-2
:111122223333
:transcription-job/my-transcription-job-name
Per ulteriori informazioni sull'etichettatura, comprese le best practice, consulta AWSRisorse per l'etichettatura.
Controllo degli accessi basato su tag
Puoi utilizzare i tag per controllare gli accessi all'interno delAccount AWS. Per il controllo degli accessi basato su tag, devi fornire informazioni sui tag nell'elemento condizione di unaIAM policy. È quindi possibile utilizzare i tag e la chiave di condizione tag associata per controllare gli accessi a:
Risorse: controlla gli accessi alleAmazon Transcribe risorse in base ai tag assegnati a tali risorse.
Usa la chiave
aws:ResourceTag/
condizione per specificare quale coppia chiave-valore deve essere collegata alla risorsa.key-name
Risorsa: controlla quali tag possono essere passati in una richiesta.
Usa la chiave
aws:RequestTag/
condizione per specificare quali tag possono essere aggiunti, modificati o rimossi da unIAM utente o ruolo.key-name
Processi di autorizzazione: controlla l'accesso basato su tag per qualsiasi parte del processo di autorizzazione.
Usa la chiave
aws:TagKeys/
condizione per controllare se chiavi di tag specifiche possono essere utilizzate su una risorsa, in una richiesta oppure da un principale. In questo caso, il valore chiave non è importante.
Per un esempio di policy di controllo dell'accesso basate su tag, consultaVisualizzazione dei processi di trascrizione in base ai tag.
Per informazioni più dettagliate sul controllo degli accessi basato su tag, consulta Controllo degliAWS accessi basato su tag.
Aggiungere tag alleAmazon Transcribe risorse
È possibile aggiungere tag prima o dopo l'esecuzione delAmazon Transcribe lavoro. Utilizzando le API Create* e Start* esistenti, puoi aggiungere tag alla tua richiesta di trascrizione.
È possibile aggiungere, modificare o eliminare i tag utilizzando AWS Management ConsoleAWS CLI, o AWSgli SDK; consulta quanto segue per gli esempi:
-
Accedere alla AWS Management Console
. -
Nel riquadro di navigazione, scegli Lavori di trascrizione, quindi seleziona Crea lavoro (in alto a destra). Si apre la pagina Specifica i dettagli del lavoro.
-
Scorri fino alla fine della pagina Specifica i dettagli del lavoro per trovare la casella Tag - opzionale e seleziona Aggiungi nuovo tag.
-
Inserisci le informazioni per il campo Chiave e, facoltativamente, il campo Valore.
-
Compila tutti gli altri campi che desideri includere nella pagina Specifica i dettagli del lavoro, quindi seleziona Avanti. Si accede alla pagina Configura job (opzionale).
Seleziona Crea lavoro per eseguire il processo di trascrizione.
-
Puoi visualizzare i tag associati a un lavoro di trascrizione accedendo alla pagina Lavori di trascrizione, selezionando un lavoro di trascrizione e scorrendo fino alla fine della pagina delle informazioni di quel lavoro. Se si desidera modificare i tag, è possibile farlo selezionando Gestione tag.
Questo esempio utilizza il start-transcription-jobTags
parametro. Per ulteriori informazioni, consultare StartTranscriptionJob
e Tag
.
aws transcribe start-transcription-job \ --region
us-west-2
\ --transcription-job-namemy-first-transcription-job
\ --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET
/my-input-files
/my-media-file
.flac
\ --output-bucket-nameDOC-EXAMPLE-BUCKET
\ --output-keymy-output-files
/ \ --language-codeen-US
\ --tags Key=color
,Value=blue
Key=shape
,Value=square
Ecco un altro esempio che utilizza il start-transcription-job
aws transcribe start-transcription-job \ --region
us-west-2
\ --cli-input-json file://filepath
/my-first-tagging-job.json
Il my-first-tagging-jobfile.json contiene il seguente corpo della 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 ilAWS SDK for Python (Boto3) per aggiungere un tag utilizzando l'Tags
argomento per il metodo start_transcription_jobStartTranscriptionJob
e Tag
.
Per ulteriori esempi di utilizzo degliAWS SDK, inclusi esempi specifici per funzionalità, scenari e interservizi, consulta ilEsempi di codice per Amazon Transcribe tramite SDK AWS capitolo.
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)