创建多变体功能标志

访问 https://console.aws.amazon.com/systems-manager/appconfig/，打开 Amazon Systems Manager 控制台。

在导航窗格中，选择应用程序，然后选择一个应用程序。

在配置文件和功能标志选项卡上，选择现有的功能标志配置文件。

在标志部分中，选择添加新标志。

在功能标志定义部分中，对于标志名称输入名称。

对于标志键，输入一个标志标识符来区分同一配置文件中的标志。相同配置文件中的标志不能具有相同的键。创建标志后，可以编辑标志名称，但不能编辑标志键。

（可选）在描述字段中，输入有关此标志的信息。

在变体部分中，选择多变体标志。

（可选）在功能标志属性部分中，选择定义属性。属性使您能够在标志中提供其他值。有关属性和约束的更多信息，请参阅了解功能标志属性。

1. 对于键，指定一个标志键并从类型列表中选择其类型。有关值和约束字段支持的选项的信息，请参阅前面引用的有关属性的部分。

2. 选择必需值以指定属性值是否为必需值。

3. 选择定义属性来添加其它属性。

4. 选择应用以保存属性更改。

在功能标志变体部分中，选择创建变体。

1. 对于变体名称，输入名称。

2. 使用已启用值开关来启用该变体。

3. 在规则文本框中，输入规则。

4. 使用创建变体 > 在上面创建变体或在下面创建变体选项，来为该标志创建其它变体。

5. 在默认变体部分中，使用已启用值开关来启用默认变体。（可选）为在步骤 10 中定义的属性提供值。

6. 选择 应用。

验证标志及其变体的详细信息，然后选择创建标志。

在本地计算机上创建配置文件，该配置文件将指定要创建的多变体标志的详细信息。使用 .json 文件扩展名保存该文件。该文件必须符合 AWS.AppConfig.FeatureFlags JSON 架构。配置文件的架构内容将类似于以下内容。

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

以下是包含三个变体和默认变体的示例。

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

使用 CreateHostedConfigurationVersion API 将功能标志配置数据保存到 Amazon AppConfig。

service_returned_content_file 包含您的配置数据，其中包括一些 Amazon AppConfig 生成的元数据。