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
ListTagsForResource,
TagResource,
UntagResource
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.
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/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 condição
aws:RequestTag/para especificar quais tags podem ser adicionadas, modificadas ou removidas de um usuário ou perfil do IAM.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 recursos do Amazon Transcribe
Você pode adicionar tags antes ou depois de executar o trabalho do Amazon Transcribe. 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:
-
Faça login no Console de gerenciamento da AWS
. -
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 comando start-transcription-jobTags. Para obter mais informações, consulte StartTranscriptionJob e Tag.
aws transcribe start-transcription-job \ --regionus-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=blueKey=shape,Value=square
Veja a seguir outro exemplo usando o comando start-transcription-job
aws transcribe start-transcription-job \ --regionus-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" } ] }
O exemplo a seguir usa o AWS SDK para Python (Boto3) para adicionar uma tag usando o argumento Tags para o método start_transcription_jobStartTranscriptionJob e Tag.
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.
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)