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
AWS Billing and Cost Management pode usar tags para separar suas contas 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
Trabalhos de análise de chamadas após a transcrição de chamadas
Vocabulários personalizados
Vocabulários médicos personalizados
Filtros de vocabulário personalizados
Categorias de análise de chamadas
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. Você não pode adicionar, modificar ou excluir aws:*
tags, e elas não contam para o seu tags-per-resource limite.
Operações de API específicas para marcação de recursos
ListTagsForResource
,
TagResource
,
UntagResource
Para usar a marcação APIs, você deve incluir um nome de recurso da Amazon (ARN) em sua solicitação. ARNs tenha o formatoarn: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.
Controle de acesso com base em tags
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/
para especificar qual par de tag chave:valor deve ser anexado ao recurso.key-name
Solicitações: controle quais tags podem ser passadas em uma solicitação.
Use a chave de
aws:RequestTag/
condição para especificar quais tags podem ser adicionadas, modificadas ou removidas de um IAM usuário ou função.key-name
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.
Para obter informações mais detalhadas sobre o controle de acesso baseado em tags, consulte Controlar o acesso a recursos da AWS usando tags.
Adicionar tags aos seus Amazon Transcribe recursos
Você pode adicionar tags antes ou depois de executar seu Amazon Transcribe trabalho. Usando as opções Create* e Start* existentes APIs, você pode adicionar tags à sua solicitação de transcrição.
Você pode adicionar, modificar ou excluir tags usando o AWS Management ConsoleAWS CLI, ou AWS SDKs; veja exemplos a seguir:
-
Faça login no AWS Management Console
. -
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.
-
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.
-
Insira informações para o campo Chave e, opcionalmente, para o campo Valor.
-
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.
-
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.
Este exemplo usa o start-transcription-jobTags
parâmetro. Para ter mais informações, consulte StartTranscriptionJob
e Tag
.
aws transcribe start-transcription-job \ --region
us-west-2
\ --transcription-job-namemy-first-transcription-job
\ --media MediaFileUri=s3://amzn-s3-demo-bucket
/my-input-files
/my-media-file
.flac
\ --output-bucket-nameamzn-s3-demo-bucket
\ --output-keymy-output-files
/ \ --language-codeen-US
\ --tags Key=color
,Value=blue
Key=shape
,Value=square
Aqui está outro exemplo usando o start-transcription-job
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 seguinte corpo da solicitação.
{ "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
" } ] }
O exemplo a seguir usa o AWS SDK for Python (Boto3) para adicionar uma tag usando o Tags
argumento do método start_transcription_jobStartTranscriptionJob
e Tag
.
Para obter exemplos adicionais de uso do 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
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)