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 visão geral dos aliases de configuração
AWS Elemental MediaTailor os aliases de configuração permitem a substituição dinâmica de variáveis em domínios de URL e outros campos compatíveis. Use esse recurso para usar vários domínios e configurar dinamicamente URLs durante a inicialização da sessão.
## Casos de uso
Os aliases de configuração permitem arquiteturas sofisticadas de várias configurações para os seguintes cenários:
+ **Roteamento geográfico: direcione** solicitações para diferentes origens ou servidores de anúncios com base na localização do espectador usando aliases específicos da região. Para obter orientação de implementação, consulte [CloudFront Origin Failover](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/high_availability_origin_failover.html).
+ **Roteamento baseado em conteúdo:** direcione diferentes tipos de conteúdo para origens especializadas ou pipelines de processamento. Para a configuração do comportamento de roteamento, consulte[Configure comportamentos de roteamento de CDN para MediaTailor](cdn-routing-behaviors.md).
+ **Cenários de failover:** implemente origens de backup e servidores de anúncios com failover automático usando alternância de aliases. Para uma implementação detalhada, consulte [Implemente resiliência multirregional com o MQAR MediaTailor](media-quality-resiliency.md) [Planeje sua integração de CDN para AWS Elemental MediaTailor](planning-cdn-integration.md) e.
+ Teste **A/B: teste** diferentes servidores de anúncios, origens ou configurações roteando o tráfego com base nos parâmetros do player. Para obter orientação sobre testes de carga, consulte [Preparar e executar testes de desempenho para a Amazon CloudFront com monitoramento real de usuários](https://aws.amazon.com/blogs/networking-and-content-delivery/prepare-and-run-performance-tests-for-amazon-cloudfront-with-real-user-monitoring/).
+ **Otimização específica do dispositivo: otimize a entrega de conteúdo e a veiculação** de anúncios para diferentes tipos ou recursos de dispositivos. Para obter uma orientação abrangente, consulte[Configurar a filtragem de manifestos com MediaTailor MediaPackage, e CDN](cdn-emp-manifest-filtering.md).
+ **Balanceamento de carga:** distribua a carga em várias origens ou servidores de anúncios usando roteamento dinâmico. Para obter orientação de implementação, consulte [Implemente resiliência multirregional com o MQAR MediaTailor](media-quality-resiliency.md) [Planeje sua integração de CDN para AWS Elemental MediaTailor](planning-cdn-integration.md) e.
## Campos compatíveis
Você pode usar variáveis dinâmicas nos seguintes campos de configuração:
+ `VideoContentSourceUrl`
+ `AdDecisionServerUrl`
+ `LivePreroll.AdDecisionServerUrl`
+ `AdSegmentUrlPrefix`
+ `ContentSegmentUrlPrefix`
+ `TranscodeProfileName`
+ `SlateAdUrl`
+ `StartUrl`
+ `EndUrl`
As seções a seguir descrevem como usar aliases de configuração.
**Topics**
+ [Casos de uso](#configuration-aliases-use-cases)
+ [Campos compatíveis](#configuration-aliases-supported)
+ [Criando e usando](creating-configuration-aliases.md)
+ [Exemplo de fluxo](configuration-aliases-examples.md)
# Criação e uso de aliases de configuração com MediaTailor
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
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
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
```
# Alias de configuração com exemplo de MediaTailor uso
Os exemplos a seguir mostram como é feita uma MediaTailor configuração completa com aliases de configuração, uma solicitação de inicialização de sessão com aliases e o fluxo de processamento de aliases.
**Example Configuração completa com aliases**
O exemplo a seguir mostra uma configuração completa 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]",
"AdSegmentUrlPrefix": "https://[player_params.ad_cdn_domain]/ads/",
"ContentSegmentUrlPrefix": "https://[player_params.content_cdn_domain]/content/",
"TranscodeProfileName": "[player_params.transcode_profile]",
"SlateAdUrl": "https://[player_params.slate_domain]/slate/[player_params.slate_type].mp4",
"StartUrl": "https://[player_params.tracking_domain]/start?session=[session.id]",
"EndUrl": "https://[player_params.tracking_domain]/end?session=[session.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"
},
"player_params.ad_cdn_domain": {
"pdx": "ads-west.cdn.example.com",
"iad": "ads-east.cdn.example.com"
},
"player_params.content_cdn_domain": {
"pdx": "content-west.cdn.example.com",
"iad": "content-east.cdn.example.com"
},
"player_params.transcode_profile": {
"mobile": "mobile_optimized",
"desktop": "high_quality",
"tv": "4k_profile"
},
"player_params.slate_domain": {
"pdx": "slate-west.example.com",
"iad": "slate-east.example.com"
},
"player_params.slate_type": {
"standard": "default_slate",
"branded": "brand_slate"
},
"player_params.tracking_domain": {
"pdx": "tracking-west.example.com",
"iad": "tracking-east.example.com"
}
}
}
```
**Example Inicialização da sessão com aliases**
O exemplo a seguir mostra uma solicitação de inicialização de sessão que especifica as variáveis e os aliases do player:
```
POST master.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized",
"ad_cdn_domain": "pdx",
"content_cdn_domain": "pdx",
"transcode_profile": "mobile",
"slate_domain": "pdx",
"slate_type": "branded",
"tracking_domain": "pdx"
}
}
```
**Example Fluxo de processamento de parâmetros**
No exemplo a seguir, MediaTailor substitui as cadeias de caracteres de alias pelos valores mapeados nos aliases de configuração. O processamento resulta nas seguintes solicitações:
+ Solicitação de ADS:
```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
+ VideoContentSource solicitação:
```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```
+ AdSegmentUrlPrefix:
```
https://ads-west.cdn.example.com/ads/
```
+ ContentSegmentUrlPrefix:
```
https://content-west.cdn.example.com/content/
```
+ TranscodeProfileName:
```
mobile_optimized
```
+ SlateAdUrl:
```
https://slate-west.example.com/slate/brand_slate.mp4
```
+ StartUrl:
```
https://tracking-west.example.com/start?session=[session.id]
```
+ EndUrl:
```
https://tracking-west.example.com/end?session=[session.id]
```