本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用清单启用其它检索功能
<a name="appconfig-agent-how-to-use-additional-features"></a>

AWS AppConfig Agent 还提供以下附加功能来帮助您检索应用程序的配置。
+ [将 AWS AppConfig Agent 配置为从多个账户检索配置](appconfig-agent-how-to-use-additional-features-multi-account.md)：使用主账户或*检索* AWS 账户 中的 AWS AppConfig 代理从多个供应商账户检索配置数据。
+ [配置 AWS AppConfig 代理以将配置副本写入磁盘](appconfig-agent-how-to-use-additional-features-write-to-disk.md)：使用 AWS AppConfig 代理将配置数据写入磁盘。此功能使客户能够将从磁盘读取配置数据的应用程序与 AWS AppConfig集成。

## 了解代理清单
<a name="appconfig-agent-how-to-use-additional-features-about-manifests"></a>

要启用这些 AWS AppConfig 代理功能，您需要创建清单。清单是您提供的一组配置数据，用于控制代理可以执行的操作。清单是用 JSON 编写的。它包含一组顶级密钥，这些密钥对应于您部署的不同配置 AWS AppConfig。

清单可以包含多个配置。此外，清单中的每个配置都可以标识一个或多个用于指定配置的代理功能。清单的内容使用以下格式：

```
{
    "{{application_name}}:{{environment_name}}:{{configuration_name}}": {
        "{{agent_feature_to_enable_1}}": {
            "{{feature-setting-key}}": "{{feature-setting-value}}"
        },
        "{{agent_feature_to_enable_2}}": {
            "{{feature-setting-key}}": "{{feature-setting-value}}"
        }
    }
}
```

以下是具有两个配置的清单的 JSON 示例。第一个配置 ({{MyApp}}) 不使用任何 AWS AppConfig 代理功能。第二种配置 ({{My2ndApp}}) 使用将*配置副本写入磁盘*和*多账户检索*功能：

```
{
        "MyApp:Test:MyAllowListConfiguration": {},
        
        "My2ndApp:Beta:MyEnableMobilePaymentsFeatureFlagConfiguration": {
            "credentials": {
                "roleArn": "arn:aws:us-west-1:iam::123456789012:role/MyTestRole",
                "roleExternalId": "00b148e2-4ea4-46a1-ab0f-c422b54d0aac",
                "roleSessionName": "AwsAppConfigAgent",
                "credentialsDuration": "2h"
            },
            "writeTo": {
                "path": "/tmp/aws-appconfig/my-2nd-app/beta/my-enable-payments-feature-flag-configuration.json"
            }
        }
    }
```

**如何提供代理清单**  
您可以将清单作为文件存储在 AWS AppConfig 代理可以读取的位置。或者，您可以将清单存储为 AWS AppConfig 配置并将代理指向它。要提供代理清单，必须使用以下值之一设置 `MANIFEST` 环境变量：


****  

| 清单位置 | 环境变量值 | 使用案例 | 
| --- | --- | --- | 
| 文件 | file:/path/to/agent-manifest.json | 如果清单不经常更改，请使用此方法。 | 
| AWS AppConfig 配置 | {{application-name}}:{{environment-name}}:{{configuration-name}} | 使用此方法进行动态更新。您可以像存储其他 AWS AppConfig 配置一样更新和部署 AWS AppConfig 作为配置存储在中的清单。 | 
| 环境变量 | 清单内容（JSON） | 如果清单不经常更改，请使用此方法。此方法在容器环境中很有用，在此类环境中，设置环境变量比公开文件更容易。 | 

有关为 AWS AppConfig Agent 设置变量的更多信息，请参阅与您的用例相关的主题：
+ [配置 AWS AppConfig 代理 Lambda 扩展](appconfig-integration-lambda-extensions-config.md)
+ [在 Amazon EC2 上使用 AWS AppConfig 代理](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-integration-ec2.html#appconfig-integration-ec2-configuring)
+ [在 Amazon ECS 和 Amazon EKS 上使用 AWS AppConfig 代理](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-integration-containers-agent.html#appconfig-integration-containers-agent-configuring)