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

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

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:

  1. Faça login no Console de gerenciamento da AWS.

  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.

    Captura de tela do console do Amazon Transcribe: a página “Especificar os detalhes da tarefa”.
  4. 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.
  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.

    Captura de tela do console do Amazon Transcribe: o painel “Marcações” na página de informações de um trabalho de transcrição.

Este exemplo usa o comando start-transcription-job e o parâmetro Tags. Para obter 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

Veja a seguir outro exemplo usando o comando start-transcription-job 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" } ] }

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_job. Para obter mais informações, consulte StartTranscriptionJob 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)