Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Erstellen eines Feature-Flags mit mehreren Varianten
Verwenden Sie die Verfahren in diesem Abschnitt, um Varianten eines Feature-Flags zu erstellen.
**Bevor Sie beginnen**
Notieren Sie die folgenden wichtigen Informationen.
+ Sie können Varianten vorhandener Feature-Flags erstellen, indem Sie sie bearbeiten. Sie können keine Varianten eines neuen Feature-Flags *erstellen, wenn Sie ein neues Konfigurationsprofil* erstellen. Sie müssen zuerst den Arbeitsablauf zur Erstellung des neuen Konfigurationsprofils abschließen. Nachdem Sie das Konfigurationsprofil erstellt haben, können Sie jeder Markierung innerhalb des Konfigurationsprofils Varianten hinzufügen. Informationen zum Erstellen eines neuen Konfigurationsprofils finden Sie unter[Erstellen eines Feature-Flag-Konfigurationsprofils in AWS AppConfig](appconfig-creating-configuration-and-profile-feature-flags.md).
+ Um Feature-Flag-Variantendaten für Amazon EC2-, Amazon ECS- und Amazon EKS-Rechenplattformen abzurufen, müssen Sie AWS AppConfig Agent Version 2.0.4416 oder höher verwenden.
+ Aus Leistungsgründen AWS CLI und aus SDK-Aufrufen werden AWS AppConfig keine Variantendaten abgerufen. Weitere Informationen zu AWS AppConfig Agent finden Sie unter[Wie benutzt man den AWS AppConfig Agenten zum Abrufen von Konfigurationsdaten](appconfig-agent-how-to-use.md).
+ Wenn Sie eine Feature-Flag-Variante erstellen, geben Sie eine Regel dafür an. Regeln sind Ausdrücke, die den Anforderungskontext als Eingabe verwenden und als Ausgabe ein boolesches Ergebnis erzeugen. Bevor Sie Varianten erstellen, überprüfen Sie die unterstützten Operanden und Operatoren für Flag-Variantenregeln. Sie können Regeln erstellen, bevor Sie Varianten erstellen. Weitere Informationen finden Sie unter [Grundlegendes zu Feature-Flag-Regeln mit mehreren Varianten](appconfig-creating-multi-variant-feature-flags-rules.md).
**Topics**
+ [Feature-Flag mit mehreren Varianten erstellen (Konsole)](#appconfig-creating-multi-variant-feature-flags-procedures-console)
+ [Ein Feature-Flag mit mehreren Varianten erstellen (Befehlszeile)](#appconfig-creating-multi-variant-feature-flags-procedures-commandline)
## Feature-Flag mit mehreren Varianten erstellen (Konsole)
Im folgenden Verfahren wird beschrieben, wie Sie mithilfe der Konsole ein Feature-Flag mit mehreren Varianten für ein vorhandenes Konfigurationsprofil erstellen. AWS AppConfig Sie können auch vorhandene Feature-Flags bearbeiten, um Varianten zu erstellen.
**Um ein Feature-Flag mit mehreren Varianten zu erstellen**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/).
1. Wählen Sie im Navigationsbereich **Anwendungen** und dann eine Anwendung aus.
1. Wählen Sie auf der Registerkarte **Konfigurationsprofile und Feature-Flags** ein vorhandenes Feature-Flag-Konfigurationsprofil aus.
1. Wählen Sie im Abschnitt **Flags** die Option **Neue Flagge hinzufügen** aus.
1. Geben Sie im Abschnitt **Feature-Flag-Definition** für **Flagname** einen Namen ein.
1. Geben Sie **unter Flag-Schlüssel** eine Flag-ID ein, um Flags innerhalb desselben Konfigurationsprofils voneinander zu unterscheiden. Flags innerhalb desselben Konfigurationsprofils können nicht denselben Schlüssel haben. Nachdem das Flag erstellt wurde, können Sie den Flag-Namen bearbeiten, aber nicht den Flaggenschlüssel.
1. (Optional) Geben Sie im Feld **Beschreibung** Informationen zu dieser Flagge ein.
1. Wählen Sie im Abschnitt **Varianten** die Option **Flagge mit mehreren Varianten** aus.
1. (Optional) Wählen Sie im Abschnitt **Feature-Flag-Attribute** die Option **Attribut definieren** aus. Mithilfe von Attributen können Sie zusätzliche Werte in Ihrer Flagge angeben. Weitere Informationen zu Attributen und Einschränkungen finden Sie unter[Die Attribute von Feature-Flags verstehen](appconfig-creating-configuration-and-profile-feature-flags.md#appconfig-creating-configuration-profile-feature-flag-attributes).
1. Geben Sie für **Schlüssel** einen Flaggenschlüssel an und wählen Sie seinen Typ aus der Liste **Typ** aus. Informationen zu den unterstützten Optionen für die Felder **Wert** und **Einschränkungen** finden Sie im Abschnitt über Attribute, auf den zuvor verwiesen wurde.
1. Wählen Sie **Erforderlicher Wert** aus, um anzugeben, ob ein Attributwert erforderlich ist.
1. Wählen Sie **Attribut definieren**, um weitere Attribute hinzuzufügen.
1. Wählen Sie **Anwenden**, um die Attributänderungen zu speichern.
1. Wählen Sie im Abschnitt **Feature-Flag-Varianten** die Option **Variante erstellen** aus.
1. Geben Sie **unter Variantenname** einen Namen ein.
1. Verwenden Sie den Schalter **Aktivierter Wert**, um die Variante zu aktivieren.
1. Geben Sie im Textfeld **Regel** eine Regel ein.
1. Verwenden Sie die Optionen **Variante erstellen** **> Variante oben** **erstellen oder Variante unten** erstellen, um zusätzliche Varianten für dieses Kennzeichen zu erstellen.
1. Verwenden Sie im Abschnitt **Standardvariante** den Schalter **Aktivierter Wert**, um die Standardvariante zu aktivieren. Geben Sie optional Werte für die in Schritt 10 definierten Attribute an.
1. Wählen Sie **Anwenden** aus.
1. Überprüfen Sie die Details der Markierung und ihrer Varianten und wählen Sie **Flagge erstellen** aus.
Informationen zur Bereitstellung Ihres neuen Feature-Flags mit Varianten finden Sie unter[Bereitstellung von Feature-Flags und Konfigurationsdaten in AWS AppConfig](deploying-feature-flags.md).
## Ein Feature-Flag mit mehreren Varianten erstellen (Befehlszeile)
Das folgende Verfahren beschreibt, wie Sie das AWS Command Line Interface (unter Linux oder Windows) oder Tools für Windows verwenden, PowerShell um ein multivariantes Feature-Flag für ein vorhandenes Konfigurationsprofil zu erstellen. Sie können auch vorhandene Feature-Flags bearbeiten, um Varianten zu erstellen.
**Bevor Sie beginnen**
Führen Sie die folgenden Aufgaben aus, bevor Sie ein Feature-Flag mit mehreren Varianten mithilfe von erstellen. AWS CLI
+ Erstellen Sie ein Feature-Flag-Konfigurationsprofil. Weitere Informationen finden Sie unter [Erstellen eines Feature-Flag-Konfigurationsprofils in AWS AppConfig](appconfig-creating-configuration-and-profile-feature-flags.md).
+ Aktualisieren Sie auf die neueste Version von AWS CLI. Weitere Informationen finden Sie unter [Installieren oder Aktualisieren auf die neueste Version der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) im *AWS Command Line Interface -Benutzerhandbuch*.
**Um ein Feature-Flag mit mehreren Varianten zu erstellen**
1. Erstellen Sie auf Ihrem lokalen Computer eine Konfigurationsdatei, die die Details des Flag mit mehreren Varianten angibt, das Sie erstellen möchten. Speichern Sie die Datei mit einer `.json` Dateierweiterung. Die Datei muss dem [https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html)JSON-Schema entsprechen. Der Schemainhalt Ihrer Konfigurationsdatei wird dem Folgenden ähneln.
```
{
"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"
}
```
Hier ist ein Beispiel mit drei Varianten und der Standardvariante.
```
{
"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. Verwenden Sie die `CreateHostedConfigurationVersion` API, um Ihre Feature-Flag-Konfigurationsdaten zu speichern 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
```
------
Das `service_returned_content_file` enthält Ihre Konfigurationsdaten, die einige AWS AppConfig generierte Metadaten enthalten.
**Anmerkung**
Wenn Sie die gehostete Konfigurationsversion erstellen, wird AWS AppConfig überprüft, ob Ihre Daten dem [https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-type-reference-feature-flags.html)JSON-Schema entsprechen. AWS AppConfig überprüft außerdem, ob jedes Feature-Flag-Attribut in Ihren Daten die Einschränkungen erfüllt, die Sie für diese Attribute definiert haben.