aws-cli 中 aws appconfig get-extension 实战指南查询 AWS AppConfig 扩展详情并读懂返回结构【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli本文以 aws-cli 仓库中的官方示例文档aws appconfig get-extension为核心讲解如何通过 AWS CLI 按名称、ID 或 ARN 查询一个 AWS AppConfig 扩展的完整定义版本、ARN、动作点、参数并结合仓库内 botocore 的 AppConfig 服务模型service-2.json逐项解释请求参数、输出字段、可选动作点枚举与错误响应帮助你写出可复制、可排错的扩展查询命令。1. 命令示例查看一个扩展的完整信息仓库中的官方示例get-extension.rst展示了最基本的用法aws appconfig get-extension \ --region us-west-2 \ --extension-identifier S3-backup-extension执行后返回该扩展的完整定义{ Id: 1A2B3C4D, Name: S3-backup-extension, VersionNumber: 1, Arn: arn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1, Actions: { PRE_CREATE_HOSTED_CONFIGURATION_VERSION: [ { Name: S3backup, Uri: arn:aws:lambda:us-west-2:123456789012:function:S3backupfunction, RoleArn: arn:aws:iam::123456789012:role/appconfigextensionrole } ] }, Parameters: { S3bucket: { Required: true } } }从结构上看这条命令回答的是运维中最常见的一个问题“这个扩展叫什么、哪个版本、在什么生命周期节点被触发、由哪个 Lambda/消息目标执行、需要我传哪些参数”。下面结合仓库中的服务模型逐字段拆解。2. 请求参数--extension-identifier与可选的--version-numberGetExtension在 botocore 服务模型中的定义位于 service-2.jsonAPI 版本2019-10-09HTTP 方法GET /extensions/{ExtensionIdentifier}成功返回 200。--extension-identifier必填对应模型中的ExtensionIdentifier类型是字符串长度 1–2048。文档说明它是“扩展的名称、ID 或 ARN”即三种标识方式任选其一都会放在 URI 路径段中。示例中使用名称S3-backup-extension如果你知道扩展的系统 ID如1A2B3C4D或完整 ARN也可以直接传。--version-number可选指定要查询的扩展版本号。若不提供AppConfig 默认返回最高版本。该字段在模型中标记为box: true整型按字符串传输通过查询参数version_number传递。实操提示在不确定扩展名称时可先用同目录下的 list-extensions.rst 示例执行aws appconfig list-extensions拿到 ID、Name 与 ARN再代入get-extension查询详情。3. 输出字段逐项解析对照服务模型Extension结构模型中Extension输出结构包含以下字段与示例输出一一对应字段类型/含义示例值Id系统生成的扩展 ID1A2B3C4DName扩展名称S3-backup-extensionVersionNumber扩展版本号整数1Arn系统生成的资源 ARNarn:aws:appconfig:us-west-2:123456789012:extension/S3-backup-extension/1Description扩展描述信息示例中未返回可选字段Actions扩展定义的动作集合动作点 → 动作列表见下文Parameters扩展接受的参数定义在创建扩展关联时提供参数值S3bucket: Requiredtrue关于Actions与Parameters模型文档中有两点关键信息值得注意Actions 的数量限制ActionsMap定义为 1–5 个条目min 1、max 5即一个扩展必须定义至少一个动作点、最多五个。Parameters 的用途与限制模型说明“参数值在将扩展关联associate到 AppConfig 资源时指定对于 Lambda 扩展动作这些参数会包含在 Lambda 请求对象中”。ParameterMap定义为 1–10 个条目每个Parameter有三个可选属性Required布尔关联扩展时必须提供该参数值Dynamic布尔表示参数值可以在扩展动作点处动态提供而不是在创建扩展关联时提供。动态参数不能同时标记为RequiredDescription参数说明。示例输出中Parameters.S3bucket.Required true的含义就是把这个扩展关联到应用/配置档案时必须通过create-extension-association提供S3bucket的值通常是目标 S3 桶的 ARN 或名称否则关联会被拒绝。4. 动作点Action Point枚举与 Action 结构示例输出中Actions的键是PRE_CREATE_HOSTED_CONFIGURATION_VERSION。模型中的ActionPoint枚举给出了全部 8 个合法动作点PRE_CREATE_HOSTED_CONFIGURATION_VERSION PRE_START_DEPLOYMENT AT_DEPLOYMENT_TICK ON_DEPLOYMENT_START ON_DEPLOYMENT_STEP ON_DEPLOYMENT_BAKING ON_DEPLOYMENT_COMPLETE ON_DEPLOYMENT_ROLLED_BACK每个动作点的值是一个Action结构列表Action的字段为Name动作名称示例中为S3backupDescription动作说明可选Uri动作关联的目标 URI。模型明确说明它可以是以下目标之一的 ARNLambda 函数、SQS 队列、SNS 主题或 Amazon EventBridge 默认事件总线。示例中的arn:aws:lambda:...:function:S3backupfunction就是一个 Lambda 函数目标RoleArnIAM 角色扮演assume role的 ARN示例中为arn:aws:iam::123456789012:role/appconfigextensionroleAppConfig 使用该角色去调用动作目标。因此读get-extension输出的实用方法是先看Actions的键确认该扩展在部署工作流的哪些节点被触发再看每个动作的Uri与RoleArn确认执行目标与授权链是否完整排查“扩展没有触发”问题时这是第一手依据。5. 错误响应CLI 会如何报错GetExtension在模型中声明了三个错误类型排错时可据此区分问题来源异常HTTP 状态码含义ResourceNotFoundException404找不到请求的资源--extension-identifier拼写错误、扩展在其它 Region、或已删除BadRequestException400输入不满足服务约束含Reason与Details字段辅助定位InternalServerException500服务端内部故障标记为 client 侧可重试的fault注意get-extension是单资源查询、非分页命令模型中的分页器paginators-1.json不适用于它批量查看请用list-extensions。6. 这些示例文档在 aws-cli 仓库中如何生效仓库中 awscli/examples/appconfig/ 目录下的.rst文件是各操作的官方使用示例与examples-1.json共享示例模型配套。从源码结构看service.py 中的get_examples()会通过 loader 读取examples-1模型再由 sharedexample.py 的document_shared_examples()渲染进aws help文档体系。也就是说你在仓库中看到的 get-extension.rst 与aws appconfig get-extension help中的 Examples 小节来源于同一套示例数据示例中的命令、参数命名与实际 CLI 参数严格一致--extension-identifier等可直接复制执行前提是本机已安装 aws-cli 并完成凭证配置。与本文主题直接相关的同类示例还有创建扩展create-extension.rst展示--actions与--parameters的 shorthand 写法是get-extension输出的“对偶”命令列举扩展list-extensions.rst展示 AWS 官方托管扩展如AWS.AppConfig.FeatureFlags、AWS.AppConfig.JiraIntegration、部署通知到 EventBridge/SQS/SNS 的扩展等这些内置扩展同样可用get-extension按名称查询详情删除扩展delete-extension.rst。7. 完整实操流程小结确认标识aws appconfig list-extensions --region us-west-2找到目标扩展的 Name/Id/ARN查询详情aws appconfig get-extension --region us-west-2 --extension-identifier 名称|ID|ARN需要历史版本时追加--version-number N解读输出用Id/Arn/VersionNumber确认资源身份用Actions确认触发节点8 个动作点之一、执行目标Uri与角色RoleArn用Parameters确认关联时必须提供的参数Requiredtrue的项及其是否支持动态传入Dynamic排错404 检查标识与 Region400 查看Reason/Details500 稍后重试。上述内容可直接对应仓库中的 get-extension.rst 示例与服务模型 service-2.json命令与字段均可在该 API 版本2019-10-09下验证。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考