Etiquetado de recursos de - Amazon Transcribe
Control de acceso basado en etiquetasAdición de etiquetas aAmazon Transcribe los recursos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Etiquetado de recursos de

Una etiqueta es una etiqueta de metadatos personalizada que se puede añadir a un recurso para facilitar su identificación, organización y búsqueda en una búsqueda. Las etiquetas se componen de dos partes individuales: una clave de etiqueta y un valor de la 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, podría tener la etiqueta key=color y la etiqueta value=blue, lo que generaría el par clave:valorColor:Blue. Tenga en cuenta 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.

sugerencia

AWS Billing and Cost Managementpuede usar etiquetas para separar sus facturas en categorías dinámicas. Por ejemplo, si agregas etiquetas para representar diferentes departamentos de la empresa, comoDepartment:Sales oDepartment:Legal,AWS puedes proporcionarte una distribución de costos por departamento.

En Amazon Transcribe, se pueden etiquetar los siguientes recursos:

  • Trabajos de transcripción

  • trabajos de transcripción

  • Trabajos de transcripción posterior a la llamada de Call Analytics

  • Vocabulario personalizado

  • Vocabularios médicos personalizados

  • Filtros de vocabulario personalizados

  • Modelos de lenguaje personalizados

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; en ambos casos se distingue entre mayúsculas y minúsculas. Amazon Transcribeadmite hasta 50 etiquetas por recurso. Para un recurso determinado, cada clave de etiqueta ha de ser exclusiva y solo tiene un valor. Tenga en cuenta que las etiquetas no pueden empezaraws: por porqueAWS reserva este prefijo para las etiquetas generadas por el sistema. No puedes añadir, modificar ni eliminaraws:* etiquetas, y no se incluyen en tu tags-per-resource límite.

Operaciones de API específicas para el etiquetado de recursos

ListTagsForResource, TagResource, UntagResource

Para utilizar las API de etiquetado, debe incluir un nombre de recurso de Amazon (ARN) en su solicitud. Los ARN tienen el formatoarn:partition:service:region:account-id:resource-type/resource-id. Por ejemplo, el ARN asociado a un trabajo de transcripción puede parecerse a:arn:aws:transcribe:us-west-2:111122223333:transcription-job/my-transcription-job-name.

Para obtener más información sobre el etiquetado, incluidas las prácticas recomendadas, consulte AWSRecursos sobre etiquetado.

Control de acceso basado en etiquetas

Puede utilizar etiquetas para controlar el acceso dentro de suCuentas de AWS. Para el control de acceso basado en etiquetas, debe proporcionar información de las etiquetas en el elemento de condición de unaIAM política. A continuación, puede utilizar las etiquetas y su clave de condición de etiqueta asociada para controlar el acceso a:

  • Amazon Transcriberecursos de

    • Utilice la clave deaws:ResourceTag/key-name condición para especificar qué par de clave-valor de etiqueta debe asociarse al recurso.

  • Solicitudes: controla las etiquetas que se pueden pasar en una solicitud.

    • Utilice la clave deaws:RequestTag/key-name condición para especificar qué etiquetas se pueden agregar, modificar o eliminar de unIAM usuario o rol.

  • Procesos de autorización: controle el acceso basado en etiquetas para cualquier parte del proceso de autorización.

    • Utilice la clave deaws:TagKeys/ condición para controlar si se pueden utilizar claves de etiqueta específicas en un recurso, en una solicitud o por una entidad principal. En este caso, el valor de clave no importa.

Para ver un ejemplo de política de control de acceso basada en etiquetas, consulteVisualización de trabajos de transcripción basada en etiquetas.

Para obtener información más detallada sobre el control de acceso basado en etiquetas, consulte Control de acceso aAWS recursos mediante etiquetas.

Adición de etiquetas aAmazon Transcribe los recursos

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

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

  1. Inicie sesión en AWS Management Console.

  2. En el panel de navegación, selecciona Trabajos de transcripción y, a continuación, selecciona Crear trabajo (arriba a la derecha). Se abre la página Especificar los detalles del trabajo.

  3. Desplázate hasta la parte inferior de la página Especificar detalles del trabajo para encontrar el cuadro Etiquetas: opcional y selecciona Agregar nueva etiqueta.

    Amazon Transcribecaptura de pantalla de la consola: la página «especificar detalles del trabajo».

  4. Introduzca la información del campo Clave y, si lo desea, del campo Valor.

    Amazon Transcribecaptura de pantalla de la consola: el panel de «etiquetas», que muestra ejemplos de etiquetas.

  5. Rellene cualquier otro campo que desee incluir en la página Especificar detalles del trabajo y, a continuación, seleccione Siguiente. Esto le llevará a la página Configurar trabajo: opcional.

    Selecciona Crear trabajo para ejecutar tu trabajo de transcripción.

  6. Para ver las etiquetas asociadas a un trabajo de transcripción, vaya a la página de trabajos de transcripción, seleccione un trabajo de transcripción y desplácese hasta la parte inferior de la página de información de ese trabajo. Si desea editar las etiquetas, puede hacerlo seleccionando Administrar las etiquetas.

    Amazon Transcribecaptura de pantalla de la consola: el panel de «etiquetas» de la página de información de un trabajo de transcripción.

En este ejemplo se utilizan el start-transcription-jobcomando y elTags parámetro. Para obtener más información, consulte StartTranscriptionJob y 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

Este es otro ejemplo de uso del start-transcription-jobcomando y un cuerpo de solicitud que agrega etiquetas a ese trabajo.

aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://filepath/my-first-tagging-job.json

El archivo my-first-tagging-job.json contiene el siguiente cuerpo de solicitud.

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

En el siguiente ejemplo, se utiliza elAWS SDK for Python (Boto3) para añadir una etiqueta mediante elTags argumento del método start_transcription_job. Para obtener más información, consulte StartTranscriptionJob y Tag.

Para ver más ejemplos de uso deAWS los SDK, incluidos ejemplos de funciones específicas, escenarios y multiservicios, consulte elEjemplos de código para Amazon Transcribe mediante SDK AWS capítulo.

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)