Liste des codespaces de votre organisation

Vous pouvez lister tous les codespaces actuellement actifs ou arrêtés de votre organisation.

Qui peut utiliser cette fonctionnalité ?

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

Les organisations sur les plans GitHub Team et GitHub Enterprise peuvent payer l’utilisation de membres et de collaborateurs de GitHub Codespaces. Ces organisations peuvent ensuite accéder aux paramètres et aux stratégies qui s’appliquent aux codespaces payés par l’organisation. Pour plus d’informations, consultez « Choisir qui possède et achète les codespaces dans votre organisation » et « Plans de GitHub ».

Vue d’ensemble

En tant que propriétaire de l’organisation, vous pouvez lister tous les codespaces actuellement actifs et arrêtés de votre organisation. Vous voudrez probablement le faire pour vérifier combien de codespaces les utilisateurs créent afin de vous assurer qu’ils n’entraînent pas de coûts superflus. Pour plus d’informations sur la tarification, consultez À propos de la facturation pour GitHub Codespaces.

Le moyen le plus simple de lister les codespaces d’une organisation consiste à utiliser GitHub CLI. Vous pouvez également utiliser l’API REST, qui fournit plus d’informations sur chaque codespace.

Pour plus d’informations sur la consultation de l’utilisation actuelle totale des Codespaces pour votre organisation ou entreprise, et sur la génération d’un rapport détaillé, consultez Consultation de votre utilisation de GitHub Codespaces.

Utilisation de GitHub CLI pour lister les codespaces

Pour lister tous les codespaces actuels d’une organisation spécifiée, utilisez la commande suivante.

Shell
gh codespace list --org ORGANIZATION

Cette commande retourne une liste qui comprend les informations suivantes pour chaque codespace :

  • Le nom et le nom d’affichage
  • L’utilisateur qui a créé le codespace
  • Le dépôt et la branche
  • L’état actuel du codespace

Pour lister tous les codespaces actuels d’une organisation qui a été créée par un utilisateur spécifique, utilisez la commande suivante.

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

Note

Dans les commandes ci-dessus, remplacez ORGANIZATION par le nom de l’organisation que vous interrogez. Vous devez être propriétaire de l’organisation.

Utilisation de l’API REST pour lister les codespaces

Vous pouvez utiliser le point de terminaison d’API /orgs/{org}/codespaces comme méthode alternative pour lister les codespaces actuels d’une organisation. Cela retourne plus d’informations que GitHub CLI, par exemple les détails du type de machine.

Pour plus d’informations sur ce point de terminaison, consultez Points de terminaison d’API REST pour les organisations Codespaces.