Repositories - List

Referencia

Servicio:: Git

Versión de la API:: 7.1

Recuperar repositorios de Git.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1

Con parámetros opcionales:

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?includeLinks={includeLinks}&includeAllUrls={includeAllUrls}&includeHidden={includeHidden}&api-version=7.1

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	Nombre de la organización de Azure DevOps.
project	path		string	Id. de proyecto o nombre del proyecto
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1" para usar esta versión de la API.
includeAllUrls	query		boolean	[opcional] True para incluir todas las direcciones URL remotas. El valor predeterminado es false.
includeHidden	query		boolean	[opcional] True para incluir repositorios ocultos. El valor predeterminado es false.
includeLinks	query		boolean	[opcional] True para incluir vínculos de referencia. El valor predeterminado es false.

Respuestas

Nombre	Tipo	Description
200 OK	GitRepository[]	operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Ámbitos

Nombre	Description
vso.code	Concede la capacidad de leer código fuente y metadatos sobre confirmaciones, conjuntos de cambios, ramas y otros artefactos de control de versiones. También concede la capacidad de buscar código y recibir notificaciones sobre eventos de control de versiones a través de enlaces de servicio.

Ejemplos

Solicitud de ejemplo

HTTP

GET https://dev.azure.com/fabrikam/_apis/git/repositories?api-version=7.1

Respuesta de muestra

status code:: 200

{
  "count": 3,
  "value": [
    {
      "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
      "name": "AnotherRepository",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6",
      "project": {
        "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "name": "Fabrikam-Fiber-Git",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "state": "wellFormed"
      },
      "remoteUrl": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_git/AnotherRepository"
    },
    {
      "id": "278d5cd2-584d-4b63-824a-2ba458937249",
      "name": "Fabrikam-Fiber-Git",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249",
      "project": {
        "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "name": "Fabrikam-Fiber-Git",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "state": "wellFormed"
      },
      "defaultBranch": "refs/heads/master",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git"
    },
    {
      "id": "66efb083-777a-4cac-a350-a24b046be6be",
      "name": "TestGit",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/66efb083-777a-4cac-a350-a24b046be6be",
      "project": {
        "id": "281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
        "name": "TestGit",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
        "state": "wellFormed"
      },
      "defaultBranch": "refs/heads/master",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/TestGit"
    }
  ]
}

Definiciones

Nombre	Description
GitRepository
GitRepositoryRef
ProjectState	Estado del proyecto.
ProjectVisibility	Visibilidad del proyecto.
ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
TeamProjectCollectionReference	Objeto reference de teamProjectCollection.
TeamProjectReference	Representa una referencia superficial a un TeamProject.

GitRepository

Object

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
defaultBranch	string
id	string (uuid)
isDisabled	boolean	True si el repositorio está deshabilitado. False en caso contrario.
isFork	boolean	True si el repositorio se creó como bifurcación.
isInMaintenance	boolean	True si el repositorio está en mantenimiento. False en caso contrario.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Representa una referencia superficial a un TeamProject.
remoteUrl	string
size	integer (int64)	Tamaño comprimido (bytes) del repositorio.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

Object

Nombre	Tipo	Description
collection	TeamProjectCollectionReference	Colección de proyectos de equipo donde reside esta bifurcación
id	string (uuid)
isFork	boolean	True si el repositorio se creó como bifurcación
name	string
project	TeamProjectReference	Representa una referencia superficial a un TeamProject.
remoteUrl	string
sshUrl	string
url	string

ProjectState

Enumeración

Estado del proyecto.

Valor	Description
all	Todos los proyectos, independientemente del estado, excepto Eliminado.
createPending	Project se ha puesto en cola para su creación, pero el proceso aún no se ha iniciado.
deleted	Se ha eliminado el proyecto.
deleting	Project está en proceso de eliminación.
new	Project está en proceso de creación.
unchanged	El proyecto no se ha cambiado.
wellFormed	Project se crea completamente y está listo para usarse.

ProjectVisibility

Enumeración

Visibilidad del proyecto.

Valor	Description
private	El proyecto solo es visible para los usuarios con acceso explícito.
public	El proyecto es visible para todos.

ReferenceLinks

Object

Clase que representa una colección de vínculos de referencia rest.

Nombre	Tipo	Description
links	object	Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

TeamProjectCollectionReference

Object

Objeto reference de teamProjectCollection.

Nombre	Tipo	Description
avatarUrl	string	Dirección URL del avatar de la colección.
id	string (uuid)	Id. de colección.
name	string	Nombre de la colección.
url	string	Dirección URL de REST de recopilación.

TeamProjectReference

Object

Representa una referencia superficial a un TeamProject.

Nombre	Tipo	Description
abbreviation	string	Abreviatura del proyecto.
defaultTeamImageUrl	string	Dirección URL a la imagen de identidad del equipo predeterminada.
description	string	Descripción del proyecto (si existe).
id	string (uuid)	Identificador del proyecto.
lastUpdateTime	string (date-time)	Hora de última actualización del proyecto.
name	string	Nombre del proyecto.
revision	integer (int64)	Revisión del proyecto.
state	ProjectState	Estado del proyecto.
url	string	Dirección URL a la versión completa del objeto.
visibility	ProjectVisibility	Visibilidad del proyecto.

Compartir a través de

Repositories - List

Parámetros de identificador URI

Respuestas

Seguridad

oauth2

Ámbitos

Ejemplos

Solicitud de ejemplo

Respuesta de muestra

Definiciones

GitRepository

GitRepositoryRef

ProjectState

ProjectVisibility

ReferenceLinks

TeamProjectCollectionReference

TeamProjectReference