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

# MediaTailor guia de solução de problemas de parâmetros
<a name="parameter-troubleshooting"></a>

AWS Elemental MediaTailor fornece orientação para solucionar problemas comuns relacionados a parâmetros MediaTailor, incluindo restrições de caracteres, problemas de codificação de URL e erros de alias de configuração. 

## Erros de restrição de caracteres
<a name="parameter-character-restriction-errors"></a>

Valores de parâmetros que contêm caracteres não suportados podem causar erros ou comportamento inesperado. 

**Sintomas comuns**  
Os sintomas a seguir podem indicar problemas de restrição de caracteres: 
+ Parâmetros que não aparecem no manifesto URLs
+ Erros HTTP 400 durante a inicialização da sessão
+ Valores de parâmetros truncados ou corrompidos
+ Falha nas solicitações do ADS devido à malformação URLs

**Etapas de resolução**  
Para resolver erros de restrição de caracteres: 

1. Revise os valores dos parâmetros para caracteres não suportados:`:`,`?`,`&`,,`=`, `%` `/`

1. Aplique a codificação de URL adequada para caracteres especiais (consulte) [MediaTailor referência e limitações de parâmetros](parameter-comprehensive-reference.md)

1. Evite caracteres duplos, como `%%%` ou `==`

1. Considere formatos alternativos de parâmetros se não for URLs possível usar full

**Example Exemplo de codificação de URL**  
Em vez de usar:   

```
manifest.redirect_url=https://example.com/path?param=value
```
Use o formato codificado por URL:   

```
manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue
```

## Erros de limitação de comprimento
<a name="parameter-length-limitation-errors"></a>

Os parâmetros que excedem os limites de comprimento podem ser truncados ou causar erros. 

**Limites de comprimento**  
Os seguintes limites de comprimento se aplicam (consulte [MediaTailor referência e limitações de parâmetros](parameter-comprehensive-reference.md) para obter detalhes completos):
+ Parâmetros de consulta do manifesto (total): 2000 caracteres
+ Nomes de parâmetros do ADS: 10.000 caracteres
+ Valores dos parâmetros do ADS: 25.000 caracteres
+ ADS URLs: 25.000 caracteres

**Estratégias de resolução**  
Para lidar com limitações de comprimento: 

1. Use nomes e valores de parâmetros mais curtos sempre que possível

1. Divida valores de parâmetros grandes em vários parâmetros menores

1. Use aliases de configuração para mapear aliases curtos para valores mais longos (consulte) [MediaTailor visão geral dos aliases de configuração](configuration-aliases-overview.md)

1. Considere o uso de armazenamento externo para dados grandes com referências de parâmetros

## Erros de alias de configuração
<a name="parameter-configuration-alias-errors"></a>

Problemas de alias de configuração podem resultar em erros HTTP 400 ou valores de parâmetros inesperados. 

**Erros comuns de alias de configuração**  
Os seguintes erros geralmente ocorrem com aliases de configuração: 
+ Erro HTTP 400: valor de alias ausente ou inválido
+ Variáveis de domínio não estão sendo resolvidas corretamente
+ Os parâmetros do jogador não estão sendo substituídos por valores de alias

**Lista de verificação de resolução**  
Para resolver erros de alias de configuração: 

1. Verifique se todas as variáveis do domínio estão definidas como `ConfigurationAliases`

1. Certifique-se de que as variáveis dos parâmetros do jogador usem o `player_params.` prefixo

1. Confirme se a lista de valores com alias é exaustiva para variáveis de domínio em estado crítico URLs (`VideoContentSourceUrl`,,) `AdSegmentUrlPrefix` `ContentSegmentUrlPrefix`

1. Verifique se as solicitações de inicialização da sessão especificam valores de alias válidos

1. Validar a estrutura JSON do parâmetro ConfigurationAliases 

Para obter orientações detalhadas sobre solução de problemas, consulte[MediaTailor guia de solução de problemas de aliases de configuração](configuration-aliases-troubleshooting.md).

**Example Validação do alias de configuração**  
Certifique-se de que sua configuração inclua todos os aliases necessários:   

```
"ConfigurationAliases": {
    "player_params.origin_domain": {
        "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
        "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
        // Must include all possible values used in session initialization
    }
}
```

## Problemas de fluxo de processamento de parâmetros
<a name="parameter-processing-flow-issues"></a>

Compreender o fluxo de processamento de parâmetros ajuda a solucionar problemas com encaminhamento e transformação de parâmetros. 

**Ordem de processamento de parâmetros**  
MediaTailor processa os parâmetros na seguinte ordem: 

1. Validação do parâmetro de inicialização da sessão

1. Resolução do alias de configuração (se aplicável)

1. Filtragem de parâmetros (ADS x origem x manifesto)

1. Codificação e formatação de URL

1. Aplicação de parâmetros para URLs

**Fluxo de parâmetros de depuração**  
Para depurar problemas de processamento de parâmetros: 

1. Verifique se os parâmetros foram especificados corretamente na inicialização da sessão

1. Verifique se os aliases de configuração são resolvidos para os valores esperados

1. Confirme se os parâmetros aparecem corretamente URLs (manifesto, ADS, origem)

1. Validar se a codificação do URL foi aplicada corretamente

**Example Exemplo de fluxo de parâmetros**  
Inicialização da sessão:   

```
POST master.m3u8
{
    "playerParams": {"origin_domain": "pdx"},
    "manifestParams": {"test": "123"}
}
```
Após a resolução e o processamento do alias:   
+ Solicitação de origem: `https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd`
+ URL do manifesto: `/v1/master/.../index.m3u8?aws.sessionId=session&test=123`

## Considerações de segurança e práticas recomendadas
<a name="parameter-security-considerations-troubleshooting"></a>

MediaTailor implementa medidas de segurança para tratamento de parâmetros para evitar problemas comuns de segurança. 

**Medidas de segurança**  
MediaTailor implementa as seguintes medidas de segurança: 

1. Limitações de tamanho de entrada para evitar inchaço no banco de dados

1. Codificação e higienização adequadas da entrada do usuário

1. Codificação de URL da entrada para evitar a corrupção da resposta

**Práticas recomendadas**  
Siga estas práticas recomendadas para tratamento seguro de parâmetros: 
+ Valide os valores dos parâmetros no lado do cliente antes de enviar
+ Use aliases de configuração para limitar possíveis valores de parâmetros
+ Evite incluir informações confidenciais nos parâmetros
+ Monitore o uso de parâmetros para padrões incomuns
+ Mantenha os valores dos parâmetros dentro dos limites de comprimento recomendados