Skip to main content

Acceso a informes para la instancia

Puedes descargar informes con información sobre los usuarios, las organizaciones y los repositorios en tu instancia de GitHub Enterprise Server.

¿Quién puede utilizar esta característica?

Enterprise owners can download reports for a GitHub Enterprise Server instance.

Sobre los informes para GitHub Enterprise Server

Si necesitas obtener información sobre los usuarios, las organizaciones y los repositorios de tu instancia de GitHub Enterprise Server, puedes recuperar datos mediante la API de REST. Para obtener más información, vea «Acerca de la API de REST».

Es posible que la API de REST no proporcione todos los datos que deseas y se requiera algo de conocimiento técnico para usarla. Como alternativa, puedes generar informes que contengan información general de usuarios, organizaciones y repositorios en la instancia.

Descarga de informes mediante la interfaz de usuario web

  1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haga clic en .
  2. En la barra lateral de la izquierda, haz clic en Informes.
  3. Junto al informe que deseas descargar, haz clic en Descargar.

Puedes descargar archivos CSV que reflejen la siguiente información:

  • Todos los usuarios
  • Todos los usuarios activos
  • Todos los usuarios inactivos
  • Todos los usuarios que han sido suspendidos
  • Todas las organizaciones
  • todos los repositorios.

Descarga de informes mediante programación

También puedes acceder a los informes mediante programación a través de autenticación HTTP estándar y un personal access token (classic). Debes usar un personal access token (classic) con el ámbito site_admin. Para obtener más información, vea «Administración de tokens de acceso personal».

Por ejemplo, puedes descargar el informe "todos los usuarios" utilizando curl:

curl --remote-name \
     --location \
     --user 'USERNAME:TOKEN' \
     http(s)://HOSTNAME/stafftools/reports/all_users.csv

Para acceder a los demás informes mediante programación, reemplace all_users por active_users, dormant_users, suspended_users, all_organizations o all_repositories.

Nota: La solicitud curl inicial devolverá una respuesta 202 HTTP si no hay informes en caché disponibles. La instancia generará un informe en segundo plano. Puedes enviar una segunda solicitud para descargar el informe. Puede usar una contraseña o un token de OAuth con el ámbito site_admin en lugar de una contraseña.

Informes del usuario

ClaveDescripción
created_atCuándo fue creada la cuenta de usuario (como una marca de tiempo ISO 8601)
idID de la cuenta para el usuario o la organización
loginNombre de inicio de sesión de la cuenta
emailDirección principal de correo electrónico de la cuenta
roleSi la cuenta es de un usuario administrador o de un usuario común
suspended?Si la cuenta ha sido suspendida
last_logged_ipLa dirección IP más reciente que se registró en la cuenta
reposCantidad de repositorios que posee la cuenta
ssh_keysCantidad de claves SSH registradas en la cuenta
org_membershipsCantidad de organizaciones a las que pertenece la cuenta
dormant?Si la cuenta está inactiva
last_activeCuándo la cuenta estuvo activa por última vez (como una marca de tiempo ISO 8601)
raw_loginInformación de inicio de sesión sin procesar (en formato JSON)
2fa_enabled?Si el usuario ha habilitado autenticación de dos factores

Informes de la organización

ClaveDescripción
idIdentificador de la organización
created_atCuándo se creó la organización
loginNombre de inicio de sesión de la organización
emailDirección principal de correo electrónico de la organización
ownersCantidad de propietarios de la organización
membersCantidad de miembros de la organización
teamsCantidad de equipos de la organización
reposCantidad de repositorios de la organización
2fa_required?Si la organización requiere autenticación de dos factores

Informes del repositorio

ClaveDescripción
created_atCuándo fue creado el repositorio
owner_idID del propietario del repositorio
owner_typeSi el repositorio es propiedad de un usuario o de una organización
owner_nameNombre del propietario del repositorio
idID del repositorio
nameNombre del repositorio
visibilitySi el repositorio es público o privado
readable_sizeEl tamaño del repositorio en un formato legible
raw_sizeTamaño del repositorio como un número
collaboratorsCantidad de colaboradores del repositorio
fork?Si el repositorio es una bifurcación
deleted?Si el repositorio ha sido borrado