AWS CLI CodeArtifact list-repositories 命令完全指南列出账户内全部制品仓库【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cliaws codeartifact list-repositories是 AWS CodeArtifact 服务中用于返回调用方 AWS 账户名下所有制品仓库摘要信息的核心查询命令。本文以本仓库中的官方示例文档 awscli/examples/codeartifact/list-repositories.rst 为主体结合 CodeArtifact 的 service-2.json 服务模型 与 分页器配置系统讲解该命令的基本用法、输出字段语义、过滤参数与分页机制帮助读者在仓库规模增长后依然能高效地检索与审计制品仓库。命令概述与适用场景list-repositories命令返回一个RepositorySummary仓库摘要对象列表每个摘要包含仓库的名称、所属域、ARN 与描述等信息。它解决的核心问题是当企业使用多个域Domain组织制品时如何在账户级别一次性掌握全部仓库的全貌。与list-repositories-in-domain不同后者必须显式指定--domain只返回该域下的仓库list-repositories无需任何必填参数直接列出当前账户能够访问到的所有域中的全部仓库。这一点在官方示例开头的描述中得到了印证该示例返回由发起调用的 AWS 账户所拥有的所有域中全部仓库的摘要。典型使用场景包括账户级制品资产盘点确认当前环境创建了哪些仓库配合脚本定期巡检检查是否存在遗留或废弃的测试仓库作为其他自动化流程的前置查询先拿到仓库列表再逐个执行describe-repository获取详情。基本用法按照 list-repositories.rst 中的示例最简单的调用形式为aws codeartifact list-repositories命令执行后的输出结构如下{ repositories: [ { name: npm-store, administratorAccount: 111122223333, domainName: my-domain, domainOwner: 111122223333, arn: arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store, description: Provides npm artifacts from npm, Inc. }, { name: target-repo, administratorAccount: 111122223333, domainName: my-domain, domainOwner: 111122223333, arn: arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/target-repo, description: test target repo }, { name: test-repo2, administratorAccount: 111122223333, domainName: test-domain, domainOwner: 111122223333, arn: arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2, description: This is a test repository. } ] }示例中可以看到my-domain与test-domain两个不同域下的仓库被合并返回且每个仓库都携带了完整的定位信息域 ARN这正是该命令账户级全量视图定位的直接体现。输出字段详解根据服务模型 service-2.json 中RepositorySummary结构体的定义每次返回的仓库摘要包含以下字段字段类型含义约束nameRepositoryName仓库名称2100 字符匹配[A-Za-z0-9][A-Za-z0-9._\-]{1,99}administratorAccountAccountId管理该仓库的 AWS 账户 ID恰好 12 位数字domainNameDomainName仓库所在域的名称250 字符小写字母开头domainOwnerAccountId拥有该域的 12 位 AWS 账户 ID恰好 12 位数字arnArn仓库的 Amazon 资源名称11011 字符descriptionDescription仓库的描述文本最长 1000 字符createdTimeTimestamp仓库的创建时间戳—从源码结构可以推断arn字段遵循 CodeArtifact 的统一资源命名规律其形如arn:aws:codeartifact:region:account-id:repository/domain-name/repository-name示例输出中的三条 ARN 均符合这一模式——ARN 是后续执行get-repository-endpoint、list-packages等操作时的重要入参。常用可选参数虽然list-repositories没有必填参数但服务模型为它定义了三个可选输入对应到 CLI 即以下参数--repository-prefix按名称前缀过滤仓库仅返回名称以指定前缀开头的仓库。例如只想查看以npm-开头的仓库aws codeartifact list-repositories --repository-prefix npm---max-results单次请求返回的最大结果数。服务模型中的ListRepositoriesMaxResults约束为11000。当仓库数量超过该值时返回结果会附带分页令牌详见下文分页章节。--next-token下一页结果的分页令牌通常由上一次响应的nextToken字段提供。令牌为 12000 字符的非空白字符串。实际组合使用示例aws codeartifact list-repositories \ --repository-prefix test- \ --max-results 100分页处理大规模仓库列表服务端分页配置从 paginators-1.json 可以看出ListRepositories是声明了分页能力的操作{ input_token: nextToken, output_token: nextToken, limit_key: maxResults, result_key: repositories }这意味着请求方通过nextToken传入游标、通过maxResults控制每页大小响应中的repositories字段就是本页数据而nextToken则指向下一页。CLI 侧的分页参数AWS CLI 为所有可分页操作统一注入三个分页参数其实现位于 awscli/customizations/paginate.py--page-size控制单次 API 请求向服务端索取的条目数对应底层maxResults用于避免超时或限制并不代表最终输出的条目上限--max-items控制最终返回给用户的总条目数达到该数量即停止拉取--starting-token指定从哪一页开始读取对应底层nextToken。例如希望每次请求服务端 50 条、但总共只查看前 200 条aws codeartifact list-repositories \ --page-size 50 \ --max-items 200若上一次运行返回了nextToken可将其传给--starting-token从断点继续aws codeartifact list-repositories \ --max-items 100 \ --starting-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ输出中的 nextToken当结果被截断时命令输出的 JSON 会在repositories数组之外附带nextToken字段。这也是判断是否还有更多数据、是否需要继续分页拉取的直接依据。与相关命令的组合使用按域过滤list-repositories-in-domain如果你只关心某个特定域内的仓库应使用 list-repositories-in-domain.rst 中演示的list-repositories-in-domain命令aws codeartifact list-repositories-in-domain \ --domain test-domain该命令要求必填--domain并额外支持--domain-owner指定域所属账户、--administrator-account按管理员账户过滤适合在跨账户共享域的场景下精确定位。服务模型中它的请求路径为POST /v1/domain/repositories与list-repositories的POST /v1/repositories相互区别。从创建到列举的完整闭环仓库通常先通过create-repository创建。参考 create-repository.rst 的用法aws codeartifact create-repository \ --domain test-domain \ --domain-owner 111122223333 \ --repository test-repo \ --description This is a test repository.创建后即可用list-repositories验证其是否出现在账户列表中并拿到 ARN 用于后续的describe-repository、list-packages等操作形成创建 → 列举 → 深入操作的完整工作流。输出格式与脚本化list-repositories默认输出 JSON也支持--output table或--output text便于人工浏览与脚本解析。例如以表格形式查看仓库名称与所属域aws codeartifact list-repositories \ --query repositories[].{Name:name, Domain:domainName} \ --output table配合--query与--output text还可以直接提取仓库 ARN 列表交给后续命令循环处理适合在 CI/CD 脚本中做制品资产巡检。注意事项与最佳实践账户维度返回list-repositories返回的是调用方账户视角下可见的仓库跨账户共享的仓库可能不会出现在列表中跨域、跨账户场景请改用list-repositories-in-domain并显式传入--domain-owner合理设置分页仓库数量较多时务必使用--page-size控制单次请求规模避免大响应导致的超时利用前缀过滤缩小范围在拥有大量仓库的环境中优先使用--repository-prefix过滤而非全量拉取后本地筛选可显著降低数据量与耗时结合查询表达式仅需部分字段时用--query在客户端裁剪输出减少终端渲染负担。通过本文的介绍读者应当能够熟练使用aws codeartifact list-repositories完成账户级仓库枚举并结合分页参数、前缀过滤与配套命令构建出适合自己团队的制品仓库管理脚本。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考