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

Las claves de etiquetas pueden tener una longitud de hasta 128 caracteres y los valores de las etiquetas pueden tener una longitud de hasta 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 puedes añadir, modificar ni eliminar aws:* etiquetas, y no se tienen en cuenta para tu límite. tags-per-resource

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

Control de acceso basado en etiquetas

Puedes usar etiquetas para controlar el acceso dentro de tu. 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 Amazon Transcribe los recursos

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

Puede añadir, modificar o eliminar etiquetas mediante AWS Management ConsoleAWS CLI, o AWS SDKs; consulte los siguientes ejemplos:

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)