Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Membuat dan menggunakan alias konfigurasi dengan MediaTailor
<a name="creating-configuration-aliases"></a>

Sebelum Anda mulai menggunakan variabel domain, Anda membuat alias konfigurasi untuk konfigurasi Anda. Anda menggunakan alias konfigurasi sebagai variabel pengganti domain pada waktu inisialisasi sesi.

**Pembatasan**  
Perhatikan batasan berikut saat menggunakan alias konfigurasi:
+ Semua variabel dinamis yang digunakan dalam domain harus didefinisikan sebagai variabel `ConfigurationAliases` dinamis.
+ Variabel parameter pemain harus diawali dengan`player_params.`. Misalnya, `player_params.origin_domain`.
+ Daftar nilai alias harus lengkap untuk variabel domain di critical URLs (`VideoContentSourceUrl`,,`AdSegmentUrlPrefix`). `ContentSegmentUrlPrefix`
+ Jika permintaan dibuat untuk variabel domain secara kritis URLs yang tidak menentukan variabel dinamis atau menggunakan alias yang tidak valid, permintaan akan gagal dengan kode status HTTP`400`. Bidang non-kritis (`SlateAdUrl`,`TranscodeProfileName`, bumper URLs) akan mencatat peringatan tetapi tidak gagal permintaan.

**Perilaku mundur untuk alias yang hilang**  
Ketika alias konfigurasi tidak ditemukan atau tidak valid, MediaTailor mengimplementasikan perilaku fallback berikut:
+ **Variabel domain:** Jika alias variabel domain hilang atau tidak valid, permintaan gagal dengan kode status HTTP 400. Semua variabel domain harus memiliki alias yang valid didefinisikan.
+ **Variabel non-domain:** Untuk variabel yang digunakan dalam bagian non-domain URLs (seperti elemen jalur atau parameter kueri), alias yang hilang menghasilkan penggantian string kosong.
+ **Validasi konfigurasi:** MediaTailor memvalidasi bahwa semua alias yang diperlukan ada selama pembuatan konfigurasi dan operasi pembaruan.

## Langkah 1: Buat alias konfigurasi
<a name="dynamic-domains-creating-configuration-alias"></a>

Untuk membuat alias konfigurasi yang akan digunakan untuk penggantian domain menggunakan MediaTailor konsol, lakukan prosedur berikut.

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

**Untuk membuat alias konfigurasi menggunakan konsol**

1. Buka MediaTailor konsol di [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Pada bagian **Configuration alias** pada halaman **Configurations**, pilih **Add player parameter**. 

1. Untuk **parameter Player**, masukkan nama parameter pemain yang ingin Anda gunakan sebagai variabel dinamis. Misalnya, `player_params.origin_domain`. 

1. Untuk **Alias**, masukkan alias dan nilainya yang ingin Anda gunakan untuk parameter pemain. 

1. Pilih **OK**. 

   AWS Elemental MediaTailor menampilkan parameter baru dalam tabel di bagian **Alias Konfigurasi**.

1. Ulangi langkah sebelumnya untuk menambahkan lebih banyak parameter pemain. 

1. Pilih **Simpan**. 

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

**Untuk membuat alias konfigurasi menggunakan API**  
Saat Anda membuat atau memperbarui MediaTailor konfigurasi, gunakan `ConfigurationAliases` parameter dengan struktur JSON berikut: 

```
{
                "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"
                }
                }
                }
```

------

## Langkah 2: Gunakan alias konfigurasi dalam inisialisasi sesi
<a name="dynamic-domains-using-configuration-alias"></a>

Setelah menyiapkan alias konfigurasi, Anda dapat menggunakannya sebagai variabel pengganti untuk domain dalam permintaan inisialisasi sesi Anda. Hal ini memungkinkan Anda untuk secara dinamis mengkonfigurasi domain untuk sesi Anda.

**Example Contoh alias konfigurasi dasar**  
Berikut adalah contoh dasar konfigurasi yang mencakup alias konfigurasi dan variabel domain dinamis:  

```
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 Inisialisasi sesi dengan alias**  
Menggunakan konfigurasi sebelumnya, permintaan inisialisasi sesi menggunakan variabel pemain dan alias akan terlihat mirip dengan yang berikut:  

```
POST index.m3u8
{
    "playerParams": {
        "origin_domain": "pdx",
        "region": "pdx",
        "endpoint_id": "pdx",
        "ad_type": "customized"
    }
}
```
MediaTailor menggantikan string alias dengan nilai yang dipetakan dalam konfigurasi alias konfigurasi.  
Permintaan ke ADS akan terlihat seperti berikut:  

```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
Permintaan ke asal manifes akan terlihat seperti berikut:  

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