建立特徵標記組態描述檔 （命令列） - AWS AppConfig

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

建立特徵標記組態描述檔 （命令列）

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

建立特徵標記組態

  1. 開啟 AWS CLI。

  2. 建立特徵標記組態描述檔，將其類型指定為 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

  3. 建立您的特徵標記組態資料。您的資料必須採用 JSON 格式並符合 AWS.AppConfig.FeatureFlags JSON 結構描述。如需結構描述的詳細資訊，請參閱 了解 的類型參考 AWS.AppConfig.FeatureFlags。

  4. 使用 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 還會驗證資料中的每個特徵標記屬性是否符合您為這些屬性定義的限制。