Compartir a través de

Repositories - Create

  • Referencia
Servicio:
Git
Versión de la API:
5.0

Cree un repositorio git en un proyecto de equipo.

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=5.0
Con parámetros opcionales: 
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories?sourceRef={sourceRef}&api-version=5.0

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
 path True

string

El 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 "5.0" para usar esta versión de la API.
sourceRef
 query

string

[opcional] Especificar las referencias de origen que se usarán al crear un repositorio de bifurcación

Cuerpo de la solicitud

Nombre Tipo Description
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Representa una referencia superficial a un TeamProject.

Respuestas

Nombre Tipo Description
201 Created

GitRepository

Creado

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_manage Concede la capacidad de leer, actualizar y eliminar código fuente, acceder a metadatos sobre confirmaciones, conjuntos de cambios, ramas y otros artefactos de control de versiones. También concede la capacidad de crear y administrar repositorios de código, crear y administrar solicitudes de incorporación de cambios y revisiones de código, y recibir notificaciones sobre eventos de control de versiones a través de enlaces de servicio.

Ejemplos

Solicitud de ejemplo

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

{
  "name": "AnotherRepository",
  "project": {
    "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c"
  }
}

Respuesta de muestra

status code:
201 
{
  "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"
}

Definiciones

Nombre Description
GitRepository
GitRepositoryCreateOptions
GitRepositoryRef
ProjectState

Estado del proyecto.
ProjectVisibility

Visibilidad del proyecto.
ReferenceLinks

Clase que se va a representar una colección de vínculos de referencia de REST.
TeamProjectCollectionReference

Objeto reference de teamProjectCollection.
TeamProjectReference

Representa una referencia superficial a un TeamProject.

GitRepository

Object
Nombre Tipo Description
_links

ReferenceLinks

Clase que se va a representar una colección de vínculos de referencia de REST.
defaultBranch

string

id

string

isFork

boolean

True si el repositorio se creó como bifurcación
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Representa una referencia superficial a un TeamProject.
remoteUrl

string

size

integer

Tamaño comprimido (bytes) del repositorio.
sshUrl

string

url

string

validRemoteUrls

string[]

GitRepositoryCreateOptions

Object
Nombre Tipo Description
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Representa una referencia superficial a un TeamProject.

GitRepositoryRef

Object
Nombre Tipo Description
collection

TeamProjectCollectionReference

Colección de proyectos de equipo donde reside esta bifurcación
id

string

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

Enumeration

Estado del proyecto.

Valor Description
all

Todos los proyectos independientemente del estado.
createPending

El proyecto 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

El proyecto está en proceso de eliminación.
new

El proyecto está en proceso de creación.
unchanged

No se ha cambiado el proyecto.
wellFormed

El proyecto se crea completamente y está listo para usarse.

ProjectVisibility

Enumeration

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.
Object

Clase que se va a representar una colección de vínculos de referencia de REST.

Nombre Tipo Description
links

object

Vista de 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
id

string

Identificador de colección.
name

string

Nombre de la colección.
url

string

Dirección URL de REST de la colecció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 de equipo predeterminada.
description

string

Descripción del proyecto (si existe).
id

string

Identificador del proyecto.
name

string

Nombre del proyecto.
revision

integer

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.