基本およびマルチバリアント機能フラグの取得

機能フラグ設定 (AWS.AppConfig.FeatureFlags タイプの設定) の場合、AWS AppConfig エージェントを使用すると、設定内の単一のフラグまたはフラグのサブセットを取得できます。設定プロファイルからいくつかのフラグのみを使用する必要があるユースケースの場合、1 つまたは 2 つのフラグを取得すると便利です。次の例では Python を使用しています。

AWS AppConfig 設定データはローカル HTTP エンドポイントから取得できます。特定のフラグまたはフラグのリストにアクセスするには、?flag=flag_name 設定プロファイルの AWS AppConfig クエリパラメータを使用します。

1 つのフラグとその属性を取得するには

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

複数のフラグとその属性を取得するには

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

発信者コンテキストに基づいて機能フラグバリアントを取得するには

次の Python の例は、発信者コンテキストに基づいて機能フラグバリアントを取得する方法を示しています。これらの呼び出しを行う方法を分かりやすく説明するために、このセクションでは、顧客が次のバリアントを作成したシナリオに基づいてサンプル呼び出しを使用します。

jane_doe@example.org (ベータプログラムにオプトインしていないユーザー) の発信者コンテキストを使用してフラグデータを取得するには:

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}
}

jane_doe@example.org (ベータプログラムにオプトインしているユーザー) の発信者コンテキストを使用してフラグデータを取得するには:

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}
}

jane_doe@qa-testers.example.org (Example Organization の品質保証テスター) の発信者コンテキストを使用してフラグデータを取得するには:

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}
}

発信者コンテキストなしでフラグデータを取得するには (デフォルトバリアントを返します)

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

トラフィック分割シナリオのフラグデータを取得して、ランダムに選ばれた 10 人の発信者のうち 1 人が「サンプルポピュレーション」バリアントを受信しているかどうかを判断するには

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}
}