列出组织中的 Codespaces

你可以列出组织中所有当前活动或已停止的 Codespaces。

谁可以使用此功能？

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

GitHub Team 和 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 端点”。