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 chiaveaws:ResourceTag/key-name condizione per specificare quale coppia chiave-valore deve essere collegata alla risorsa.

• Risorsa: controlla quali tag possono essere passati in una richiesta.

  • Usa la chiaveaws:RequestTag/key-name condizione per specificare quali tag possono essere aggiunti, modificati o rimossi da unIAM utente o ruolo.

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

  • Usa la chiaveaws: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:

AWS Management Console

1. Accedere alla AWS Management Console.

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

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

   

4. Inserisci le informazioni per il campo Chiave e, facoltativamente, il campo Valore.

   

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

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

   

AWS CLI

Questo esempio utilizza il start-transcription-jobcomando e ilTags parametro. Per ulteriori informazioni, consultare 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 che utilizza il start-transcription-jobcomando e un corpo della richiesta che aggiunge tag a quel lavoro.

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

AWS SDK for Python (Boto3)

L'esempio seguente utilizza ilAWS SDK for Python (Boto3) per aggiungere un tag utilizzando l'Tagsargomento per il metodo start_transcription_job. Per ulteriori informazioni, consultare StartTranscriptionJob 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)