Etiquetado de recursos

Una etiqueta es una designación de metadatos personalizada que usted agrega a un recurso para facilitar la identificación, la organización y la búsqueda de recursos. Las etiquetas se componen de dos partes individuales: una clave de etiqueta y un valor de etiqueta. Esto se denomina par key:value.

Una clave de etiqueta normalmente representa una categoría más grande, mientras que un valor de etiqueta representa un subconjunto de esa categoría. Por ejemplo, puede tener la etiqueta Key=Color y la etiqueta Value=Blue, lo que generaría el par clave:valor Color:Blue. Tenga en cuenta de que puede establecer el valor de una etiqueta como una cadena vacía, pero no puede asignarle un valor nulo. Omitir el valor de etiqueta es lo mismo que utilizar una cadena vacía.

En Amazon Transcribe, puedes etiquetar los siguientes recursos:

Las claves de etiquetas pueden tener una longitud máxima de 128 caracteres y los valores de las etiquetas pueden tener una longitud máxima de 256 caracteres; ambas distinguen mayúsculas de minúsculas. Amazon Transcribe admite hasta 50 etiquetas por recurso. Para cada recurso, cada clave de etiqueta debe ser única y sólo puede tener un valor. Tenga en cuenta que las etiquetas no pueden empezar aws: por él porque AWS reserva este prefijo para las etiquetas generadas por el sistema. No puede agregar, modificar ni eliminar etiquetas aws:* y no cuentan para el límite de etiquetas por recurso.

Para obtener más información sobre el etiquetado, incluidas las prácticas recomendadas, consulta los recursos de etiquetado. AWS

Tag-based control de acceso

Puede utilizar etiquetas para controlar el acceso dentro de su Cuentas de AWS. En el caso del control de acceso basado en etiquetas, debe proporcionar la información sobre las etiquetas en el elemento de condición de una IAM política. A continuación, puede utilizar etiquetas y su clave de condición de etiqueta asociada para controlar el acceso a:

Para ver ejemplos de políticas de control de acceso basadas en etiquetas, consulte Visualización de trabajos de transcripción basados en etiquetas.

Para obtener información detallada sobre el control de acceso basado en etiquetas, consulte Control de acceso a recursos de AWS mediante etiquetas.

Añadir etiquetas a su Amazon Transcribe recursos

Puede añadir etiquetas antes o después de ejecutar su Amazon Transcribe trabajo. Con las API Create* y Start* existentes, puede agregar etiquetas a su solicitud de transcripción.

Puede agregar, modificar o eliminar etiquetas mediante Consola de administración de AWS, AWS CLI o los SDK de AWS ; consulte los ejemplos siguientes:

aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--output-bucket-name amzn-s3-demo-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://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
  },
  "OutputBucketName": "amzn-s3-demo-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://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = 'amzn-s3-demo-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)