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á.
# Recursos de marcação AWS Elemental MediaConvert
Uma *tag* é um rótulo que você atribui ou AWS atribui a um AWS recurso. Cada tag consiste em uma *chave* e um *valor*. Em tags atribuídas por você, você mesmo define a chave e o valor. Por exemplo, convém definir a chave como "estágio" e o valor como "teste". As tags ajudam você a identificar e organizar seus AWS recursos. As tags que você atribui a AWS Elemental MediaConvert trabalhos, modelos de tarefas, filas e predefinições são integradas às tags em todos AWS os serviços.
Casos de uso populares para essas tags são os seguintes:
+ Você pode ativar essas tags no Gerenciamento de Faturamento e Custos da AWS painel e, em seguida, configurar um relatório mensal de alocação de custos. Para obter mais informações, consulte [Configurando os recursos para alocação de custo por meio de tags](setting-up-resources-for-catt.md).
+ É possível permitir ou negar acesso em nível de recurso aos seus recursos usando o AWS Identity and Access Management (IAM). Para obter mais informações, consulte [Controle do acesso aos AWS recursos usando tags de recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no *Guia do usuário do IAM*.
**Topics**
+ [Configurando AWS Elemental MediaConvert recursos para alocação de custos por meio de marcação](setting-up-resources-for-catt.md)
+ [Adicionar tags ao criar um AWS Elemental MediaConvert recurso](add-tags-on-create.md)
+ [Adicionar tags a um AWS Elemental MediaConvert recurso existente](add-tags-to-existing.md)
+ [Visualizando tags em um AWS Elemental MediaConvert recurso](view-tags-on-resource.md)
+ [Editando tags em um AWS Elemental MediaConvert recurso](edit-tags-on-resource.md)
+ [Removendo tags de um AWS Elemental MediaConvert recurso](remove-tags-from-resource.md)
+ [Restrições para tags em AWS Elemental MediaConvert recursos](resource-tagging-restrictions.md)
+ [Usando tags de metadados com trabalhos AWS Elemental MediaConvert](user-metadata-tags.md)
# Configurando AWS Elemental MediaConvert recursos para alocação de custos por meio de marcação
Para todas as saídas que você produz usando uma fila sob demanda, você pode usar o Gerenciamento de Faturamento e Custos da AWS painel para configurar um relatório mensal de alocação de custos. Esse relatório mostra o que você AWS cobra pela transcodificação, classificado por recurso. É possível configurar seus trabalhos para que as saídas de trabalho sejam classificadas por tags no trabalho ou em um recurso usado para criar o trabalho. Ou seja, você pode classificar a fatura pelas tags que colocar no trabalho, na fila para a qual você enviou o trabalho, no modelo de trabalho usado como base para criar o trabalho, ou nas predefinições de saída usadas para configurar as saídas individuais do trabalho.
**Para configurar a alocação de custos por meio da marcação de suas cobranças AWS Elemental MediaConvert**
1. Marque os recursos pelos quais você pretende classificar sua fatura. Para obter instruções, consulte os outros tópicos nesse capítulo.
1. Crie seus trabalhos de transcodificação, especificando como deseja que seus custos sejam alocados, da seguinte maneira:
1. Na página **Criar trabalho**, no painel **Trabalho** à esquerda, em **Configurações de trabalho**, escolha **Integração AWS **.
1. Na seção **Configurações do trabalho** à direita, em **Integração AWS **, para **Origem da tag de faturamento**, escolha quais tags você deseja usar para classificar as saídas do trabalho. Você pode escolher classificar por tags em um recurso que você usa para criar o trabalho/modelo de trabalho, predefinição de saída ou fila. Ou é possível escolher **Job (Trabalho)** para classificar por tags no próprio trabalho.
**nota**
Os trabalhos e as tags neles persistem por apenas 90 dias. Se o fluxo de trabalho fizer referência a tags por períodos mais longos, use tags na fila, no modelo de trabalho ou na predefinição de saída em vez de tags no trabalho.
1. Ative essas tags no Gerenciamento de Faturamento e Custos da AWS painel. Para mais informações, consulte [Ativando etiquetas de alocação de custos definidas pelo usuário](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activating-tags.html) no *Guia do usuário do gerenciamento de faturamento e custos*.
1. Configurar seus relatórios Para obter mais informações, consulte [relatório mensal de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) no *Guia do usuário do gerenciamento de faturamento e custos*.
# Adicionar tags ao criar um AWS Elemental MediaConvert recurso
Os procedimentos a seguir mostram como adicionar tags às suas MediaConvert filas, modelos de trabalho e predefinições de saída ao criá-los.
**Tópicos**
## Adicionando tags ao criar um recurso (console)
Você pode adicionar tags ao criar uma fila, modelo de trabalho, ou predefinição de saída.
**Para adicionar tags ao criar uma fila, modelo de trabalho, ou predefinição de saída (console)**
1. Siga as etapas em um dos seguintes procedimentos para começar a criar o recurso, mas não salve o recurso:
+ [Tutorial: Definindo as configurações do trabalho](setting-up-a-job.md)
+ [Criação de uma fila](creating-queues.md)
+ [Criar modelos](creating-template-from-scratch.md)
+ [Criando uma predefinição](creating-preset-from-scratch.md)
+ [Criando uma predefinição personalizada com base em uma predefinição do sistema](create-custom-preset-from-system-preset.md)
1. Encontre a seção **Tags** no local relevante:
+ Para trabalhos – na página **Criar trabalho**, depois de selecionar **Configurações** na seção **Trabalho** à esquerda
+ Para filas – na parte inferior da página **Criar fila**
+ Para predefinições de saída – na parte inferior da página **Criar predefinição**
+ Para modelos de trabalho – na parte inferior da página **Criar modelo de trabalho**, depois de selecionar **Configurações** na seção **Trabalho** à esquerda
1. Na seção **Tags**, escolha **Add (Adicionar)**.
1. Para **Tag key (Chave de tag)**, insira um nome para a tag. Para **Tag value (Valor de tag)**, insira um valor para a tag.
1. Escolha **Create (Criar)** para salvar o novo recurso com as tags.
## Adicionar tags ao criar um recurso (API e AWS CLI)
Ao criar um trabalho, modelo de trabalho, predefinição de saída ou fila usando a AWS Elemental MediaConvert API ou o AWS CLI, envie sua especificação JSON para o recurso normalmente. Inclua tags conforme mostrado no exemplo JSON a seguir, em `tags`.
```
{
"name": "Job Template Test with Resource Tags",
"description": "Job Template Test",
"tags":{
"Company": "Banana",
"Stage": "Production"
},
"settings":{
```
# Adicionar tags a um AWS Elemental MediaConvert recurso existente
O procedimento a seguir mostra como adicionar tags a modelos de trabalho, predefinições de saída ou filas existentes usando o AWS Elemental MediaConvert console. Você não pode usar o console para adicionar tags a trabalhos existentes.
Para obter informações sobre como adicionar tags usando a API, consulte o método `POST` na seção endpoint [Tags](https://docs.aws.amazon.com/mediaconvert/latest/apireference/tags.html) da *API de referência do MediaConvert *.
**nota**
As tags em seus MediaConvert recursos não aparecem na resposta JSON a uma `GET` solicitação no recurso. Em vez disso, envie uma solicitação `GET` ao endpoint `Tags` Se enviar sua solicitação diretamente para a API, em vez de usar um SDK, você deverá codificar o ARN do recurso na URL.
**Como adicionar tags a modelos de trabalho, predefinições de saída e filas (console)**
1. Abra o MediaConvert console em [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).
1. Selecione o ícone de três barras à esquerda para acessar o painel de navegação esquerdo.
1. Escolha **Output presets (Predefinições de saída)**, **Job templates (Modelos de trabalho)**, ou **Queues (Filas)**.
1. Escolha o nome do recurso específico ao qual você deseja adicionar uma tag.
1. Escolha **Update (Atualizar)**, **Edit queue (Editar fila)**, ou **Update preset (Atualizar predefinição)** botão no canto superior direito.
1. Na seção **Tags** na parte inferior da página, escolha **Add (Adicionar)**.
1. Para **Tag key (Chave de tag)**, insira um nome para a tag. Para **Tag value (Valor de tag)**, insira um valor para a tag.
1. Escolha **Salvar**.
# Visualizando tags em um AWS Elemental MediaConvert recurso
O procedimento a seguir mostra como visualizar tags em filas, modelos de trabalho e predefinições de saída existentes usando o AWS Elemental MediaConvert console.
Para fazer isso usando a API, consulte o método `GET` na seção endpoint [Tags arn](https://docs.aws.amazon.com/mediaconvert/latest/apireference/tags-arn.html) da *API de referência do MediaConvert *. Se enviar sua solicitação diretamente para a API, em vez de usar um SDK, você deverá codificar o ARN do recurso na URL.
**Para visualizar tags em filas, modelos de trabalho e predefinições de saída (console)**
1. Abra o MediaConvert console em [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).
1. Selecione o ícone de três barras à esquerda para acessar o painel de navegação esquerdo.
1. Escolha **Job templates (Modelos de trabalho)**, **Output presets (Predefinições de saída)** ou **Queues (Filas)**.
1. Escolha o nome do recurso específico que tenha tags que você deseja visualizar.
1. Visualize as tags para o recurso na seção **Tags** na parte inferior da página.
# Editando tags em um AWS Elemental MediaConvert recurso
O procedimento a seguir mostra como editar tags em modelos de trabalho, predefinições de saída e filas existentes usando o AWS Elemental MediaConvert console. Não é possível editar tags em trabalhos existentes.
Para fazer isso usando a API, consulte o método `POST` na seção endpoint [Tags](https://docs.aws.amazon.com/mediaconvert/latest/apireference/tags.html) da *API de referência do MediaConvert *.
**Como editar tags de modelos de trabalho, predefinições de saída e filas (console)**
1. Abra o MediaConvert console em [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).
1. Selecione o ícone de três barras à esquerda para acessar o painel de navegação esquerdo.
1. Escolha **Job templates (Modelos de trabalho)**, **Output presets (Predefinições de saída)** ou **Queues (Filas)**.
1. Escolha o nome do recurso específico que tenha tags que você deseja alterar.
1. Escolha **Update (Atualizar)**, **Edit queue (Editar fila)**, ou **Update preset (Atualizar predefinição)** botão no canto superior direito.
1. Na seção **Tags** na parte inferior da página, edite os valores para **Tag key (Chave de tag)** e **Tag values (Valores de tag)** que você deseja alterar.
1. Escolha **Salvar**.
# Removendo tags de um AWS Elemental MediaConvert recurso
O procedimento a seguir mostra como remover tags de modelos de trabalho, predefinições de saída e filas existentes usando o AWS Elemental MediaConvert console.
Para fazer isso usando a API, consulte o método `PUT` na seção endpoint [Tags](https://docs.aws.amazon.com/mediaconvert/latest/apireference/tags.html) da *API de referência do MediaConvert *.
**Como remover tags de um modelo de trabalho, uma predefinição de saída ou uma fila (console)**
1. Abra o MediaConvert console em [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).
1. Selecione o ícone de três barras à esquerda para acessar o painel de navegação esquerdo.
1. Escolha **Job templates (Modelos de trabalho)**, **Output presets (Predefinições de saída)** ou **Queues (Filas)**.
1. Escolha o nome do recurso específico que tenha tags que você deseja alterar.
1. Escolha **Update (Atualizar)**, **Edit queue (Editar fila)**, ou **Update preset (Atualizar predefinição)** botão no canto superior direito.
1. Ao lado de qualquer tag que você deseja excluir, escolha **Remove (Remover)**.
1. Escolha **Salvar**.
# Restrições para tags em AWS Elemental MediaConvert recursos
As restrições básicas a seguir se aplicam a tags:
+ Número máximo de tags por recurso – 50.
+ Comprimento máximo da **Chave**: 128 caracteres Unicode
+ Comprimento máximo de **Valor**: 256 caracteres Unicode.
+ Valores válidos para **Key** (Chave) e **Valor** letras maiúsculas e minúsculas no conjunto de caracteres UTF-8, números, espaço e os seguintes caracteres: \$1 . : / = \$1 - and @
+ As chaves e valores das tags diferenciam maiúsculas de minúsculas.
+ Não use o prefixo `aws:` em chaves ou valores. Está reservado para AWS uso.
# Usando tags de metadados com trabalhos AWS Elemental MediaConvert
A menos que você tenha integrações ou fluxos de trabalho existentes que dependam de tags metadata (`userMetadata`), recomendamos que você use AWS tags padrão para integração automática com AWS serviços e para integrações e fluxos de trabalho personalizados. Para obter mais informações, consulte [Recursos de marcação AWS Elemental MediaConvert](tagging-mediaconvert-resources.md).
Uma *tag* é um rótulo que você atribui ou AWS atribui a um AWS recurso. Cada tag consiste em uma *chave* e um *valor*. Em tags atribuídas por você, você mesmo define a chave e o valor. Por exemplo, convém definir a chave como "estágio" e o valor como "teste". As tags ajudam você a identificar e organizar seus AWS recursos. As tags de metadados que você atribui aos AWS Elemental MediaConvert trabalhos aparecem nas EventBridge notificações da Amazon.
As tags de metadados são adicionadas aos trabalhos de uma das seguintes maneiras:
+ Por meio do MediaConvert console, na página de **configurações do Job**, no painel **Metadados**.
+ Por meio da MediaConvert API em suas configurações de trabalho, carga útil JSON. Inclua tags conforme mostrado no trecho JSON a seguir, em `userMetadata`. Para obter mais informações, consulte a seção endpoint [Jobs (Trabalhos)](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html) da *MediaConvert referência de API*.
```
{
"name": "Job Template Test with Resource Tags",
"description": "Job Template Test",
"userMetadata":{
"Company": "Banana",
"Stage": "Production"
},
"settings":{
```
## AWS Elemental MediaConvert restrições de etiquetas de trabalho
As restrições básicas a seguir se aplicam às tags em trabalhos:
+ Número máximo de tags por trabalho: 10.
+ Comprimento máximo da **Chave**: 128 caracteres Unicode.
+ Comprimento máximo do **Valor**: 256 caracteres Unicode.
+ Valores válidos para **Chave** e **Valor**: letras Unicode letras maiúsculas e letras minúsculas em qualquer idioma, números, espaço e os seguintes caracteres: \$1 . : / = \$1 - e @.
+ As chaves e valores das tags diferenciam maiúsculas de minúsculas.
+ Não use o prefixo `aws:` em chaves ou valores. Está reservado para AWS uso.