À propos des rapports pour GitHub Enterprise Server
Si vous avez besoin d’obtenir des informations à propos des utilisateurs, des organisations et des référentiels sur votre instance GitHub Enterprise Server, vous pouvez récupérer des données via l’API REST. Pour plus d’informations, consultez « Informations sur l’API REST ».
L’API REST peut ne pas vous fournir toutes les données que vous souhaitez. Cette API requiert une certaine expertise technique pour être utilisée. Vous pouvez également utiliser des rapports contenant des vues d’ensemble des utilisateurs, des organisations et des référentiels présents sur votre instance.
Téléchargement de rapports à l’aide de l’interface utilisateur web
- À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
- Dans la barre latérale gauche, cliquez sur Rapports.
- En regard du rapport que vous souhaitez télécharger, cliquez sur Télécharger.
Vous pouvez télécharger des fichiers CSV qui signalent les informations suivantes :
- Tous les utilisateurs
- Tous les utilisateurs actifs
- Tous les utilisateurs dormants
- Tous les utilisateurs suspendus
- Toutes les organisations
- Tous les référentiels
Téléchargement de rapports par programmation
Vous pouvez également accéder aux rapports par programmation via l’authentification HTTP standard et via un personal access token (classic). Vous devez utiliser un personal access token (classic) avec l’étendue site_admin. Pour plus d’informations, consultez « Gestion de vos jetons d'accès personnels ».
Par exemple, vous pouvez télécharger le rapport « tous les utilisateurs » à l’aide de cURL :
curl --remote-name \
--location \
--user 'USERNAME:TOKEN' \
http(s)://HOSTNAME/stafftools/reports/all_users.csv
Pour accéder aux autres rapports par programmation, remplacez all_users par active_users, dormant_users, suspended_users, all_organizations ou all_repositories.
Remarque : La demande initiale retourne une réponse HTTP 202 si aucun rapport mis en cache n’est disponible. Votre instance génère alors un rapport en arrière-plan. Vous pouvez envoyer une deuxième demande pour télécharger le rapport. Vous pouvez utiliser un mot de passe ou un jeton OAuth avec l’étendue site_admin à la place d’un mot de passe.
Rapports utilisateur
| Clé | Description |
|---|---|
created_at | Date/heure de création du compte d’utilisateur (horodatage ISO 8601) |
id | ID de compte de l’utilisateur ou de l’organisation |
login | Nom de connexion du compte |
email | Adresse e-mail principale du compte |
role | Indique si le compte est de type administrateur ou utilisateur ordinaire |
suspended? | Indique si le compte a été suspendu |
last_logged_ip | Dernière adresse IP à s’être connectée au compte |
repos | Nombre de dépôts dont le compte est propriétaire |
ssh_keys | Nombre de clés SSH inscrites au niveau du compte |
org_memberships | Nombre d’organisations auxquelles le compte appartient |
dormant? | Indique si le compte est dormant |
last_active | Date/heure auxquelles le compte a été actif pour la dernière fois (horodatage ISO 8601) |
raw_login | Informations de connexion brutes (au format JSON) |
2fa_enabled? | Indique si l’utilisateur a activé l’authentification à 2 facteurs |
Rapports d’organisation
| Clé | Description |
|---|---|
id | ID d’organisation |
created_at | Date/heure de création de l’organisation |
login | Nom de connexion de l’organisation |
email | Adresse e-mail principale de l’organisation |
owners | Nombre de propriétaires de l’organisation |
members | Nombre de membres de l’organisation |
teams | Nombre d’équipes de l’organisation |
repos | Nombre de dépôts de l’organisation |
2fa_required? | Indique si l’organisation exige une authentification à 2 facteurs |
Rapports de dépôt
| Clé | Description |
|---|---|
created_at | Date/heure de création du dépôt |
owner_id | ID du propriétaire du dépôt |
owner_type | Indique si le dépôt est la propriété d’un utilisateur ou d’une organisation |
owner_name | Nom du propriétaire du dépôt |
id | ID du dépôt |
name | Nom du dépôt |
visibility | Indique si le dépôt est public ou privé |
readable_size | Taille du dépôt dans un format compréhensible |
raw_size | Taille du dépôt sous forme de nombre |
collaborators | Nombre de collaborateurs dans le dépôt |
fork? | Indique si le dépôt est une duplication (fork) |
deleted? | Indique si le dépôt a été supprimé |