As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Marcando atributos
Uma tag é um rótulo de metadados personalizado que você pode adicionar a um recurso para facilitar a identificação, a organização e a busca em uma pesquisa. As tags são compostas de duas partes: uma chave e um valor de tag. Isso é chamado de par de chave-valor.
Uma chave de tag normalmente representa uma categoria maior, enquanto um valor de tag representa um subconjunto dessa categoria. Por exemplo, você poderia ter a *tag key=Color *e a *tag value=Blue*, o que produziria o par de chave-valor `Color:Blue`. Observe que você pode definir o valor de uma tag como uma string vazia, mas não como um valor nulo. Omitir o valor da tag é o mesmo que usar uma string vazia.
**dica**
O Gerenciamento de Faturamento e Custos da AWS pode usar tags para separar suas faturas em categorias dinâmicas. Por exemplo, se você adicionar tags para representar diferentes departamentos da empresa, como `Department:Sales` ou `Department:Legal`, a AWS poderá fornecer sua distribuição de custos por departamento.
No Amazon Transcribe, você pode marcar os seguintes recursos:
+ Trabalhos de transcrição
+ Trabalhos de transcrição médica
+ Tarefas de transcrição pós-chamada do Call Analytics
+ Vocabulários personalizados
+ Vocabulários médicos personalizados
+ Filtros de vocabulário personalizados
+ Categoria do Call Analytics
+ Modelos de idioma personalizados
As chaves das tags podem ter até 128 caracteres e os valores das tags podem ter até 256 caracteres; ambos fazem distinção entre maiúsculas e minúsculas. O Amazon Transcribe comporta até 50 tags por recurso. Para um determinado recurso, cada chave de tag precisa ser exclusiva e ter apenas um valor de tag. Observe que as tags não podem começar com `aws:` porque a AWS reserva esse prefixo para tags geradas pelo sistema. Não é possível adicionar, modificar ou excluir tags `aws:*`, e elas não são consideradas em relação ao seu limite de tags por recurso.
**Operações de API específicas para marcação 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 as APIs de marcação, você deve incluir um nome do recurso da Amazon (ARN) na solicitação. Os ARNs têm o formato `arn:partition:service:region:account-id:resource-type/resource-id`. Por exemplo, o ARN associado a um trabalho de transcrição pode ser semelhante a: `arn:aws:transcribe:us-west-2:111122223333:transcription-job/my-transcription-job-name`.
Para saber mais sobre marcação, bem como práticas recomendadas, consulte [Tagging AWS resources](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).
## Controle de acesso com base em tags
Você pode usar tags para controlar o acesso em suas Contas da AWS. Para o controle de acesso baseado em tags, você fornece informações de tags no elemento de condição de uma política do IAM. Em seguida, use as tags e a chave de condição da tag associada para controlar o acesso a:
+ **Recursos:** controle o acesso aos recursos do Amazon Transcribe de acordo com as tags atribuídas a esses recursos.
+ Use a chave de condição `aws:ResourceTag/key-name` para especificar qual par de tag chave:valor deve ser anexado ao recurso.
+ **Solicitações**: controle quais tags podem ser passadas em uma solicitação.
+ Use a chave de condição `aws:RequestTag/key-name` para especificar quais tags podem ser adicionadas, modificadas ou removidas de um usuário ou perfil do IAM.
+ **Processos de autorização**: controle o acesso baseado em tags para qualquer parte do processo de autorização.
+ Use a chave de condição `aws:TagKeys/` para controlar se chaves de tag específicas podem ser usadas em um recurso, em uma solicitação ou por uma entidade principal. Nesse caso, o valor da chave não importa.
Para obter um exemplo de política de controle de acesso baseada em tags, consulte [Visualizar trabalhos de transcrição com base em tags](security_iam_id-based-policy-examples.md#tagging-transcription-policy).
Para obter informações mais detalhadas sobre o controle de acesso baseado em tags, consulte [Controlar o acesso a recursos da AWS usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
## Adicionar tags aos seus recursos do Amazon Transcribe
Você pode adicionar tags antes ou depois de executar o trabalho do Amazon Transcribe. Usando as APIs **Criar\$1** e **Iniciar\$1** existentes, é possível adicionar tags à sua solicitação de transcrição.
Você pode adicionar, modificar ou excluir tags usando o **Console de gerenciamento da AWS**, a **AWS CLI** ou os **SDKs da AWS**. Veja os seguintes exemplos:
### Console de gerenciamento da AWS
1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/).
1. No painel de navegação, escolha **Tarefas de transcrição** e selecione **Criar tarefa** (no canto superior direito). Isso abre a página **Especificar os detalhes da tarefa**.
1. Role até a parte inferior da página **Especificar os detalhes da tarefa** para encontrar a caixa Tags - *opcionais* e selecione **Adicionar nova marcação**.
![\[Captura de tela do console do Amazon Transcribe: a página “Especificar os detalhes da tarefa”.\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/add-new-tag.png)
1. Insira informações para o campo **Chave** e, opcionalmente, para o campo **Valor**.
![\[Captura de tela do console do Amazon Transcribe: o painel “Marcações”, mostrando exemplos de tags.\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/add-new-tag-color.png)
1. Preencha os outros campos que deseja incluir na página **Especificar os detalhes da tarefa** e selecione **Próximo**. Isso leva você à página **Configurar tarefa: *opcional***.
Selecione **Criar tarefa** para executar a tarefa de transcrição.
1. Você pode ver as tags associadas a um trabalho de transcrição navegando até a página **Tarefas de transcrição**, selecionando uma tarefa de transcrição e rolando até a parte inferior da página de informações desse trabalho. Se você quiser editar as tags, poderá fazê-lo selecionando **Gerenciar marcações**.
![\[Captura de tela do console do Amazon Transcribe: o painel “Marcações” na página de informações de um trabalho de transcrição.\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/view-tags.png)
### AWS CLI
Este exemplo usa o comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) e o parâmetro `Tags`. Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [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
```
Veja a seguir outro exemplo usando o comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) e um corpo de solicitação que adiciona tags a esse trabalho.
```
aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://filepath/my-first-tagging-job.json
```
O arquivo *my-first-tagging-job.json* contém o corpo de solicitação a seguir.
```
{
"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)
O exemplo a seguir usa o AWS SDK para Python (Boto3) para adicionar uma tag usando o argumento `Tags` para o método [start\$1transcription\$1job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job). Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html).
Para ver exemplos adicionais de uso dos SDKs da AWS, bem como exemplos específicos de recursos, cenários e entre serviços, consulte o capítulo [Exemplos de código para o 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)
```