Skip to main content

Enumeración de codespaces en la organización

Puedes enumerar todos los codespaces activos o detenidos actualmente de la organización.

¿Quién puede utilizar esta característica?

To list all of the current codespaces for your organization, you must be an organization owner.

Las organizaciones que tengan planes de GitHub Team y GitHub Enterprise pueden pagar por la utilizacion de miembros y colaboradores de GitHub Codespaces. Así, las organizaciones podrán acceder a configuraciones y directivas para administrar codespaces pagados por la organización. Para obtener más información, vea «Selección de quién posee y paga los codespaces de una organización» y «Planes de GitHub».

Información general

Como propietario de la organización, puedes enumerar todos los codespaces activos y detenidos actualmente de la organización. Es posible que quieras hacerlo para comprobar cuántos codespaces están creando los usuarios, para asegurarte de que no incurren en costos innecesarios. Para información sobre los precios, consulta "Acerca de la facturación de GitHub Codespaces".

La manera más fácil de enumerar los codespaces de una organización es a través de GitHub CLI. También puede usar la API de REST, que proporciona más información sobre cada codespace.

Para información sobre cómo ver el uso actual de Codespaces de tu organización o empresa y generar un informe detallado, consulta "Visualización del uso de GitHub Codespaces".

Uso de GitHub CLI para enumerar codespaces

Para enumerar todos los codespaces actuales de una organización especificada, usa el siguiente comando.

Shell
gh codespace list --org ORGANIZATION

Este comando devuelve una lista que incluye la siguiente información para cada codespace:

  • El nombre y el nombre para mostrar
  • El usuario que creó el codespace
  • El repositorio y la rama
  • El estado actual del codespace

Para enumerar todos los codespaces actuales de una organización creados por un usuario específico, usa el siguiente comando.

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

Note

En los comandos anteriores, sustituye ORGANIZATION por el nombre de la organización que estás consultando. Debes ser un propietario de la organización.

Uso de la API REST para enumerar codespaces

Puede usar el punto de conexión de API /orgs/{org}/codespaces como método alternativo para enumerar los codespaces actuales para una organización. Esto devuelve más información que GitHub CLI; por ejemplo, los detalles del tipo de máquina.

Para más información sobre este punto de conexión, consulta "Puntos de conexión de la API de REST para organizaciones de Codespaces".