列出组织中的 Codespaces

您可以列出组织当前所有处于活动状态或已停止的 Codespaces。

谁可以使用此功能？

要列出组织当前的所有 Codespaces，您必须是组织所有者。

GitHub 团队版和 GitHub Enterprise 版的组织可以为成员和协作者使用 GitHub Codespaces 付费。然后，这些组织可以访问设置和策略来管理组织支付的 Codespaces。有关更多信息，请参阅“选择谁拥有和支付组织中的 Codespaces”和“GitHub 的套餐”。

概述

作为组织所有者，您可以列出组织当前所有处于活动状态和已停止状态的 Codespaces。您可能想要这样做来检查用户正在创建多少个 Codespaces，以确保他们不会产生不必要的成本。有关定价信息，请参阅“GitHub Codespaces 的计费说明”。

列出组织的 Codespaces 最简单的方法是使用 GitHub CLI。您也可以使用 REST API，它提供有关每个 Codespace 的更多信息。

有关如何查看组织或企业的当前 Codespaces 使用总量以及生成详细报告的信息，请参阅“查看您的 GitHub Codespaces 用量”。

使用 GitHub CLI 列出 Codespaces

要列出指定组织当前的所有 Codespaces，请使用以下命令。

Shell
gh codespace list --org ORGANIZATION

此命令返回一个列表，其中包含每个 Codespace 的以下信息：

  • 名称和显示名称
  • 创建 Codespace 的用户
  • 存储库和分支
  • Codespace 的当前状态

要列出特定用户为组织创建的所有当前 Codespaces，请使用以下命令。

Shell
gh codespace list --org ORGANIZATION --user USER

注意

在上述命令中，将ORGANIZATION替换为您要查询的组织的名称。您必须是该组织的所有者。

使用 REST API 列出 Codespaces

您可以使用/orgs/{org}/codespaces API 端点作为列出组织当前 Codespaces 的替代方法。这比 GitHub CLI 返回更多信息；例如，机器类型详细信息。

有关此端点的更多信息，请参阅“Codespaces 组织的 REST API 端点”。