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

# Criação e uso de aliases de configuração com MediaTailor
<a name="creating-configuration-aliases"></a>

Antes de começar a usar variáveis de domínio, você cria aliases de configuração para sua configuração. Você usa os aliases de configuração como variáveis de substituição de domínio no momento da inicialização da sessão.

**Restrições**  
Observe as seguintes restrições ao usar aliases de configuração:
+ Todas as variáveis dinâmicas usadas no domínio devem ser definidas como variáveis `ConfigurationAliases` dinâmicas.
+ As variáveis dos parâmetros do player devem ser prefixadas com`player_params.`. Por exemplo, .`player_params.origin_domain`
+ A lista de valores com alias deve ser exaustiva para variáveis de domínio em estado crítico URLs (`VideoContentSourceUrl`,,`AdSegmentUrlPrefix`). `ContentSegmentUrlPrefix`
+ Se for feita uma solicitação para uma variável de domínio crítica URLs que não especifique a variável dinâmica ou use um alias inválido, a solicitação falhará com um código de `400` status HTTP. Campos não críticos (`SlateAdUrl`,`TranscodeProfileName`, bumper URLs) registrarão os avisos, mas não falharão na solicitação.

**Comportamento alternativo para aliases ausentes**  
Quando os aliases de configuração não são encontrados ou são inválidos, MediaTailor implementa o seguinte comportamento de fallback:
+ **Variáveis de domínio:** se um alias de variável de domínio estiver ausente ou for inválido, a solicitação falhará com o código de status HTTP 400. Todas as variáveis de domínio devem ter aliases válidos definidos.
+ **Variáveis que não são de domínio:** para variáveis usadas em partes que não são de domínio URLs (como elementos de caminho ou parâmetros de consulta), aliases ausentes resultam na substituição de uma string vazia.
+ **Validação de configuração:** MediaTailor valida se todos os aliases necessários estão presentes durante as operações de criação e atualização da configuração.

## Etapa 1: criar aliases de configuração
<a name="dynamic-domains-creating-configuration-alias"></a>

Para criar aliases de configuração a serem usados para substituição de domínio usando o MediaTailor console, execute o procedimento a seguir.

------
#### [ Console ]

**Para criar aliases de configuração usando o console**

1. Abra o MediaTailor console em [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Na seção **Apelidos de configuração** na página **Configurações**, escolha **Adicionar parâmetro de player**. 

1. Em **Parâmetro do jogador**, insira o nome do parâmetro do jogador que você deseja usar como uma variável dinâmica. Por exemplo, .`player_params.origin_domain` 

1. **Em Aliases**, insira os aliases e seus valores que você deseja usar para o parâmetro do player. 

1. Escolha **OK**. 

   AWS Elemental MediaTailor exibe o novo parâmetro na tabela na seção **Apelidos de configuração**.

1. Repita as etapas anteriores para adicionar mais parâmetros do player. 

1. Escolha **Salvar**. 

------
#### [ API ]

**Para criar aliases de configuração usando a API**  
Ao criar ou atualizar uma MediaTailor configuração, use o `ConfigurationAliases` parâmetro com a seguinte estrutura JSON: 

```
{
                "ConfigurationAliases": {
                "player_params.origin_domain": {
                "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
                "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
                },
                "player_params.ad_type": {
                "customized": "abc12345",
                "default": "defaultAdType"
                }
                }
                }
```

------

## Etapa 2: Usar aliases de configuração na inicialização da sessão
<a name="dynamic-domains-using-configuration-alias"></a>

Depois de configurar os aliases de configuração, você pode usá-los como variáveis de substituição para domínios na solicitação de inicialização da sessão. Isso permite que você configure dinamicamente os domínios da sua sessão.

**Example Exemplo de aliases de configuração básica**  
Aqui está um exemplo básico de uma configuração que inclui aliases de configuração e variáveis dinâmicas de domínio:  

```
PUT /playbackConfiguration
{
    "Name": "aliasedConfig",
    "AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
    "VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
    "ConfigurationAliases": {
        "player_params.origin_domain": {
            "pdx": "abc",
            "iad": "xyz"
        },
        "player_params.region": {
            "pdx": "us-west-2",
            "iad": "us-east-1"
        },
        "player_params.endpoint_id": {
            "pdx": "abcd",
            "iad": "wxyz"
        },
        "player_params.ad_type": {
            "customized": "abc12345",
            "default": "defaultAdType"
        }
    }
}
```

**Example Inicialização da sessão com aliases**  
Usando a configuração anterior, uma solicitação de inicialização de sessão usando as variáveis e os aliases do player seria semelhante à seguinte:  

```
POST index.m3u8
{
    "playerParams": {
        "origin_domain": "pdx",
        "region": "pdx",
        "endpoint_id": "pdx",
        "ad_type": "customized"
    }
}
```
MediaTailor substitui as cadeias de caracteres de aliases pelos valores mapeados na configuração de aliases de configuração.  
A solicitação para o ADS terá a seguinte aparência:  

```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
A solicitação à origem dos manifestos terá a seguinte aparência:  

```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```