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 de
aws:ResourceTag/
condición para especificar qué par de clave-valor de etiqueta debe asociarse al recurso.key-name
Solicitudes: controla las etiquetas que se pueden pasar en una solicitud.
Utilice la clave de
aws:RequestTag/
condición para especificar qué etiquetas se pueden agregar, modificar o eliminar de unIAM usuario o rol.key-name
Procesos de autorización: controle el acceso basado en etiquetas para cualquier parte del proceso de autorización.
Utilice la clave de
aws: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:
-
Inicie sesión en AWS Management Console
. -
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.
-
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.
-
Introduzca la información del campo Clave y, si lo desea, del campo Valor.
-
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.
-
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.
En este ejemplo se utilizan el start-transcription-jobTags
parámetro. Para obtener más información, consulte StartTranscriptionJob
y Tag
.
aws transcribe start-transcription-job \ --region
us-west-2
\ --transcription-job-namemy-first-transcription-job
\ --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET
/my-input-files
/my-media-file
.flac
\ --output-bucket-nameDOC-EXAMPLE-BUCKET
\ --output-keymy-output-files
/ \ --language-codeen-US
\ --tags Key=color
,Value=blue
Key=shape
,Value=square
Este es otro ejemplo de uso del start-transcription-job
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_jobStartTranscriptionJob
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)