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 é conhecido como 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**
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.
Em 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 de tag podem ter até 128 caracteres e os valores de tag podem ter até 256 caracteres; ambas diferenciam maiúsculas de minúsculas. Amazon Transcribe suporta 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 suas tags não podem começar `aws:` porque AWS reservam 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, incluindo as melhores práticas, consulte Recursos de [marcação AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).
## Tag-based controle de acesso
Você pode usar tags para controlar o acesso dentro do seu Contas da AWS. Para controle de acesso baseado em tags, você fornece informações sobre tags no elemento de condição de uma IAM política. Em seguida, use as tags e a chave de condição da tag associada para controlar o acesso a:
+ **Recursos:** controle o acesso aos seus Amazon Transcribe recursos com base nas tags que você atribuiu 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 `aws:RequestTag/{{key-name}}` condição para especificar quais tags podem ser adicionadas, modificadas ou removidas de um IAM usuário ou função.
+ **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).
## Adicionando tags ao seu Amazon Transcribe recursos
Você pode adicionar tags antes ou depois de executar seu Amazon Transcribe trabalho. Usando as APIs **Criar\*** e **Iniciar\*** 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**.
1. Insira informações para o campo **Chave** e, opcionalmente, para o campo **Valor**.
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**.
### 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 `Tags` argumento do método [start\_transcription\_job](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 AWS SDKs, incluindo 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)
```