Abrufen grundlegender und variantenreicher Feature-Flags

Bei Feature-Flag-Konfigurationen (Konfigurationen des TypsAWS.AppConfig.FeatureFlags) ermöglicht Ihnen der AWS AppConfig Agent, ein einzelnes Flag oder eine Teilmenge von Flags in einer Konfiguration abzurufen. Das Abrufen von ein oder zwei Flags ist nützlich, wenn in Ihrem Anwendungsfall nur einige Flags aus dem Konfigurationsprofil verwendet werden müssen. Die folgenden Beispiele verwenden cURL.

Sie können AWS AppConfig Konfigurationsdaten von einem lokalen HTTP-Endpunkt abrufen. Um auf ein bestimmtes Flag oder eine Liste von Flags zuzugreifen, verwenden Sie den ?flag=FLAG_KEY Abfrageparameter für ein AWS AppConfig Konfigurationsprofil.

Um ein einzelnes Flag und seine Attribute abzurufen

curl "http://localhost:2772/applications/APPLICATION_NAME/environments/ENVIRONMENT_NAME/configurations/CONFIGURATION_NAME?flag=FLAG_KEY"

Um mehrere Flaggen und ihre Attribute abzurufen

curl "http://localhost:2772/applications/APPLICATION_NAME/environments/ENVIRONMENT_NAME/configurations/CONFIGURATION_NAME?flag=FLAG_KEY_ONE&flag=FLAG_KEY_TWO"

Um Feature-Flag-Varianten basierend auf dem Anruferkontext abzurufen

Die folgenden cURL-Beispiele zeigen, wie Feature-Flag-Varianten basierend auf dem Anruferkontext abgerufen werden. Um am besten zu veranschaulichen, wie diese Aufrufe getätigt werden, werden in diesem Abschnitt Beispielanrufe verwendet, die auf einem Szenario basieren, in dem ein Kunde Varianten ähnlich den folgenden erstellt hat:

So rufen Sie Flaggendaten im Anruferkontext von jane_doe@example.org ab (der sich nicht für das Beta-Programm angemeldet hat):

curl http://localhost:2772/applications/UIRefresh/environments/Production/configurations/Features \
-H "Context: email=jane_doe@example.org" \
-H "Context: opted_in_to_beta=false"
{
  "ui_refresh": {"_variant":"QA","dark_mode_support":true,"enabled":true}
}

So rufen Sie Flaggendaten mithilfe des Anruferkontexts von jane_doe@example.org ab (wer hat sich für das Beta-Programm angemeldet):

curl http://localhost:2772/applications/UIRefresh/environments/Production/configurations/Features \
-H "Context: email=jane_doe@example.org" \
-H "Context: opted_in_to_beta=true"
{
  "ui_refresh": {"_variant":"QA","dark_mode_support":true,"enabled":true}
}

So rufen Sie Flaggendaten im Anruferkontext von jane_doe@qa-testers.example.org ab (der bei Example Organization als Qualitätssicherungstester tätig ist):

curl http://localhost:2772/applications/UIRefresh/environments/Production/configurations/Features \
-H "Context: email=jane_doe@qa-testers.example.org" 
{
  "ui_refresh": {"_variant":"QA","dark_mode_support":true,"enabled":true}
}

Um Flaggendaten ohne Anruferkontext abzurufen (was die Standardvariante zurückgibt)

curl http://localhost:2772/applications/UIRefresh/environments/Production/configurations/Features
{
"ui_refresh": {"_variant":"Default Variant","enabled":false}
}

Um Flaggendaten für ein Traffic Splitting-Szenario abzurufen, um festzustellen, ob 1 von 10 zufälligen Anrufern die Variante „Stichprobenpopulation“ erhält

for i in {0..9} do ; \
curl http://localhost:2772/applications/UIRefresh/environments/Production/configurations/Features \
-H "Context: email=$i@example.org"
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}
{
  "ui_refresh": {"_variant":"Sample Population","dark_mode_support":false,"enabled":true}
}
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}
{
  "ui_refresh": {"_variant":"Default Variant","enabled":false}
}