本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立特徵標記組態描述檔 （命令列）
<a name="appconfig-creating-feature-flag-configuration-commandline"></a>

下列程序說明如何使用 AWS Command Line Interface （在 Linux 或 Windows 上） 或 Tools for Windows PowerShell 來建立 AWS AppConfig 功能旗標組態描述檔。在建立組態設定檔時，您也可以建立基本功能旗標。

**建立功能旗標組態**

1. 開啟 AWS CLI。

1. 建立特徵標記組態描述檔，將其**類型**指定為 `AWS.AppConfig.FeatureFlags`。組態設定檔必須使用 `hosted`做為位置 URI。

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

   ```
   aws appconfig create-configuration-profile \
     --application-id {{APPLICATION_ID}} \
     --name {{CONFIGURATION_PROFILE_NAME}} \
     --location-uri hosted \
     --type AWS.AppConfig.FeatureFlags
   ```

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

   ```
   aws appconfig create-configuration-profile ^
     --application-id {{APPLICATION_ID}} ^
     --name {{CONFIGURATION_PROFILE_NAME}} ^
     --location-uri hosted ^
     --type AWS.AppConfig.FeatureFlags
   ```

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

   ```
   New-APPCConfigurationProfile `
     -Name {{CONFIGURATION_PROFILE_NAME}} `
     -ApplicationId {{APPLICATION_ID}} `
     -LocationUri hosted `
     -Type AWS.AppConfig.FeatureFlags
   ```

------

1. 建立您的特徵標記組態資料。您的資料必須採用 JSON 格式並符合 `AWS.AppConfig.FeatureFlags` JSON 結構描述。如需結構描述的詳細資訊，請參閱 [了解 的類型參考 AWS.AppConfig.FeatureFlags](appconfig-type-reference-feature-flags.md)。

1. 使用 `CreateHostedConfigurationVersion` API 來儲存您的特徵標記組態資料 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
   ```

------
#### [ 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
   ```

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

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

------

   命令會從磁碟載入為 `Content` 參數指定的內容。內容必須與下列範例類似。

   ```
   {
       "flags": {
           "ui_refresh": {
               "name": "UI Refresh"
           }
       },
       "values": {
           "ui_refresh": {
               "enabled": false,
               "attributeValues": {
                   "dark_mode_support": true
               }
           }
       },
       "version": "1"
   }
   ```

   系統會傳回如下資訊。

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

   ```
   {
      "ApplicationId"          : "ui_refresh",
      "ConfigurationProfileId" : "UI Refresh",
      "VersionNumber"          : "1",
      "ContentType"            : "application/json"
   }
   ```

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

   ```
   {
      "ApplicationId"          : "ui_refresh",
      "ConfigurationProfileId" : "UI Refresh",
      "VersionNumber"          : "1",
      "ContentType"            : "application/json"
   }
   ```

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

   ```
   ApplicationId          : ui_refresh
   ConfigurationProfileId : UI Refresh
   VersionNumber          : 1
   ContentType            : application/json
   ```

------

   `service_returned_content_file` 包含您的組態資料，其中包含一些 AWS AppConfig 產生的中繼資料。
**注意**  
當您建立託管組態版本時， 會 AWS AppConfig 驗證您的資料是否符合 `AWS.AppConfig.FeatureFlags` JSON 結構描述。 AWS AppConfig 還會驗證資料中的每個特徵標記屬性是否符合您為這些屬性定義的限制。