Marcando atributos - Amazon Transcribe

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/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.

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:

  1. Faça login no AWS Management Console.

  2. 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.

  3. 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.

    Amazon Transcribe captura de tela do console: a página “especificar detalhes do trabalho”.
  4. Insira informações para o campo Chave e, opcionalmente, para o campo Valor.

    Amazon Transcribe captura de tela do console: o painel 'tags', mostrando exemplos de tags.
  5. 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.

  6. 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.

    Amazon Transcribe captura de tela do console: o painel 'tags' na página de informações de um trabalho de transcrição.

Este exemplo usa o start-transcription-jobcomando e o Tags parâmetro. Para ter mais informações, consulte StartTranscriptionJob e Tag.

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

Aqui está outro exemplo usando o start-transcription-jobcomando 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 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_job. Para ter mais informações, consulte StartTranscriptionJob 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)