aws codepipeline list-pipelines 命令详解在 AWS CLI 中列出 CodePipeline 管道摘要【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli导读aws codepipeline list-pipelines是 AWS CLI 中用于获取当前 AWS 账户下所有 CodePipeline 管道摘要列表的核心命令。本文将基于本仓库中的官方示例文档 list-pipelines.rst 展开结合 service-2.json 中的 API 模型定义与 paginators-1.json 的分页配置完整讲解命令的输出格式、可选参数、分页机制与输出字段含义帮助你快速掌握管道资产的盘点与自动化脚本编写。命令概述与官方示例在 AWS CodePipeline 中管道pipeline描述了一条完整的软件发布流程包含 Source、Build、Deploy 等阶段stage与动作action。当账户中的管道数量逐渐增多时快速列出全部管道及其基本信息是日常运维与审计的第一步。本仓库中 list-pipelines.rst 给出的官方示例如下aws codepipeline list-pipelines该命令不带任何参数即可调用返回结果示例{ pipelines: [ { updated: 1439504274.641, version: 1, name: MyFirstPipeline, created: 1439504274.641 }, { updated: 1436461837.992, version: 2, name: MySecondPipeline, created: 1436460801.381 } ] }从输出可见list-pipelines返回的是一个摘要summary级的结果每个管道只包含元数据信息而不包含完整的管道 JSON 结构阶段、动作等完整定义需要使用aws codepipeline get-pipeline --name 管道名查看示例见 get-pipeline.rst。输出结构与字段含义根据 service-2.json 中ListPipelinesOutput与PipelineSummary形状的定义响应体包含如下结构字段类型说明pipelinesPipelineListPipelineSummary数组管道摘要列表nextTokenNextToken字符串1–2048 字符当返回信息量较大时返回的分页令牌用于获取后续结果每个PipelineSummary对象包含字段类型说明namePipelineName1–100 字符模式[A-Za-z0-9.\-_]管道名称versionPipelineVersion整数最小 1管道版本号每次更新递增pipelineTypePipelineType枚举V1/V2管道类型。V1 为标准 JSON 结构V2 额外支持发布安全与触发器trigger配置等参数executionModeExecutionMode枚举QUEUED/SUPERSEDED/PARALLEL管道处理多次执行的方式默认模式为SUPERSEDEDcreatedTimestamp管道创建时间Unix 时间戳秒updatedTimestamp管道最近一次更新时间Unix 时间戳秒值得说明的是官方示例文档展示的输出updated、version、name、created是最经典的四个字段而当前仓库中的 API 模型还额外定义了pipelineType与executionMode两个新字段这两者在较新的 CodePipeline 版本中会随摘要一同返回可用于在列表中直接区分管道类型与执行策略。时间戳说明created与updated以 Unix 时间戳秒含小数表示例如1439504274.641对应 2015 年 8 月。在脚本中可通过jq或 Python 的datetime模块转换为可读时间例如aws codepipeline list-pipelines \ --query pipelines[*].{Name:name,Version:version,Created:created,Updated:updated} \ --output table可选参数maxResults 与 nextToken尽管官方示例展示了无参数调用list-pipelines实际支持两个可选输入参数定义于 service-2.json 的ListPipelinesInput形状CLI 参数API 字段类型与取值范围说明--max-resultsmaxResults整数最小 1最大 1000单次调用最多返回的管道数要获取剩余管道需携带返回的nextToken再次调用--next-tokennextToken字符串1–2048 字符上一次调用返回的分页令牌用于获取后续结果集例如限制单页返回 10 条aws codepipeline list-pipelines --max-results 10如果返回结果中包含nextToken则继续翻页aws codepipeline list-pipelines --next-token 上一步返回的nextToken错误处理ListPipelines操作定义了两种异常见 service-2.json 中ListPipelines的errors定义ValidationException请求参数校验失败例如--max-results超出 1–1000 的范围或--next-token格式非法InvalidNextTokenException--next-token令牌无效或已过期例如分页游标失效。在脚本中建议对这两种错误单独捕获并给出明确提示。分页机制与分页器paginatorslist-pipelines是典型的分页型 API。仓库中 paginators-1.json 为ListPipelines配置了ListPipelines: { input_token: nextToken, output_token: nextToken, result_key: pipelines, limit_key: maxResults }这意味着 AWS CLI 内置的**分页器pager**会自动循环调用该 API直到nextToken不再返回并把每页的pipelines结果合并输出。使用--page-size可控制底层每次请求的页大小aws codepipeline list-pipelines --page-size 100而如果需要手动分页例如在受限环境中逐批处理并记录游标则应显式使用--max-results与--next-token自行控制循环如上文所示。命令的底层实现视角从 service-2.json 的元数据可以看到CodePipeline 服务的apiVersion为2015-07-09协议为jsonjsonVersion1.1签名版本为sigv4ListPipelines通过POST /向codepipeline终端节点发送 JSON 请求。CLI 层面AWS CLI 会根据 botocore 的 service 模型自动生成--max-results、--next-token等 kebab-case 参数名并将其映射为请求体中的maxResults、nextToken字段。这一机制意味着只要本仓库中 codepipeline 服务数据目录 下的模型更新CLI 的命令行为即随之同步无需手工维护命令实现。此外当前仓库中与list-pipelines配套的常用命令还包括get-pipeline.rst查看单个管道的完整结构含阶段与动作配置list-pipeline-executions.rst列出管道的历史执行记录list-action-types.rst列出可用的动作类型create-pipeline.rst通过--cli-input-json创建管道。实战盘点账户下所有管道结合--query与文本处理工具可以快速实现管道资产盘点。例如只列出管道名称与版本aws codepipeline list-pipelines \ --query pipelines[*].[name, version] \ --output text结合管道类型与执行模式进行筛选aws codepipeline list-pipelines \ --query pipelines[?pipelineTypeV2].{Name:name,Mode:executionMode} \ --output table需要说明的是pipelineType与executionMode字段在 API 模型中以枚举形式定义V1/V2与QUEUED/SUPERSEDED/PARALLEL使用时需以账户实际创建的管道属性为准若希望进一步了解管道内部结构可在列表结果基础上逐条调用aws codepipeline get-pipeline --name 管道名示例见 get-pipeline.rst。小结aws codepipeline list-pipelines是 CodePipeline 运维中最常用的只读命令之一。掌握其输出结构PipelineSummary的字段含义、分页参数--max-results、--next-token以及 AWS CLI 分页器的行为即可在脚本中稳定地完成管道清单获取、差异比对与批量审计。相关官方示例与 API 模型分别见 list-pipelines.rst 与 codepipeline 服务数据目录。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
