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 clave-valor.

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, se pueden etiquetar los siguientes recursos:

Las claves de etiqueta pueden tener una longitud de hasta 128 caracteres y los valores de etiqueta pueden tener una longitud de hasta 256 caracteres; ambas distinguen entre mayúsculas y 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 sus etiquetas no pueden empezar por aws: 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 las prácticas recomendadas para el etiquetado, consulte Etiquetado de recursos AWS.

Control de acceso basado en etiquetas

Puede usar etiquetas para controlar el acceso dentro de su Cuentas de AWS. Para controlar el acceso según las etiquetas, debe proporcionar información de las etiquetas en el elemento de condición de una política de IAM. 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.

Agregar etiquetas a sus recursos de Amazon Transcribe

Puede agregar etiquetas antes o después de ejecutar su trabajo en Amazon Transcribe. 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)