

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

# Membuat bendera fitur multi-varian
<a name="appconfig-creating-multi-variant-feature-flags-procedures"></a>

Gunakan prosedur di bagian ini untuk membuat varian dari flag fitur.

**Sebelum Anda mulai**  
Perhatikan informasi penting berikut.
+ Anda dapat membuat varian dari bendera fitur yang ada dengan mengeditnya. Anda tidak dapat membuat varian dari bendera fitur baru * saat membuat profil konfigurasi baru*. Anda harus menyelesaikan alur kerja membuat profil konfigurasi baru terlebih dahulu. Setelah Anda membuat profil konfigurasi, Anda dapat menambahkan varian ke bendera apa pun dalam profil konfigurasi. Untuk informasi tentang cara membuat profil konfigurasi baru, lihat[Membuat profil konfigurasi bendera fitur di AWS AppConfig](appconfig-creating-configuration-and-profile-feature-flags.md).
+ Untuk mengambil data varian tanda fitur untuk platform komputasi Amazon EC2, Amazon ECS, dan Amazon EKS, Anda harus menggunakan AWS AppConfig Agen versi 2.0.4416 atau yang lebih baru.
+ Untuk alasan kinerja, AWS CLI dan panggilan SDK untuk AWS AppConfig tidak mengambil data varian. Untuk informasi lebih lanjut tentang AWS AppConfig Agen, lihat[Cara menggunakan AWS AppConfig Agen untuk mengambil data konfigurasi](appconfig-agent-how-to-use.md).
+ Saat Anda membuat varian bendera fitur, Anda menentukan aturan untuk itu. Aturan adalah ekspresi yang mengambil konteks permintaan sebagai input dan menghasilkan hasil boolean sebagai output. Sebelum Anda membuat varian, tinjau operan dan operator yang didukung untuk aturan varian tanda. Anda dapat membuat aturan sebelum membuat varian. Untuk informasi selengkapnya, lihat [Memahami aturan bendera fitur multi-varian](appconfig-creating-multi-variant-feature-flags-rules.md).

**Topics**
+ [Membuat bendera fitur multi-varian (konsol)](#appconfig-creating-multi-variant-feature-flags-procedures-console)
+ [Membuat bendera fitur multi-varian (baris perintah)](#appconfig-creating-multi-variant-feature-flags-procedures-commandline)

## Membuat bendera fitur multi-varian (konsol)
<a name="appconfig-creating-multi-variant-feature-flags-procedures-console"></a>

Prosedur berikut menjelaskan cara membuat flag fitur multi-varian untuk profil konfigurasi yang ada dengan menggunakan AWS AppConfig konsol. Anda juga dapat mengedit bendera fitur yang ada untuk membuat varian.

**Untuk membuat bendera fitur multi-varian**

1. Buka AWS Systems Manager konsol di [ https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/).

1. Di panel navigasi, pilih ** Aplikasi**, lalu pilih aplikasi.

1. Pada ** tab Profil ** konfigurasi dan bendera fitur, pilih profil konfigurasi bendera fitur yang ada.

1. Di ** bagian Ben ** dera, pilih ** Tambahkan bendera baru**.

1. Di ** bagian Definisi bendera ** fitur, untuk Nama ** bendera**, masukkan nama.

1. Untuk kunci ** Flag ** masukkan pengidentifikasi bendera untuk membedakan flag dalam profil konfigurasi yang sama. Bendera dalam profil konfigurasi yang sama tidak dapat memiliki kunci yang sama. Setelah bendera dibuat, Anda dapat mengedit nama bendera, tetapi tidak tombol bendera. 

1. (Opsional) Di ** bidang ** Deskripsi, masukkan informasi tentang bendera ini.

1. Di ** bagian ** Varian, pilih ** Multi-variant bendera**.

1. (Opsional) Di ** bagian atribut bendera ** fitur, pilih ** Definisikan atribut**. Atribut memungkinkan Anda untuk memberikan nilai tambahan dalam bendera Anda. Untuk informasi selengkapnya tentang atribut dan batasan, lihat[Memahami atribut bendera fitur](appconfig-creating-configuration-and-profile-feature-flags.md#appconfig-creating-configuration-profile-feature-flag-attributes).

   1. Untuk ** Kunci**, tentukan kunci bendera dan pilih jenisnya dari ** daftar ** Jenis. Untuk informasi tentang opsi yang didukung untuk ** bidang ** Nilai ** dan Batasan**, lihat bagian yang direferensikan sebelumnya tentang atribut.

   1. Pilih ** Nilai yang diperlukan ** untuk menentukan apakah nilai atribut diperlukan.

   1. Pilih ** Definisikan atribut ** untuk menambahkan atribut tambahan.

   1. Pilih ** Terapkan ** untuk menyimpan perubahan atribut.

1. Di ** bagian Varian bendera ** fitur, pilih ** Buat varian**.

   1. Untuk ** Nama Varian**, masukkan nama.

   1. Gunakan sak ** elar Nilai ** yang diaktifkan untuk mengaktifkan varian.

   1. Di kotak ** teks A ** turan, masukkan aturan.

   1. Gunakan ** opsi ** Buat varian ** > ** Buat varian di atas ** atau ** Buat varian di bawah untuk membuat varian tambahan untuk bendera ini. 

   1. Di ** bagian ** Varian default, gunakan sak ** elar Nilai ** diaktifkan untuk mengaktifkan varian default. Secara opsional, berikan nilai untuk atribut yang ditentukan pada langkah 10.

   1. Pilih **Terapkan**.

1. Verifikasi detail bendera dan variannya dan pilih ** Buat bendera**.

Untuk informasi tentang penerapan bendera fitur baru Anda dengan varian, lihat[Menyebarkan flag fitur dan data konfigurasi di AWS AppConfig](deploying-feature-flags.md).

## Membuat bendera fitur multi-varian (baris perintah)
<a name="appconfig-creating-multi-variant-feature-flags-procedures-commandline"></a>

Prosedur berikut menjelaskan cara menggunakan AWS Command Line Interface (di Linux atau Windows) atau Tools untuk Windows PowerShell untuk membuat flag fitur multi-varian untuk profil konfigurasi yang ada. Anda juga dapat mengedit bendera fitur yang ada untuk membuat varian.

**Sebelum Anda mulai**  
Selesaikan tugas berikut sebelum Anda membuat tanda fitur multi-varian dengan menggunakan. AWS CLI
+ Buat profil konfigurasi bendera fitur. Untuk informasi selengkapnya, lihat [Membuat profil konfigurasi bendera fitur di AWS AppConfig](appconfig-creating-configuration-and-profile-feature-flags.md).
+ Perbarui ke versi terbaru dari AWS CLI. Untuk informasi selengkapnya, lihat Meng [ instal atau memperbarui ke versi terbaru AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) di Panduan *AWS Command Line Interface Pengguna*.

**Untuk membuat bendera fitur multi-varian**

1. Buat file konfigurasi pada mesin lokal Anda yang menentukan detail flag multi-varian yang ingin Anda buat. Simpan file dengan ekstensi `.json` file. File harus mematuhi skema [`AWS.AppConfig.FeatureFlags`](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html) JSON. Isi skema file konfigurasi Anda akan serupa dengan yang berikut ini.

   ```
   {
     "flags": {
       "{{FLAG_NAME}}": {
         "attributes": {
             "{{ATTRIBUTE_NAME}}": {
             "constraints": {
               "type": "{{CONSTRAINT_TYPE}}"
             }
           }
         },
         "description": "{{FLAG_DESCRIPTION}}",
         "name": "{{VARIANT_NAME}}"
       }
     },
     "values": {
       "{{VARIANT_VALUE_NAME}}": {
         "_variants": [
           {
             "attributeValues": {
               "{{ATTRIBUTE_NAME}}": {{BOOLEAN}}
             },
             "enabled": {{BOOLEAN}},
             "name": "{{VARIANT_NAME}}",
             "rule": "{{VARIANT_RULE}}"
           },
           {
             "attributeValues": {
               "{{ATTRIBUTE_NAME}}": {{BOOLEAN}}
             },
             "enabled": {{BOOLEAN}},
             "name": "{{VARIANT_NAME}}",
             "rule": "{{VARIANT_RULE}}"
           },
           {
             "attributeValues": {
               "{{ATTRIBUTE_NAME}}": {{BOOLEAN}}
             },
             "enabled": {{BOOLEAN}},
             "name": "{{VARIANT_NAME}}",
             "rule": "{{VARIANT_RULE}}"
           },
           {
             "attributeValues": {
               "{{ATTRIBUTE_NAME}}": {{BOOLEAN}}
             },
             "enabled": {{BOOLEAN}},
             "name": "{{VARIANT_NAME}}",
             "rule": "{{VARIANT_RULE}}"
           }
         ]
       }
     },
     "version": "{{VERSION_NUMBER}}"
   }
   ```

   Berikut adalah contoh dengan tiga varian dan varian default.

   ```
   {
     "flags": {
       "ui_refresh": {
         "attributes": {
           "dark_mode_support": {
             "constraints": {
               "type": "boolean"
             }
           }
         },
         "description": "A release flag used to release a new UI",
         "name": "UI Refresh"
       }
     },
     "values": {
       "ui_refresh": {
         "_variants": [
           {
             "attributeValues": {
               "dark_mode_support": true
             },
             "enabled": true,
             "name": "QA",
             "rule": "(ends_with $email \"qa-testers.mycompany.com\")"
           },
           {
             "attributeValues": {
               "dark_mode_support": true
             },
             "enabled": true,
             "name": "Beta Testers",
             "rule": "(exists key::\"opted_in_to_beta\")"
           },
           {
             "attributeValues": {
               "dark_mode_support": false
             },
             "enabled": true,
             "name": "Sample Population",
             "rule": "(split pct::10 by::$email)"
           },
           {
             "attributeValues": {
               "dark_mode_support": false
             },
             "enabled": false,
             "name": "Default Variant"
           }
         ]
       }
     },
     "version": "1"
   }
   ```

1. Gunakan `CreateHostedConfigurationVersion` API untuk menyimpan data konfigurasi bendera fitur Anda ke AWS AppConfig.

------
#### [ Linux ]

   ```
   aws appconfig create-hosted-configuration-version \
     --application-id {{APPLICATION_ID}} \
     --configuration-profile-id {{CONFIGURATION_PROFILE_ID}} \
     --content-type "application/json" \
     --content {{file://path/to/feature_flag_configuration_data.json \}}
     --cli-binary-format raw-in-base64-out \
     outfile
   ```

------
#### [ Windows ]

   ```
   aws appconfig create-hosted-configuration-version ^
     --application-id {{APPLICATION_ID}} ^
     --configuration-profile-id {{CONFIGURATION_PROFILE_ID}} ^
     --content-type "application/json" ^
     --content {{file://path/to/feature_flag_configuration_data.json}} ^
     --cli-binary-format raw-in-base64-out ^
     outfile
   ```

------
#### [ PowerShell ]

   ```
   New-APPCHostedConfigurationVersion `
     -ApplicationId {{APPLICATION_ID}} `
     -ConfigurationProfileId {{CONFIGURATION_PROFILE_ID}} `
     -ContentType "application/json" `
     -Content {{file://path/to/feature_flag_configuration_data.json}} `
     -Raw
   ```

------

   Ber `service_returned_content_file` isi data konfigurasi Anda yang mencakup beberapa metadata AWS AppConfig yang dihasilkan.
**catatan**  
Saat Anda membuat versi konfigurasi yang dihosting, AWS AppConfig memverifikasi bahwa data Anda sesuai dengan skema [`AWS.AppConfig.FeatureFlags`](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html) JSON. AWS AppConfig Selain itu memvalidasi bahwa setiap atribut flag fitur dalam data Anda memenuhi batasan yang Anda tetapkan untuk atribut tersebut.