AWS AppConfig 托管配置实战使用 aws-cli create-hosted-configuration-version 创建托管配置版本【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli本篇围绕 aws-cli 的aws appconfig create-hosted-configuration-version命令展开完整讲解如何向 AWS AppConfig 托管配置存储hosted configuration store提交一份 Base64 编码的配置内容创建出带版本号、MIME 类型与可选版本标签的配置版本。读完本文你将能够独立执行该命令、理解每个参数的取值约束与底层行为包括响应流式落盘机制、乐观锁防并发机制并将该命令嵌入“创建应用 → 创建配置档案 → 创建配置版本 → 校验 → 部署 → 拉取配置”的完整工作流中。一、创建托管配置版本命令、输出与文件落盘原始示例文档位于 create-hosted-configuration-version.rst其核心操作是将配置内容先转换为 Base64再通过 CLI 提交给托管配置存储。完整命令如下aws appconfig create-hosted-configuration-version \ --application-id 339ohji \ --configuration-profile-id ur8hx2f \ --content eyAiTmFtZSI6ICJFeGFtcGxlQXBwbGljYXRpb24iLCAiSWQiOiBFeGFtcGxlSUQsICJSYW5rIjogNyB9 \ --content-type application/json \ configuration_version_output_file其中339ohji是示例应用 ID可通过 create-application.rst 中create-application命令的返回Id字段获得ur8hx2f是配置档案 ID来自 create-configuration-profile.rst 中create-configuration-profile的返回Id字段。命令末尾的configuration_version_output_file是一个位置参数outfile命令执行成功后服务返回的配置内容会被写入该文件其内容为{ Name: ExampleApplication, Id: ExampleID, Rank: 7 }命令的标准输出JSON如下{ ApplicationId: 339ohji, ConfigurationProfileId: ur8hx2f, VersionNumber: 1, ContentType: application/json }VersionNumber由 AppConfig 自动分配从1开始单调递增是后续validate-configuration、start-deployment、get-hosted-configuration-version等操作引用该配置版本的唯一依据。二、命令参数逐项解析基于 API 服务模型该命令对应 AWS AppConfig API 2019-10-09 版本的CreateHostedConfigurationVersion操作。在仓库内置的服务模型 service-2.json 中该操作被定义为HTTP 请求POST /applications/{ApplicationId}/configurationprofiles/{ConfigurationProfileId}/hostedconfigurationversions成功时返回状态码 201请求体payload为Content即 Base64 编码后的配置数据。结合请求结构定义CreateHostedConfigurationVersionRequest各参数说明如下参数CLI 选项是否必填说明应用 ID--application-id是目标应用的 ID作为 URI 路径的一部分传递配置档案 ID--configuration-profile-id是目标配置档案 ID同样位于 URI 路径中配置内容--content是配置数据bytes。AppConfig 接受任意类型数据包括 JSON、TOML 等文本格式以及 Protocol Buffers、压缩数据等二进制格式CLI 侧必须以 Base64 字符串传递内容类型--content-type是标准 MIME 类型描述配置内容的格式如application/json通过 HTTP 头Content-Type传递描述--description否配置描述。注意受 HTTP 头长度限制该字段仅支持 ASCII 字符最新版本号锁--latest-version-number否乐观锁令牌。快速连续创建多个版本时传入当前最新版本号可防止并发请求互相覆盖通过头Latest-Version-Number传递版本标签--version-label否用户自定义的版本标签必须至少包含一个非数字字符例如v2.2.0响应结构HostedConfigurationVersion中ApplicationId、ConfigurationProfileId、VersionNumber、Description、ContentType、VersionLabel、KmsKeyArn均通过 HTTP 头返回如Application-Id、Version-Number、Content-Type而Content作为响应 payload 流式返回——这正是 CLI 能把它直接落盘为文件的根本原因下文第四节详述。其中KmsKeyArn字段标识用于加密该版本配置数据的 KMS 密钥 ARN。三、Base64 内容转换原文与编码的对应关系示例中--content的取值eyAiTmFtZSI6ICJFeGFtcGxlQXBwbGljYXRpb24iLCAiSWQiOiBFeGFtcGxlSUQsICJSYW5rIjogNyB9就是示例 JSON 原文{ Name: ExampleApplication, Id: ExampleID, Rank: 7 }的 Base64 编码。两者逐段对应开头的eyAiTmFtZSI6解码后正是{ Name:结尾的ICJSYW5rIjogNyB9解码后为Rank: 7 }。这一转换要求源于 API 契约中Content字段是Blob类型且作为请求 payload 传输。实际使用时可以用base64命令本地生成例如将config.json转码base64 -i config.json -o config.b64 # 创建版本时传入文件内容注意处理换行由于--content需要把整段 Base64 作为命令行参数传入超大配置会受 shell 参数长度限制约束此外服务模型中列出的PayloadTooLargeException错误也表明服务端对配置体积存在配额限制。四、aws-cli 如何把响应内容写入 outfile命令末尾的位置参数configuration_version_output_file不是普通参数而是 aws-cli 为“有流式输出”的操作自动注入的 outfile 参数。其实现位于 streamingoutputarg.pyadd_streaming_output_arg见 streamingoutputarg.py#L18-L27挂在building-argument-table事件上当操作模型has_streaming_output为真时CreateHostedConfigurationVersion的输出形状声明了payload: Content即满足向参数表注入名为outfile的必填位置参数参数确定后add_to_params见 streamingoutputarg.py#L87-L92注册after-call.appconfig.CreateHostedConfigurationVersion钩子在调用返回后执行落盘save_file见 streamingoutputarg.py#L94-L110以二进制模式按 32768 字节缓冲逐块写出响应体写完后从解析结果中删除流式字段因此标准输出中只保留头信息解析出的元数据ApplicationId、ConfigurationProfileId、VersionNumber、ContentType而配置原文出现在你指定的文件里。这也解释了示例输出中为何没有Content字段、而配置文件里却有完整 JSON——两者是同一响应的 payload 部分与头信息部分被 CLI 分流处理。五、完整工作流从应用创建到配置拉取create-hosted-configuration-version处于 AppConfig 工作流的中枢位置仓库 examples 目录下的 appconfig 示例文档 中各示例使用了同一套资源 ID339ohji/ur8hx2f/54j1r29/1225qzk可以连成一条端到端链路创建应用aws appconfig create-application --name example-application ...返回Id: 339ohji见 create-application.rst。创建配置档案aws appconfig create-configuration-profile --application-id 339ohji --name ...返回Id: ur8hx2f见 create-configuration-profile.rst。注意托管配置版本必须挂在配置档案之下。创建托管配置版本本文的主体命令获得VersionNumber: 1。校验配置aws appconfig validate-configuration --application-id ... --configuration-profile-id ... --configuration-version 1使用配置档案上配置的 validators 校验指定版本成功时无输出见 validate-configuration.rst。查询与清理查询详情aws appconfig get-hosted-configuration-version --application-id 339ohji --configuration-profile-id ur8hx2f --version-number 1 hosted-configuration-version-output同样支持 outfile 落盘见 get-hosted-configuration-version.rst列出版本aws appconfig list-hosted-configuration-versions --application-id 339ohji --configuration-profile-id ur8hx2f见 list-hosted-configuration-versions.rst删除版本aws appconfig delete-hosted-configuration-version --application-id 339ohji --configuration-profile-id ur8hx2f --version-number 1见 delete-hosted-configuration-version.rst。启动部署aws appconfig start-deployment --application-id 339ohji --environment-id 54j1r29 --deployment-strategy-id 1225qzk --configuration-profile-id ur8hx2f --configuration-version 1返回含State: DEPLOYING、GrowthType等字段的部署对象见 start-deployment.rst。应用端拉取aws appconfig get-configuration --application example-application --environment Example-Environment --configuration Example-Configuration-Profile --client-id test-id configuration-output-file。示例文档特别提示后续调用应带上client-configuration-version参数仅当版本变化时才更新本地配置避免因频繁拉取产生额外费用见 get-configuration.rst。六、常见错误与排查服务模型为该操作声明了以下错误类型排查时可对号入座错误含义与排查方向ResourceNotFoundException--application-id或--configuration-profile-id不存在或无权限可见先用list-applications/list-configuration-profiles核对 IDBadRequestException请求体或参数非法如--content不是合法 Base64、--content-type格式错误、--description含非 ASCII 字符ConflictException与--latest-version-number乐观锁相关传入的最新版本号与服务端实际最新版本不一致说明并发写入冲突应重新读取最新版本号后重试PayloadTooLargeException配置内容超过服务端配额限制需拆分或压缩配置ServiceQuotaExceededException触达账户级服务配额如版本数量上限InternalServerException服务端内部错误可稍后重试创建后可立即用get-hosted-configuration-version或list-hosted-configuration-versions验证版本是否落库这是仓库示例中推荐的确认方式。七、小结create-hosted-configuration-version是 AppConfig 托管配置工作流的核心写入点必填四元组--application-id、--configuration-profile-id、--content、--content-type确定了“往哪个应用、哪个档案、写入什么格式的内容”--latest-version-number提供并发安全--version-label提供人类可读的版本标识而 aws-cli 的 outfile 机制streamingoutputarg.py则保证配置原文与响应元数据分离、直接落盘可用。结合仓库中 service-2.json 的 API 定义与 appconfig 示例集可以覆盖从创建、校验、部署到拉取、清理的完整生命周期操作。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
AWS AppConfig 托管配置实战：使用 aws-cli create-hosted-configuration-version 创建托管配置版本
AWS AppConfig 托管配置实战使用 aws-cli create-hosted-configuration-version 创建托管配置版本【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli本篇围绕 aws-cli 的aws appconfig create-hosted-configuration-version命令展开完整讲解如何向 AWS AppConfig 托管配置存储hosted configuration store提交一份 Base64 编码的配置内容创建出带版本号、MIME 类型与可选版本标签的配置版本。读完本文你将能够独立执行该命令、理解每个参数的取值约束与底层行为包括响应流式落盘机制、乐观锁防并发机制并将该命令嵌入“创建应用 → 创建配置档案 → 创建配置版本 → 校验 → 部署 → 拉取配置”的完整工作流中。一、创建托管配置版本命令、输出与文件落盘原始示例文档位于 create-hosted-configuration-version.rst其核心操作是将配置内容先转换为 Base64再通过 CLI 提交给托管配置存储。完整命令如下aws appconfig create-hosted-configuration-version \ --application-id 339ohji \ --configuration-profile-id ur8hx2f \ --content eyAiTmFtZSI6ICJFeGFtcGxlQXBwbGljYXRpb24iLCAiSWQiOiBFeGFtcGxlSUQsICJSYW5rIjogNyB9 \ --content-type application/json \ configuration_version_output_file其中339ohji是示例应用 ID可通过 create-application.rst 中create-application命令的返回Id字段获得ur8hx2f是配置档案 ID来自 create-configuration-profile.rst 中create-configuration-profile的返回Id字段。命令末尾的configuration_version_output_file是一个位置参数outfile命令执行成功后服务返回的配置内容会被写入该文件其内容为{ Name: ExampleApplication, Id: ExampleID, Rank: 7 }命令的标准输出JSON如下{ ApplicationId: 339ohji, ConfigurationProfileId: ur8hx2f, VersionNumber: 1, ContentType: application/json }VersionNumber由 AppConfig 自动分配从1开始单调递增是后续validate-configuration、start-deployment、get-hosted-configuration-version等操作引用该配置版本的唯一依据。二、命令参数逐项解析基于 API 服务模型该命令对应 AWS AppConfig API 2019-10-09 版本的CreateHostedConfigurationVersion操作。在仓库内置的服务模型 service-2.json 中该操作被定义为HTTP 请求POST /applications/{ApplicationId}/configurationprofiles/{ConfigurationProfileId}/hostedconfigurationversions成功时返回状态码 201请求体payload为Content即 Base64 编码后的配置数据。结合请求结构定义CreateHostedConfigurationVersionRequest各参数说明如下参数CLI 选项是否必填说明应用 ID--application-id是目标应用的 ID作为 URI 路径的一部分传递配置档案 ID--configuration-profile-id是目标配置档案 ID同样位于 URI 路径中配置内容--content是配置数据bytes。AppConfig 接受任意类型数据包括 JSON、TOML 等文本格式以及 Protocol Buffers、压缩数据等二进制格式CLI 侧必须以 Base64 字符串传递内容类型--content-type是标准 MIME 类型描述配置内容的格式如application/json通过 HTTP 头Content-Type传递描述--description否配置描述。注意受 HTTP 头长度限制该字段仅支持 ASCII 字符最新版本号锁--latest-version-number否乐观锁令牌。快速连续创建多个版本时传入当前最新版本号可防止并发请求互相覆盖通过头Latest-Version-Number传递版本标签--version-label否用户自定义的版本标签必须至少包含一个非数字字符例如v2.2.0响应结构HostedConfigurationVersion中ApplicationId、ConfigurationProfileId、VersionNumber、Description、ContentType、VersionLabel、KmsKeyArn均通过 HTTP 头返回如Application-Id、Version-Number、Content-Type而Content作为响应 payload 流式返回——这正是 CLI 能把它直接落盘为文件的根本原因下文第四节详述。其中KmsKeyArn字段标识用于加密该版本配置数据的 KMS 密钥 ARN。三、Base64 内容转换原文与编码的对应关系示例中--content的取值eyAiTmFtZSI6ICJFeGFtcGxlQXBwbGljYXRpb24iLCAiSWQiOiBFeGFtcGxlSUQsICJSYW5rIjogNyB9就是示例 JSON 原文{ Name: ExampleApplication, Id: ExampleID, Rank: 7 }的 Base64 编码。两者逐段对应开头的eyAiTmFtZSI6解码后正是{ Name:结尾的ICJSYW5rIjogNyB9解码后为Rank: 7 }。这一转换要求源于 API 契约中Content字段是Blob类型且作为请求 payload 传输。实际使用时可以用base64命令本地生成例如将config.json转码base64 -i config.json -o config.b64 # 创建版本时传入文件内容注意处理换行由于--content需要把整段 Base64 作为命令行参数传入超大配置会受 shell 参数长度限制约束此外服务模型中列出的PayloadTooLargeException错误也表明服务端对配置体积存在配额限制。四、aws-cli 如何把响应内容写入 outfile命令末尾的位置参数configuration_version_output_file不是普通参数而是 aws-cli 为“有流式输出”的操作自动注入的 outfile 参数。其实现位于 streamingoutputarg.pyadd_streaming_output_arg见 streamingoutputarg.py#L18-L27挂在building-argument-table事件上当操作模型has_streaming_output为真时CreateHostedConfigurationVersion的输出形状声明了payload: Content即满足向参数表注入名为outfile的必填位置参数参数确定后add_to_params见 streamingoutputarg.py#L87-L92注册after-call.appconfig.CreateHostedConfigurationVersion钩子在调用返回后执行落盘save_file见 streamingoutputarg.py#L94-L110以二进制模式按 32768 字节缓冲逐块写出响应体写完后从解析结果中删除流式字段因此标准输出中只保留头信息解析出的元数据ApplicationId、ConfigurationProfileId、VersionNumber、ContentType而配置原文出现在你指定的文件里。这也解释了示例输出中为何没有Content字段、而配置文件里却有完整 JSON——两者是同一响应的 payload 部分与头信息部分被 CLI 分流处理。五、完整工作流从应用创建到配置拉取create-hosted-configuration-version处于 AppConfig 工作流的中枢位置仓库 examples 目录下的 appconfig 示例文档 中各示例使用了同一套资源 ID339ohji/ur8hx2f/54j1r29/1225qzk可以连成一条端到端链路创建应用aws appconfig create-application --name example-application ...返回Id: 339ohji见 create-application.rst。创建配置档案aws appconfig create-configuration-profile --application-id 339ohji --name ...返回Id: ur8hx2f见 create-configuration-profile.rst。注意托管配置版本必须挂在配置档案之下。创建托管配置版本本文的主体命令获得VersionNumber: 1。校验配置aws appconfig validate-configuration --application-id ... --configuration-profile-id ... --configuration-version 1使用配置档案上配置的 validators 校验指定版本成功时无输出见 validate-configuration.rst。查询与清理查询详情aws appconfig get-hosted-configuration-version --application-id 339ohji --configuration-profile-id ur8hx2f --version-number 1 hosted-configuration-version-output同样支持 outfile 落盘见 get-hosted-configuration-version.rst列出版本aws appconfig list-hosted-configuration-versions --application-id 339ohji --configuration-profile-id ur8hx2f见 list-hosted-configuration-versions.rst删除版本aws appconfig delete-hosted-configuration-version --application-id 339ohji --configuration-profile-id ur8hx2f --version-number 1见 delete-hosted-configuration-version.rst。启动部署aws appconfig start-deployment --application-id 339ohji --environment-id 54j1r29 --deployment-strategy-id 1225qzk --configuration-profile-id ur8hx2f --configuration-version 1返回含State: DEPLOYING、GrowthType等字段的部署对象见 start-deployment.rst。应用端拉取aws appconfig get-configuration --application example-application --environment Example-Environment --configuration Example-Configuration-Profile --client-id test-id configuration-output-file。示例文档特别提示后续调用应带上client-configuration-version参数仅当版本变化时才更新本地配置避免因频繁拉取产生额外费用见 get-configuration.rst。六、常见错误与排查服务模型为该操作声明了以下错误类型排查时可对号入座错误含义与排查方向ResourceNotFoundException--application-id或--configuration-profile-id不存在或无权限可见先用list-applications/list-configuration-profiles核对 IDBadRequestException请求体或参数非法如--content不是合法 Base64、--content-type格式错误、--description含非 ASCII 字符ConflictException与--latest-version-number乐观锁相关传入的最新版本号与服务端实际最新版本不一致说明并发写入冲突应重新读取最新版本号后重试PayloadTooLargeException配置内容超过服务端配额限制需拆分或压缩配置ServiceQuotaExceededException触达账户级服务配额如版本数量上限InternalServerException服务端内部错误可稍后重试创建后可立即用get-hosted-configuration-version或list-hosted-configuration-versions验证版本是否落库这是仓库示例中推荐的确认方式。七、小结create-hosted-configuration-version是 AppConfig 托管配置工作流的核心写入点必填四元组--application-id、--configuration-profile-id、--content、--content-type确定了“往哪个应用、哪个档案、写入什么格式的内容”--latest-version-number提供并发安全--version-label提供人类可读的版本标识而 aws-cli 的 outfile 机制streamingoutputarg.py则保证配置原文与响应元数据分离、直接落盘可用。结合仓库中 service-2.json 的 API 定义与 appconfig 示例集可以覆盖从创建、校验、部署到拉取、清理的完整生命周期操作。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
