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
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.
**sugerencia**
Administración de facturación y costos de AWS puede usar etiquetas para separar sus facturas en categorías dinámicas. Por ejemplo, si agrega etiquetas para representar diferentes departamentos de su empresa, por ejemplo `Department:Sales` o `Department:Legal`, AWS puede proporcionarle la distribución de costos por departamento.
En Amazon Transcribe, se pueden etiquetar los siguientes recursos:
+ Trabajos de transcripción
+ Trabajos de transcripción médica
+ Trabajos de transcripción posterior a la llamada de Call Analytics
+ Vocabularios personalizados
+ Vocabularios médicos personalizados
+ Filtros de vocabulario personalizados
+ Categorías de análisis de llamadas
+ Modelos de lenguaje personalizado
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.
**Operaciones de API específicas para el etiquetado de recursos**
[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListTagsForResource.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TagResource.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TagResource.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UntagResource.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UntagResource.html)
Para usar las API de etiquetado, debe incluir un nombre de recurso de Amazon (ARN) en su solicitud. Los ARN tienen el formato `arn:partition:service:region:account-id:resource-type/resource-id`. Por ejemplo, el ARN asociado a un trabajo de transcripción puede tener el siguiente aspecto: `arn:aws:transcribe:us-west-2:111122223333:transcription-job/my-transcription-job-name`.
Para obtener más información sobre las prácticas recomendadas para el etiquetado, consulte [Etiquetado de recursos AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).
## 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:
+ **Recursos:** controla el acceso a sus recursos Amazon Transcribe basándose en las etiquetas que ha asignado a esos recursos.
+ Para ello, utilice la clave de condición `aws:ResourceTag/key-name` para especificar qué par de clave-valor de etiqueta debe adjuntarse al recurso.
+ **Solicitud:** controla qué etiquetas se pueden pasar en una solicitud.
+ Utilice la clave de condición `aws:RequestTag/key-name` para especificar qué etiquetas se pueden agregar, modificar o eliminar de un usuario o rol de IAM.
+ **Procesos de autorización:** controla el acceso basado en etiquetas para cualquier parte del proceso de autorización.
+ Utilice la clave de condición `aws:TagKeys/` 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 ejemplos de políticas de control de acceso basadas en etiquetas, consulte [Visualización de trabajos de transcripción basados en etiquetas](security_iam_id-based-policy-examples.md#tagging-transcription-policy).
Para obtener información detallada sobre el control de acceso basado en etiquetas, consulte [Control de acceso a recursos de AWS mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
## 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\$1** y **Start\$1** 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:
### Consola de administración de AWS
1. Inicie sesión en [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. En el panel de navegación, elija **Trabajos de transcripción** y, a continuación, seleccione **Crear trabajo** (arriba a la derecha). Se abrirá la página **Especificar los detalles del trabajo**.
1. Desplácese hasta la parte inferior de la página **Especificar detalles del trabajo** para buscar el cuadro **Etiquetas: *opcional*** y selecciones **Añadir nueva etiqueta**.
![\[Captura de pantalla de la consola de Amazon Transcribe: página “Especificar los detalles del trabajo”.\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/images/add-new-tag.png)
1. Complete la información para el campo **Clave** y, si lo desea, para el campo **Valor**.
![\[Captura de pantalla de la consola de Amazon Transcribe: panel “Etiquetas”, que muestra ejemplos de etiquetas.\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/images/add-new-tag-color.png)
1. Rellene todos los campos que desee incluir en la página **Especificar los detalles del trabajo** y, a continuación, seleccione **Siguiente**. Esto lo llevará a la página **Configurar trabajo: *opcional***.
Seleccione **Crear trabajo** para ejecutar su trabajo de transcripción.
1. Puede ver las etiquetas asociadas a un trabajo de transcripción navegando hasta la página **Trabajos de transcripción**, seleccionando un trabajo de transcripción y desplazándose hasta la parte inferior de la página de información de ese trabajo. Si desea editar las etiquetas, puede hacerlo seleccionando **Administrar etiquetas**.
![\[Captura de pantalla de la consola de Amazon Transcribe: panel “Etiquetas” de la página de información de un trabajo de transcripción.\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/images/view-tags.png)
### AWS CLI
En este ejemplo, se utilizan el comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) y el parámetro `Tags`. Para obtener más información, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) y [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html).
```
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
```
Este es otro ejemplo en el que se usa el comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) y un cuerpo de la 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-vocab-table.json* contiene el siguiente cuerpo de la solicitud.
```
{
"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"
}
]
}
```
### AWS SDK para Python (Boto3)
En el siguiente ejemplo, se utiliza AWS SDK para Python (Boto3) para solicitar transcripciones alternativas mediante el argumento `Tags` del método [start\$1transcription\$1job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job). Para obtener más información, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) y [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html).
Para ver ejemplos adicionales sobre el uso de los SDK de AWS, incluidos ejemplos de características específicas, escenarios y servicios cruzados, consulte el capítulo [Ejemplos de código para Amazon Transcribe usando AWS SDKs](service_code_examples.md).
```
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)
```